この記事では、 Microsoft Foundry で Foundry プロジェクトを作成する方法について説明します。 プロジェクトを使用すると、ステートフル アプリを構築し、新しいアイデアを探索するときに、エージェント、評価、ファイルなどの作業を整理できます。
-
Foundry プロジェクトは、Microsoft Foundry リソースで管理されます。 これは、アクセス管理、データのアップロードと統合、監視のためのコンテナーです。 これにより、余分なAzure リソースを作成しなくても、ユース ケース間で作業を分離できます。
オープンソース モデルまたは PromptFlow にアクセスする必要がある場合は、代わりに ハブ プロジェクトの種類を作成 します。
さまざまなプロジェクトの種類の詳細については、「プロジェクト の種類」を参照してください。
組織で、代替名、セキュリティ制御、コスト タグなどのカスタマイズされたAzure構成が必要な場合は、組織のAzure Policy要件に準拠するために、Azure ポータル または template オプションを使用する必要があります。
[前提条件]
-
アクティブなサブスクリプションを持つAzure アカウント。 お持ちでない場合は、無料試用版サブスクリプションを含む無料Azure アカウントを作成します。
-
Foundryリソースを作成できるロールへのアクセス、例えばサブスクリプションまたはリソースグループ内のAzureアカウントAI所有者やAzureAI所有者。 アクセス許可の詳細については、「 Microsoft Foundry のロールベースのアクセス制御」を参照してください。
このロールがない場合は、サブスクリプション管理者に Foundry リソースの作成 を依頼してから、「 同じリソースに複数のプロジェクトを作成する」に進みます。
Foundry プロジェクトの作成に使用する方法を選択するには、次のタブを使用します。
- アクティブなサブスクリプションを持つAzure アカウント。 お持ちでない場合は、無料試用版サブスクリプションを含む無料Azure アカウントを作成します。
開発環境のセットアップ
コードを実行する前に、環境内で az login または az login --use-device-code を実行します。
クイック検証: プロジェクトを作成する前に、クライアントをテストして SDK と認証が機能していることを確認します。
from azure.identity import DefaultAzureCredential
from azure.mgmt.cognitiveservices import CognitiveServicesManagementClient
# Test authentication by instantiating the client
credential = DefaultAzureCredential()
subscription_id = "<your-subscription-id>" # Replace with your subscription ID
client = CognitiveServicesManagementClient(credential, subscription_id)
print("✓ Authentication successful! Ready to create a project.")
Python スクリプトを開始するには、次の手順を実行します。
パッケージのインストール: pip install azure-identity azure-mgmt-cognitiveservices~=13.7.0b1。 ノートブック セルを使用している場合は、代わりに %pip install を使用します。
pip show azure-mgmt-cognitiveservicesを使用して、バージョンが 13.7 以上であることを確認します。
次のコードでスクリプトを開始し、この記事全体で使用される 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"
)
(省略可能)複数のアカウントがある場合は、使用するMicrosoft Entra IDのテナント ID を DefaultAzureCredential に追加します。
DefaultAzureCredential(interactive_browser_tenant_id="<TENANT_ID>")
(省略可能)Azure Government - US または 21Vianet リージョンによって運用される Azure で作業している場合は、認証するリージョンを指定します。 この例では、Azure Government - 米国リージョンに対して認証を行います。
from azure.identity import AzureAuthorityHosts
DefaultAzureCredential(authority=AzureAuthorityHosts.AZURE_GOVERNMENT)
Foundry プロジェクトを作成する
これらの手順では、基本的な既定の設定を使用して新しいAzure リソースを作成する方法を提供します。
Foundry プロジェクトを作成するには、次の手順に従います。
-
Microsoft Foundry にサインインします。
「New Foundry」トグルがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。
-
次に何を行うかは、あなたのいる場所によって異なります。
既存のプロジェクトがない場合は、「 クイック スタート: Microsoft Foundry の概要 」の手順に従って、最初のプロジェクトを作成します。
プロジェクト内の場合は: プロジェクトの階層リンクを選択し、[新しいリソースの作成] を選択します。
プロジェクトに含まれていない場合: 右上の [ 新規作成 ] を選択して新しい Foundry プロジェクトを作成します
Foundry リソースを選択し、[次へ] を選択します。
プロジェクトの名前を指定し、[ 作成] を選択します。 または、詳細オプションについては、次のセクションを参照してください。
詳細オプション
Foundry リソースに Foundry プロジェクトを作成します。 プロジェクトを作成すると、ポータルによってこのリソースが自動的に作成されます。 使用する既存の リソース グループ を選択するか、既定値のままにして新しいリソース グループを作成します。
ヒント
特に作業を開始するには、プロジェクトの新しいリソース グループを作成します。 リソース グループを使用すると、プロジェクトとそのすべてのリソースをまとめて簡単に管理できます。
[場所] を選択するか、既定値を使用します。 場所は、プロジェクト リソースがホストされているリージョンです。
を選択してを作成します。 リソースの作成の進行状況が表示されます。 プロジェクトは、プロセスが完了すると作成されます。
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": {}
}
)
参照: CognitiveServicesManagementClient。
リソース グループを作成するか、既存のものを使用します。 たとえば、my-foundry-rgでeastusを作成します。
az group create --name my-foundry-rg --location eastus
Foundry リソースを作成します。 たとえば、my-foundry-resource リソース グループにmy-foundry-rgを作成します。
az cognitiveservices account create \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--kind AIServices \
--sku s0 \
--location eastus \
--allow-project-management
--allow-project-management フラグを使用すると、このリソース内でプロジェクトを作成できます。
リソースのカスタム サブドメインを作成します。 カスタム ドメイン名はグローバルに一意である必要があります。
my-foundry-resource取得した場合は、より一意の名前を試してください。
az cognitiveservices account update \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--custom-domain my-foundry-resource
プロジェクトを作成します。 たとえば、my-foundry-projectでmy-foundry-resourceを作成します。
az cognitiveservices account project create \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project \
--location eastus
プロジェクトが作成されたことを確認します。
az cognitiveservices account project show \
--name my-foundry-resource \
--resource-group my-foundry-rg \
--project-name my-foundry-project
出力には、リソース ID を含むプロジェクトのプロパティが表示されます。
リファレンス: az cognitiveservices account
同じリソースに複数のプロジェクトを作成する
既存の Foundry リソースに複数の Foundry プロジェクトを作成して、セキュリティ、デプロイ、接続されたツールなどのチームコラボレーションと共有リソースアクセスを可能にします。 このセットアップは、開発者が構成済み環境のセットアップ内でセルフサービス探索機能を必要とする制限付きAzure サブスクリプションに最適です。
Azure子リソースとしての Foundry プロジェクトには、独自のアクセス制御が割り当てられる可能性がありますが、親リソースからのネットワーク セキュリティ、デプロイ、Azure ツール統合などの一般的な設定を共有します。
Foundry のすべての機能がプロジェクトでの作業の整理をまだサポートしているわけではありませんが、リソースの最初の "既定" プロジェクトはより強力です。 コード オプションを使用する場合は、UX エクスペリエンスのタグ "default" とリソース プロパティ "is_default" で識別できます。
| 特徴 |
既定のプロジェクト |
その他のプロジェクト |
| モデル推論 |
✅ |
✅ |
| プレイグラウンド |
✅ |
✅ |
| Agents |
✅ |
✅ |
| Evaluations |
✅ |
✅ |
| トレース |
✅ |
✅ |
| データセット |
✅ |
✅ |
| Indexes |
✅ |
✅ |
| Foundry SDK と API |
✅ |
✅ |
| コンテンツの理解 |
✅ |
✅ |
| OpenAI SDK と API |
✅ |
応答、ファイル、会話 |
| OpenAI バッチ処理、ファイン チューニング、保存済み補完 |
✅ |
- |
| 言語の微調整 |
✅ |
✅ |
| 音声の微調整 |
✅ |
- |
| 接続 |
✅ |
✅ |
プロジェクト設定の表示
[ ホーム プロジェクト] ページには、プロジェクトに関する情報が表示されます。
-
名前: プロジェクトの名前が左上隅に表示されます。
-
サブスクリプション: プロジェクトをホストするハブをホストするサブスクリプション。
-
リソース グループ: プロジェクトをホストするハブをホストするリソース グループ。
# Get project
project = client.projects.get(
resource_group_name=resource_group_name,
account_name=foundry_resource_name,
project_name=foundry_project_name
)
print(project)
参照: CognitiveServicesManagementClient。
プロジェクトの設定を表示するには、az cognitiveservices account connection show コマンドを使用します。 例えば次が挙げられます。
az cognitiveservices account connection show \
--name my-foundry-project \
--resource-group my-foundry-rg
プロジェクトを削除する
-
Microsoft Foundry にサインインします。
「New Foundry」トグルがオフになっていることを確認します。 これらの手順は Foundry (クラシック) を参照します。
- プロジェクトを開きます。
-
[管理センター] を選択します。
- [ リソース] で [ 概要] を選択します。
- 保持しなくなったプロジェクトを選択します。
- [ プロジェクトの削除] を選択します。
Foundry リソースとそのすべてのプロジェクトを削除するには:
- 管理センターで、[概要] セクションからリソース名を選択して、Azure ポータルに移動します。
- Azure ポータルで、Delete を選択して、リソースとそれに関連付けられているすべてのプロジェクトを削除します。
このコードでは、前提条件の変数と client connection を使用します。 まず、クライアント接続を作成します。
client.projects.begin_delete(
resource_group_name, foundry_resource_name, foundry_project_name
)
参照: CognitiveServicesManagementClient。
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()
参照: CognitiveServicesManagementClient。
Important
慎重に使用してください。 削除後にプロジェクトを回復することはできません。
関連するコンテンツ