クイックスタート: 最初の AI Foundry リソースを設定する

2025-10-09

このクイックスタートでは、Azure AI Foundry リソースを作成し、アクセスを確認します。

Azure AI Foundry リソースを作成して管理する方法について説明します。これは、Azure 内のエージェントを含む生成 AI モデルとアプリケーションを構築、デプロイ、および管理するための主要な Azure リソースの種類です。

Azure でサービスを使用および管理するには、Azure リソースが必要です。ネットワーク、課金、監視などのアクセス、セキュリティを構成するためのスコープを定義します。

Azure AI Foundry リソースは、次のバージョンであり、以前の "Azure AI Services" の名前変更です。エージェント、モデルのデプロイ、評価などをホストするためのアプリケーション環境が提供されます。

Azure AI Foundry リソースは、複数のユースケースの作業を整理でき、通常は、同様のビジネスドメインまたはデータドメインのユースケースに取り組む開発者のチーム間で共有されます。プロジェクトは、関連する作業をグループ化するためのフォルダーとして機能します。

デプロイと接続を持つ複数のプロジェクトを含む Azure AI Foundry リソースを示す図。

高度なセキュリティ設定を使用して AI Foundry を構成する場合高度な AI Foundry 作成オプションを参照する

Azure AI Search スキルの使用をお探しですか?「Azure AI Foundry と Azure AI Search スキルの使用」を参照してください。

最初のリソースを作成する

基本的な Azure 設定で最初のリソースを作成するには、Azure portal、Azure CLI、または PowerShell を使用して、次の手順に従います。

前提条件

有効な Azure サブスクリプション - 無料アカウントを作成する。
リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソースグループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
- Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタムロール

新しい Azure AI Foundry リソースを作成する

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

Azure AI Foundry リソースは、Azure portal の AI Foundry>AI Foundry の下に一覧表示されます。 API の種類は AIServices です。次に示すロゴを探します。

ヒント

Azure AI Foundry ポータルには、基本的な既定の設定を使用して、新しい Azure AI Foundry リソースを作成する方法が用意されています。

Azure portal で AI Foundry リソースを作成するには、次の手順に従います。

次の AI Foundry リソースリンクを選択します。https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry

[作成] ページで、次の情報を指定します。

プロジェクトの詳細	説明
サブスクリプション	使用できる Azure サブスクリプションのいずれかを選択します。
リソースグループ	Azure AI Foundry リソースを含む Azure リソースグループ。新しいグループを作成したり、既存のグループに追加したりできます。
リージョン	Azure AI サービスインスタンスの場所。別の場所を選択すると待機時間が生じる可能性がありますが、リソースのランタイムの可用性には影響しません。
名前	Azure AI Foundry リソースのわかりやすい名前。たとえば、MyAIServicesResource。

必要に応じてリソースの他の設定を構成し、条件を読み取って同意し (該当する場合)、[Review + create(確認と作成) ] を選択します。

ヒント

サブスクリプションで AI Foundry リソースを作成できない場合は、Azure portal、PowerShell コマンド、または Azure CLI コマンドを使用して、その Azure リソースプロバイダーの特権を有効にする必要がある場合があります。サブスクリプションの所有者でない場合は、"所有者" または "管理者" のロールを持つユーザーに、登録の完了を要求するか、アカウントに /register/action 特権を付与するように要求してください。

リソースをクリーンアップする

AI Foundry リソースをクリーンアップして削除する場合は、リソースまたはリソースグループを削除できます。リソースグループを削除すると、そのグループに含まれている他のリソースも削除されます。

Azure Portal で左側のメニューを展開してサービスのメニューを開き、[リソースグループ] を選択して、リソースグループの一覧を表示します。
削除するリソースが含まれているリソースグループを見つけます。
リソースグループ全体を削除する場合は、リソースグループ名を選択します。次のページで [リソースグループの削除] を選択し、確認します。
Azure AI Foundry リソースのみを削除する場合は、リソースグループを選択して、その中のすべてのリソースを表示します。次のページで、削除するリソースを選択し、その行の省略記号メニューを選択して、[削除] を選択します。

このクイックスタートでは、 Azure Command-Line Interface (CLI) コマンドを使用して AI Foundry リソースを作成します。

前提条件

有効な Azure サブスクリプション - 無料アカウントを作成します。
Azure CLI バージョン 2.0 以降。
リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソースグループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
- Microsoft.CognitiveServices/accounts/write のアクセス許可を持つカスタムロール

Azure CLI をインストールします。 CLI のローカルインストールにサインインするには、az login コマンドを実行します。

az login

新しいリソースグループを作成する

AI Foundry リソースを作成する前に、リソースを格納する Azure リソースグループが必要です。新しいリソースを作成するときは、新しいリソースグループを作成するか、既存のものを使用できます。この記事では、新しいリソースグループを作成する方法を示します。

リソースを作成するには、お使いのサブスクリプションに使用できるいずれかの Azure の場所が必要です。使用できる場所の一覧を取得するには、az account list-locations コマンドを使用します。ほとんどの Azure AI サービスは複数の場所からアクセスできます。お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。

重要

Azure AI Foundry リソースを呼び出すときに必要なので、Azure の場所を覚えておいてください。
一部の Azure AI サービスは、リージョンによって使用可能かどうかが異なります。詳細については、「リージョン別の Azure 製品」を参照してください。

az account list-locations --query "[].{Region:name}" --out table

Azure の場所が決まったら、Azure CLI で az group create コマンドを使用して新しいリソースグループを作成します。次の例では、Azure の場所 westus2 を、お使いのサブスクリプションで使用できる Azure の場所の 1 つに置き換えます。

az group create --name ai-services-resource-group --___location westus2

AI Foundry リソースを作成する

新しい Azure AI Foundry リソースを作成してサブスクライブするには、 az cognitiveservices account create コマンドを使用します。このコマンドで、以前に作成したリソースグループに新しい課金対象リソースが追加されます。新しいリソースを作成するときには、使用するサービスの種類、その価格レベル (つまり SKU)、および Azure の場所を把握している必要があります。

重要

Azure には、複数の Azure AI サービスのリソースの種類があります。必ず、kind の AIServices を使用して作成してください。

次のコマンドを使用して、 foundry-multi-service-resource という名前の AI Foundry リソースを作成できます。

az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group  --kind AIServices --sku S0 --___location westus2 --yes

ヒント

現在のリソースのクォータ使用量を取得する

リソースの使用状況を取得するには、az cognitiveservices account list-usage コマンドを使います。

az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name

リソースをクリーンアップする

AI Foundry リソースをクリーンアップして削除する場合は、そのリソースまたはリソースグループを削除できます。リソースグループを削除すると、そのグループに含まれている他のリソースも削除されます。

リソースグループとそれに関連付けられているリソースを削除するには、az group delete command を使用します。

az group delete --name ai-services-resource-group

このクイックスタートでは、 Azure PowerShell コマンドを使用して AI Foundry リソースを作成します。

前提条件

有効な Azure サブスクリプション - 無料アカウントを作成します。
Azure PowerShell バージョン 5.0 以降。
リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソースグループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
- Microsoft.CognitiveServices/accounts/write 権限を持つカスタム役割

Azure PowerShellをインストールします。サインインするには、Connect-AzAccount コマンドを実行します。

Connect-AzAccount

新しい Azure AI Foundry リソースグループを作成する

リソースを作成するには、お使いのサブスクリプションに使用できるいずれかの Azure の場所が必要です。 Get-AzLocation コマンドを使って、使用できる場所の一覧を取得できます。ほとんどの Azure AI サービスは複数の場所からアクセスできます。お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。

重要

Azure AI Foundry リソースを呼び出すときに必要なので、Azure の場所を覚えておいてください。
一部の Azure AI サービスは、リージョンによって使用可能かどうかが異なります。詳細については、「リージョン別の Azure 製品」を参照してください。

Get-AzLocation | Select-Object -Property Location, DisplayName

Azure の場所が決まったら、Azure PowerShell で New-AzResourceGroup コマンドを使って新しいリソースグループを作成します。次の例では、Azure の場所 westus2 を、お使いのサブスクリプションで使用できる Azure の場所の 1 つに置き換えます。

New-AzResourceGroup -Name ai-services-resource-group -Location westus2

AI Foundry リソースを作成する

新しい Azure AI Foundry リソースを作成してサブスクライブするには、 New-AzCognitiveServicesAccount コマンドを使用します。このコマンドで、以前に作成したリソースグループに新しい課金対象リソースが追加されます。新しいリソースを作成するときには、使用するサービスの "種類"、その価格レベル (つまり SKU)、および Azure の場所を把握している必要があります。

重要

Azure には、複数の Azure AI サービスのリソースの種類があります。必ず、Type の AIServices (種類) を使用して作成してください。

次のコマンドを使用して、 foundry-multi-service-resource という名前の AI Foundry リソースを作成できます。

New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2

ヒント

現在のリソースのクォータ使用量を取得する

リソースの使用状況を取得するには、Get-AzCognitiveServicesAccountUsage コマンドを使います。

Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource

リソースをクリーンアップする

リソースグループとそれに関連付けられているリソースを削除するには、Remove-AzResourceGroup コマンドを使います。

Remove-AzResourceGroup -Name ai-services-resource-group

リソースにアクセスする

最初のリソースを作成すると、 UX プロトタイプ作成用の Foundry ポータル、開発用の Foundry SDK、または管理管理用の Azure portal からアクセスできます。

セットアップを確認する

Azure AI Projects SDK を使用してプロジェクトに接続して一覧表示することで、リソースが正しく設定されていることを確認できます。この最小限の例では、認証とアクセスを確認します。

# Install the SDK: pip install azure-ai-projects azure-identity
from azure.ai.projects import AIProjectClient
from azure.identity import DefaultAzureCredential

# Replace with your actual values from Azure portal
client = AIProjectClient(
    subscription_id="<your-subscription-id>",
    resource_group_name="<your-resource-group>",
    project_name="<your-project-name>",
    credential=DefaultAzureCredential()
)

# List projects to verify connection
projects = client.projects.list()
print(f"Successfully connected. Found {len(list(projects))} projects.")

予期される出力: Successfully connected. Found X projects. X はリソース内のプロジェクトの数です。

参照:

開発者のアクセス許可を付与または取得する

Azure ロールベースのアクセス制御 (RBAC) は、管理アクションと開発アクションの間でアクセス許可を区別します。 Foundry を使用してビルドするには、ユーザーアカウントに開発者アクセス許可 ("データアクション") が割り当てられている必要があります。組み込みの RBAC ロールのいずれかを使用することも、カスタム RBAC ロールを使用することもできます。

Foundry の組み込みの Azure RBAC 開発者ロールは次のとおりです。

Role	説明
Azure AI プロジェクトマネージャー	開発アクセス許可とプロジェクト管理アクセス許可を付与します。他のユーザーを "Azure AI ユーザー" としてプロジェクトで共同作業するように招待できます。
Azure AI ユーザー	開発アクセス許可を付与します。

承認されたユーザー (通常は Azure サブスクリプションまたはリソースグループ所有者) のみが、[Azure portal] または [管理センター経由の AI Foundry Portal] を使用してロールを割り当てることができます。ロールベースのアクセス制御について詳しくは、こちらをご覧ください。

重要

Azure 所有者ロールと共同作成者ロールには管理アクセス許可のみが含まれており、開発アクセス許可は含まれません。 Foundry のすべての機能を使用してビルドするには、開発アクセス許可が必要です。

最初のプロジェクトでビルドを開始する

アクセス許可が設定されたので、Foundry の構築を開始する準備ができました。 Azure AI Foundry ポータルで、最初のプロジェクトを開くか作成します。プロジェクトは Foundry でエージェントとモデルのカスタマイズ作業を整理し、同じリソースの下に複数を作成できます。

リソースにバンドルされているサービスの一部を調べます。

サービス	説明
Azure AI Foundry Agent Service	生成 AI モデルの力と、エージェントが実際のデータソースにアクセスして操作できるようにするツールとを組み合わせます。
Azure AI モデル推論	Azure AI Foundry モデルカタログのフラグシップモデルのモデル推論を実行します。
Azure OpenAI	さまざまな自然言語タスクを実行します。
コンテンツの安全性	望ましくないコンテンツを検出する AI サービス
Document Intelligence	ドキュメントをインテリジェントなデータドリブンソリューションに変換します。
Language	業界をリードする自然言語理解機能を備えたアプリを構築します。
Speech	音声テキスト変換、テキスト読み上げ、翻訳、話者認識。
Translator	AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。