Azure AI Foundry (Foundry プロジェクト) のプロジェクトを作成する

• アクティブなサブスクリプションを持つ Azure アカウント。 お持ちでない場合は、 無料試用版サブスクリプションを含む無料の Azure アカウントを作成します。
• プロジェクトの親である Azure AI Foundry リソースを作成するために必要な適切なアクセス制御を行うには、サブスクリプションの 所有者 である必要があります。 このアクセス権がない場合は、管理者に AI Foundry リソースを作成 して使用してもらう必要があります。 次に、「 同じリソースに複数のプロジェクトを作成する 」に進み、プロジェクトを作成します。

• アクティブなサブスクリプションを持つ Azure アカウント。 お持ちでない場合は、 無料試用版サブスクリプションを含む無料の Azure アカウントを作成します。
• プロジェクトを使用するために必要な適切なアクセス制御を受け取るために、サブスクリプションの 所有者 である必要があります。
• 開発環境を設定する
• コードを実行する前に、環境内の az login または az login --use-device-code で認証します。
• Python スクリプトを開始するには、次の手順を実行します。

  1. パッケージのインストール: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1 。 ノートブック セル内の場合は、代わりに %pip install を使用します。

  2. pip show azure-mgmt-cognitiveservicesを使用して、バージョンが 13.7 以上であることを確認します。

  3. 次のコードでスクリプトを開始し、この記事全体で使用される client 接続と変数を作成します。 この例では、米国東部にプロジェクトを作成します。

     from azure.identity import DefaultAzureCredential
     from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
     
     subscription_id = 'your-subscription-id'
     resource_group_name = 'your-resource-group-name'
     foundry_resource_name = 'your-foundry-resource-name'
     foundry_project_name = 'your-foundry-project-name'
     ___location = 'eastus'
     
     client = CognitiveServicesManagementClient(
         credential=DefaultAzureCredential(), 
         subscription_id=subscription_id,
         api_version="2025-04-01-preview"
     )
     

  4. (省略可能) 複数のアカウントがある場合は、使う Microsoft Entra ID のテナント ID を DefaultAzureCredential に追加します。 Azure portal で、[Microsoft Entra ID] の [外部 ID] からテナント ID を見つけます。

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

  5. (省略可能)21Vianet リージョンによって運用されているAzure Government (米国または Azure) で作業している場合は、認証するリージョンを指定します。 DefaultAzureCredential を使用してそのリージョンを指定できます。 次の例では、Azure Government - US リージョンに対して認証を行います。

     from azure.identity import AzureAuthorityHosts
     DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
     

• アクティブなサブスクリプションを持つ Azure アカウント。 お持ちでない場合は、 無料試用版サブスクリプションを含む無料の Azure アカウントを作成します。
• プロジェクトを使用するために必要な適切なアクセス制御を受け取るために、サブスクリプションの 所有者 である必要があります。
• Azure CLI

これらの手順では、基本的な既定の設定を使用して新しい Azure リソースを作成する方法を提供します。

Azure AI Foundry で Foundry プロジェクトを作成するには、次の手順に従います。

1. Azure AI Foundry にサインインします。

2. 次に何を行うかは、あなたのいる場所によって異なります。

   • 既存のプロジェクトがない場合は、「 クイック スタート: Azure AI Foundry の概要 」の手順に従って、最初のプロジェクトを作成します。

   • プロジェクト内の場合は: プロジェクトの階層リンクを選択し、[新しいリソースの作成] を選択します。

     

   • プロジェクト内にいない場合: 右上の [新規作成] を選択して、新しい Azure AI Foundry プロジェクトを作成します

     

3. Azure AI Foundry リソースを選択し、[次へ] を選択します。

4. プロジェクトの名前を指定し、[ 作成] を選択します。 または、詳細オプションについては、次のセクションを参照してください。

詳細オプション

Foundry プロジェクトは、 AI Foundry リソースに作成されます。 このリソースは、プロジェクトの作成時に自動的に作成されます。

プロジェクトの設定をカスタマイズするには、次の手順に従います。

1. [ プロジェクトの作成 ] フォームで、[ 詳細オプション] を選択します。

2. 使用する既存の [リソース グループ] を選択するか、既定値のままにして新しいリソース グループを作成します。

   ヒント

   特に作業を開始するには、プロジェクト用の新しいリソース グループを作成することをお勧めします。 リソース グループを使用すると、プロジェクトとそのすべてのリソースをまとめて簡単に管理できます。

3. [場所] を選択するか、既定値を使用します。 この場所は、ハブがホストされるリージョンです。 Azure AI サービスの可用性はリージョンによって異なります。 たとえば、特定のモデルについては、リージョンによっては利用できない場合があります。

4. を選択してを作成します。 リソースの作成の進行状況が表示され、プロセスが完了するとプロジェクトが作成されます。

Foundry プロジェクトを作成するには:

1. このコードを追加して、client の変数と接続を使用して Foundry プロジェクトを作成します。

   # Create resource
   resource = client.accounts.begin_create(
       resource_group_name=resource_group_name,
       account_name=foundry_resource_name,
       account={
           "___location": ___location,
           "kind": "AIServices",
           "sku": {"name": "S0",},
           "identity": {"type": "SystemAssigned"},
           "properties": {
               "allowProjectManagement": True,
               "customSubDomainName": foundry_resource_name
           }
       }
   )
   
   # Wait for the resource creation to complete
   resource_result = resource.result()
   
   # Create default project
   project = client.projects.begin_create(
       resource_group_name=resource_group_name,
       account_name=foundry_resource_name,
       project_name=foundry_project_name,
       project={
           "___location": ___location,
           "identity": {
               "type": "SystemAssigned"
           },
           "properties": {}
       }
   )
   

現在、Foundry プロジェクトの作成には CLI コマンドを使用できません。

プロジェクトの ホーム ページで、プロジェクトに関する情報を見つけることができます。

• 名前: プロジェクトの名前は左上隅に表示されます。
• サブスクリプション: プロジェクトをホストするハブをホストするサブスクリプション。
• リソース グループ: プロジェクトをホストするハブをホストするリソース グループ。

# Get project
project = client.projects.get(
    resource_group_name=resource_group_name,
    account_name=foundry_resource_name,
    project_name=foundry_project_name
)
print(project)

プロジェクトの設定を表示するには、az cognitiveservices account connection show コマンドを使用します。 例えば次が挙げられます。

az cognitiveservices account connection show --name {my_project_name} --resource-group {my_resource_group}