Microsoft Foundry のプロジェクトを作成する

注

このドキュメントでは、 Microsoft Foundry (クラシック) ポータルを参照します。

🔄新しいポータルを使用している場合は、Microsoft Foundry (新しい) ドキュメントに切り替えます。

この記事では、 Microsoft Foundry で Foundry プロジェクトを作成する方法について説明します。 プロジェクトを使用すると、ステートフル アプリを構築し、新しいアイデアを探索するときに、エージェント、評価、ファイルなどの作業を整理できます。

• Foundry プロジェクトは、Microsoft Foundry リソースで管理されます。 これは、アクセス管理、データのアップロードと統合、監視のためのコンテナーです。 これにより、追加の Azure リソースを作成しなくても、ユース ケース間で作業を分離できます。

• このプロジェクトの種類では、Foundry の最新のジェネレーティブ AI 機能にアクセスできます。これには次のものが含まれます。

  • エージェント
  • エージェントを構築し、モデル間で簡単に切り替える Foundry SDK と API
  • Azure によって直接販売されるモデル - Azure OpenAI、Mistral、xAI、DeepSeek など。
  • Marketplace を通じて販売されるパートナーおよびコミュニティ モデル - 安定性、Cohere など。
  • コンテンツの理解
  • 評価
  • 微調整
  • OpenAI SDK と API（バッチ処理と保存された出力を含む）
  • 鋳造ツール

• オープンソース モデルまたは PromptFlow にアクセスする必要がありますか? 代わりに、ハブ プロジェクトの種類を作成します。

• さまざまな プロジェクトの種類の 詳細については、「プロジェクトの種類」を参照してください。

組織で、別名、セキュリティ制御、コスト タグなどのカスタマイズされた Azure 構成が必要な場合は、 Azure portal または テンプレート オプション を使用して、組織の Azure Policy 要件に準拠することが必要になる場合があります。

[前提条件]

Foundry プロジェクトの作成に使用する方法を選択するには、次のタブを使用します。

Foundry ポータル

• アクティブなサブスクリプションを持つ Azure アカウント。 お持ちでない場合は、 無料試用版サブスクリプションを含む無料の Azure アカウントを作成します。

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

Python SDK

• アクティブなサブスクリプションを持つ 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に追加します。

     DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
     

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

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

Azure CLI

• アクティブなサブスクリプションを持つ Azure アカウント。 お持ちでない場合は、 無料試用版サブスクリプションを含む無料の Azure アカウントを作成します。

• プロジェクトを使用するために必要な適切なアクセス制御を受け取るために、サブスクリプションの 所有者 である必要があります。

• Azure CLI をインストールします。

• subscriptionとresource groupの既定値を設定します。

    # Set your default subscription
    az account set --subscription "{subscription-name}"
  
    # Set default resource group
    az config set defaults.group={resource-group-name}
  

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

Foundry ポータル

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

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

1. Microsoft Foundry にサインインします。 [新しいファウンドリー]切り替えがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。

   

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

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

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

     

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

     

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

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

詳細オプション

1. Foundry プロジェクトは、 Foundry リソースに作成されます。 このリソースは、プロジェクトの作成時に自動的に作成されます。 使用する既存の [リソース グループ] を選択するか、既定値のままにして新しいリソース グループを作成します。

   ヒント

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

2. [場所] を選択するか、既定値を使用します。 場所は、プロジェクト内のリソースがホストされているリージョンです。

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

Python SDK

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

• このコードを追加して、前提条件からの変数と 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": {}
      }
  )
  

Azure CLI

1. 次のコマンドを使用して、Azure CLI から Azure サブスクリプションに対して認証を行います。

   az login
   

   認証の詳細については、認証メソッドに関するページを参照してください。

2. たとえば、米国東部でリソース グループを作成します。

   az group create --name {my_resource_group} --location eastus
   

3. Foundry リソースを作成する

   az cognitiveservices account create \
   --name {your-foundry-resource-name} \
   --kind AIServices \
   --location eastus \
   --sku s0 \
   --allow-project-management
   

4. プロジェクトを作成します。

   az cognitiveservices account project create \
   --name {your-foundry-resource-name} \
   --project-name {your-project-name} \
   --location eastus
   

同じリソースに複数のプロジェクトを作成する

既存の Foundry リソースに複数の Foundry プロジェクトを作成して、セキュリティ、デプロイ、接続されたツールなどのチームコラボレーションと共有リソースアクセスを可能にします。 このセットアップは、開発者が事前に構成された環境のセットアップ内でセルフサービス探索機能を必要とする制限付き Azure サブスクリプションに最適です。

Azure 子リソースとしての Foundry プロジェクトには、独自のアクセス制御が割り当てられる可能性がありますが、ネットワーク セキュリティ、デプロイ、Azure ツール統合などの共通設定は親リソースから共有されます。

Foundry のすべての機能がプロジェクトでの作業の整理をまだサポートしているわけではありませんが、リソースの最初の "既定" プロジェクトはより強力です。 コード オプションを使用する場合は、UX エクスペリエンスのタグ "default" とリソース プロパティ "is_default" で識別できます。

特徴	既定のプロジェクト	その他のプロジェクト
モデル推論	✅	✅
プレイグラウンド	✅	✅
エージェント	✅	✅
評価	✅	✅
トレース	✅	✅
データセット	✅	✅
Indexes	✅	✅
Foundry SDK と API	✅	✅
コンテンツの理解	✅	✅
OpenAI SDK と API	✅	応答、ファイル、会話
OpenAI バッチ処理、ファイン チューニング、保存済み補完	✅	-
言語の微調整	✅	✅
音声の微調整	✅	-
接続	✅	✅

• Foundry リソースにプロジェクトを追加するには:

  Foundry ポータル

  ヒント

  Microsoft Foundry ポータルで 左側のウィンドウをカスタマイズ できるため、次の手順とは異なる項目が表示される場合があります。 探しているものが表示されない場合は、左側のペインの下部にある… もっと見るを選択してください。

  1. Microsoft Foundry にサインインします。 [新しいファウンドリー]切り替えがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。

     

  2. Foundry プロジェクトまたは関連するリソースを選択します。

  3. 左側のウィンドウで、[ 管理センター] を選択します。

  4. リソース セクションで、[ 概要] を選択します。

  5. [ 新しいプロジェクト ] を選択し、名前を指定します。

     

  Python SDK

  既存のリソースに新しいプロジェクトを作成するには、次のコードをスクリプトに追加します。

  # Create additional project
  new_project_name = 'your-new-project-name'
  
  project = client.projects.begin_create(
      resource_group_name=resource_group_name,
      account_name=foundry_resource_name,
      project_name=new_project_name,
      project={
          "location": location,
          "identity": {
              "type": "SystemAssigned"
          },
          "properties": {}
      }
  )
  

  Azure CLI

  {foundry_resource_name} の既存の値を使用して、リソースに別のプロジェクトを追加します。

   az cognitiveservices account project create \
   --name {foundry_resource_name} \
   --project-name {my_project_name} \
   --location {location}
  

• Foundry リソースの既定のプロジェクトを削除すると、次に作成されたプロジェクトが既定のプロジェクトになります。

プロジェクト設定の表示

Foundry ポータル

プロジェクトの ホーム ページには、プロジェクトに関する情報が表示されます。

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

Python SDK

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

Azure CLI

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

az cognitiveservices account connection show \
--name <my_project_name> \
--resource-group <my_resource_group>

プロジェクトを削除する

Foundry ポータル

1. Microsoft Foundry にサインインします。 [新しいファウンドリー]切り替えがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。
2. プロジェクトを開きます。
3. [管理センター] を選択します。
4. [ リソース] で [ 概要] を選択します。
5. 保持しなくなったプロジェクトを選択します。
6. [ プロジェクトの削除] を選択します。

Foundry リソースとそのすべてのプロジェクトを削除するには:

1. 管理センターで、[概要] セクションからリソース名を選択して Azure portal に移動します。
2. Azure portal で [ 削除 ] を選択して、リソースとそれに関連付けられているすべてのプロジェクトを削除します。

Python SDK

このコードでは、前提条件の変数と client connection を使用します。 まず、クライアント接続を作成します。

client.projects.begin_delete(
    resource_group_name, foundry_resource_name, foundry_project_name
)

Foundry リソースとそのすべてのプロジェクトを削除します。

# Delete projects
projects = client.projects.list(resource_group_name, foundry_resource_name)

for project in projects: 
    print("Deleting project:", project.name)
    client.projects.begin_delete(resource_group_name, foundry_resource_name,
        project_name=project.name.split('/')[-1]
    ).wait()

# Delete resource
print("Deleting resource:", foundry_resource_name)
client.accounts.begin_delete(resource_group_name, foundry_resource_name).wait()

Azure CLI

次のコマンドを実行します。

az cognitiveservices account project delete \
--name {foundry_resource_name} \
--project-name {my_project_name}

関連コンテンツ

• クイック スタート: Foundry の概要
• Foundry とは