このクイック スタートでは、Microsoft Foundry リソースを作成し、アクセスを確認します。
Foundry リソースを作成および管理する方法について説明します。 これは、Azure 内のエージェントを含む生成 AI モデルとアプリケーションを構築、デプロイ、および管理するための主要な Azure リソースの種類 です。
Azure でサービスを使用および管理するには、Azure リソースが必要です。 ネットワーク、課金、監視などのアクセス、セキュリティを構成するためのスコープを定義します。
Foundry リソースは、次のバージョンであり、以前の "Foundry Tools" の名前変更です。 エージェント、モデルのデプロイ、評価などをホストするためのアプリケーション環境が提供されます。
Foundry リソースは、複数のユース ケースの作業を整理でき、 通常 は、同様のビジネスまたはデータ ドメインのユース ケースに取り組む開発者のチーム間で共有されます。 プロジェクトは、関連する作業をグループ化するためのフォルダーとして機能します。
注
Foundry (新しい) ポータルでは、既定のプロジェクトのみを使用できます。 Foundry (クラシック) ポータルを使用して、Foundry リソース上の他のすべてのプロジェクトと対話します。
高度なセキュリティ設定を使用して Foundry を構成する場合 詳細な Foundry 作成オプションを参照してください
最初のリソースを作成する
基本的な Azure 設定で最初のリソースを作成するには、Azure portal、Azure CLI、または PowerShell を使用して、次の手順に従います。
前提条件
- 有効な Azure サブスクリプション - 無料アカウントを作成する。
- リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
-
Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール
新しい Microsoft Foundry リソースを作成する
別名、セキュリティ制御、コスト タグなどのカスタマイズされた Azure 構成が組織で必要な場合、Azure portal またはテンプレート オプションを使用して、組織の Azure Policy コンプライアンスに準拠することが必要になる場合があります。
Foundry リソースは、Azure portal の Foundry>Foundry の下に表示されます。 API の種類は AIServices です。 次に示すロゴを探します。
ヒント
Foundry ポータル には、基本的な既定の設定を使用して 新しい Foundry リソースを作成 する方法が用意されています。
Azure portal で Foundry リソースを作成するには、次の手順に従います。
次の Foundry リソース リンクを選択します。 https://portal.azure.com/#create/Microsoft.CognitiveServicesAIFoundry
[作成] ページで、次の情報を指定します。
プロジェクトの詳細 説明 サブスクリプション 使用できる Azure サブスクリプションのいずれかを選択します。 リソース グループ Foundry リソースを含む Azure リソース グループ。 新しいグループを作成したり、既存のグループに追加したりできます。 リージョン Foundry Tool インスタンスの場所。 別の場所を選択すると待機時間が生じる可能性がありますが、リソースのランタイムの可用性には影響しません。 名前 Foundry リソースのわかりやすい名前。 たとえば、MyAIServicesResource。 必要に応じてリソースの他の設定を構成し、条件を読み取って同意し (該当する場合)、[Review + create(確認と作成) ] を選択します。
ヒント
サブスクリプションで Foundry リソースを作成できない場合は、Azure portal、PowerShell コマンド、または Azure CLI コマンドを使用して、その Azure リソース プロバイダーの特権を有効にする必要がある場合があります。 サブスクリプションの所有者でない場合は、"所有者" または "管理者" のロールを持つユーザーに、登録の完了を要求するか、アカウントに /register/action 特権を付与するように要求してください。
リソースをクリーンアップする
Foundry リソースをクリーンアップして削除する場合は、リソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。
- Azure Portal で左側のメニューを展開してサービスのメニューを開き、[リソース グループ] を選択して、リソース グループの一覧を表示します。
- 削除するリソースが含まれているリソース グループを見つけます。
- リソース グループ全体を削除する場合は、リソース グループ名を選択します。 次のページで [リソース グループの削除] を選択し、確認します。
- Foundry リソースのみを削除する場合は、リソース グループを選択して、その中のすべてのリソースを表示します。 次のページで、削除するリソースを選択し、その行の省略記号メニューを選択して、[削除] を選択します。
このクイック スタートでは、 Azure Command-Line Interface (CLI) コマンドを使用して Foundry リソースを作成します。
前提条件
- 有効な Azure サブスクリプション - 無料アカウントを作成します。
- Azure CLI バージョン 2.0 以降。
- リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
-
Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール
Azure CLI をインストールしてサインインする
Azure CLI をインストールします。 CLI のローカル インストールにサインインするには、az login コマンドを実行します。
az login
新しいリソース グループを作成する
Foundry リソースを作成する前に、リソースを格納する Azure リソース グループが必要です。 新しいリソースを作成するときは、新しいリソース グループを作成するか、既存のものを使用できます。 この記事では、新しいリソース グループを作成する方法を示します。
リソースを作成するには、お使いのサブスクリプションに使用できるいずれかの Azure の場所が必要です。 使用できる場所の一覧を取得するには、az account list-locations コマンドを使用します。 ほとんどの Foundry Tools には、複数の場所からアクセスできます。 お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。
重要
- Microsoft Foundry リソースを呼び出すときに必要な Azure の場所を覚えておいてください。
- Foundry Tools の一部の可用性は、リージョンによって異なる場合があります。 詳細については、「リージョン別の 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
Foundry リソースを作成する
新しい Foundry リソースを作成してサブスクライブするには、 az cognitiveservices account create コマンドを 使用します。 このコマンドで、以前に作成したリソース グループに新しい課金対象リソースが追加されます。 新しいリソースを作成するときには、使用するサービスの種類、その価格レベル (つまり SKU)、および Azure の場所を把握している必要があります。
重要
Azure には、Foundry Tools 用に複数のリソースの種類が用意されています。 必ず、kind の AIServices を使用して作成してください。
次のコマンドを使用して、 foundry-multi-service-resource という名前の Foundry リソースを作成できます。
az cognitiveservices account create --name foundry-multi-service-resource --resource-group ai-services-resource-group --kind AIServices --sku S0 --location westus2 --yes
ヒント
サブスクリプションで Foundry リソースを作成できない場合は、Azure portal、PowerShell コマンド、または Azure CLI コマンドを使用して、その Azure リソース プロバイダーの特権を有効にする必要がある場合があります。 サブスクリプションの所有者でない場合は、"所有者" または "管理者" のロールを持つユーザーに、登録の完了を要求するか、アカウントに /register/action 特権を付与するように要求してください。
現在のリソースのクォータ使用量を取得する
リソースの使用状況を取得するには、az cognitiveservices account list-usage コマンドを使います。
az cognitiveservices account list-usage --name foundry-multi-service-resource --resource-group ai-services-resource-group --subscription subscription-name
リソースをクリーンアップする
Foundry リソースをクリーンアップして削除する場合は、そのリソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。
リソース グループとそれに関連付けられているリソースを削除するには、az group delete command を使用します。
az group delete --name ai-services-resource-group
このクイック スタートでは、 Azure PowerShell コマンドを使用して Foundry リソースを作成します。
前提条件
- 有効な Azure サブスクリプション - 無料アカウントを作成します。
- Azure PowerShell バージョン 5.0 以降。
- リソースを作成するための Azure RBAC ロール。 Azure サブスクリプションまたはリソース グループに割り当てられている次のいずれかのロールが必要です。
- 投稿者
- オーナー
-
Microsoft.CognitiveServices/accounts/writeアクセス許可を持つカスタム ロール
Azure PowerShell をインストールしてサインインする
Azure PowerShellをインストールします。 サインインするには、Connect-AzAccount コマンドを実行します。
Connect-AzAccount
新しい Microsoft Foundry リソース グループを作成する
Foundry リソースを作成する前に、リソースを格納する Azure リソース グループが必要です。 新しいリソースを作成するときは、新しいリソース グループを作成するか、既存のものを使用できます。 この記事では、新しいリソース グループを作成する方法を示します。
リソースを作成するには、お使いのサブスクリプションに使用できるいずれかの Azure の場所が必要です。 Get-AzLocation コマンドを使って、使用できる場所の一覧を取得できます。 ほとんどの Foundry Tools には、複数の場所からアクセスできます。 お客様に最も近いものを選択するか、サービスに使用できる場所を確認します。
重要
- Foundry リソースを呼び出すときに必要なので、Azure の場所を覚えておいてください。
- Foundry Tools の一部の可用性は、リージョンによって異なる場合があります。 詳細については、「リージョン別の 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
Foundry リソースを作成する
新しい Foundry リソースを作成してサブスクライブするには、 New-AzCognitiveServicesAccount コマンドを使用します。 このコマンドで、以前に作成したリソース グループに新しい課金対象リソースが追加されます。 新しいリソースを作成するときには、使用するサービスの "種類"、その価格レベル (つまり SKU)、および Azure の場所を把握している必要があります。
重要
Azure には、Foundry Tools 用に複数のリソースの種類が用意されています。 必ず、Type の AIServices (種類) を使用して作成してください。
次のコマンドを使用して、 foundry-multi-service-resource という名前の Foundry リソースを作成できます。
New-AzCognitiveServicesAccount -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource -Type AIServices -SkuName S0 -Location westus2
ヒント
サブスクリプションで Foundry リソースを作成できない場合は、Azure portal、PowerShell コマンド、または Azure CLI コマンドを使用して、その Azure リソース プロバイダーの特権を有効にする必要がある場合があります。 サブスクリプションの所有者でない場合は、"所有者" または "管理者" のロールを持つユーザーに、登録の完了を要求するか、アカウントに /register/action 特権を付与するように要求してください。
現在のリソースのクォータ使用量を取得する
リソースの使用状況を取得するには、Get-AzCognitiveServicesAccountUsage コマンドを使います。
Get-AzCognitiveServicesAccountUsage -ResourceGroupName ai-services-resource-group -Name foundry-multi-service-resource
リソースをクリーンアップする
Foundry リソースをクリーンアップして削除する場合は、そのリソースまたはリソース グループを削除できます。 リソース グループを削除すると、そのグループに含まれている他のリソースも削除されます。
リソース グループとそれに関連付けられているリソースを削除するには、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 AI アカウント所有者 | AI プロジェクトとアカウントを管理するためのフル アクセスを許可します。 他のユーザーを "Azure AI ユーザー" としてプロジェクトで共同作業するように招待できます。 |
| Azure AI 所有者 | マネージド AI プロジェクトとアカウントへのフル アクセスを許可し、プロジェクトを使用してビルドおよび開発します。 |
注
Azure AI 所有者ロールは、近日中に Azure と Foundry ポータルで割り当てることができます。
厳密なロールベースのアクセス要件を持つ大企業の場合は、Azure AI ユーザー ロールを最小限の特権の開発者アクセス許可として使用することをお勧めします。 開発者が組織内でセルフサービスすることを望む小規模企業の場合は、開発者のアクセス許可とリソース作成のアクセス許可に Azure AI 所有者ロールを使用することをお勧めします。
承認されたユーザー (通常は Azure サブスクリプションまたはリソース グループ所有者) のみが、[Azure portal](Azure portal へのリンク) または [管理者経由の Foundry ポータル](Foundry ポータルへのリンク) を使用してロールを割り当てることができます。 ロールベースのアクセス制御について詳しくは、こちらをご覧ください。
重要
Azure 所有者ロールと共同作成者ロールには管理アクセス許可のみが含まれており、開発アクセス許可は含まれません。 Foundry のすべての機能を使用してビルドするには、開発アクセス許可が必要です。
最初のプロジェクトでビルドを開始する
アクセス許可が設定されたので、Foundry の構築を開始する準備ができました。 Foundry ポータルで、最初のプロジェクトを開くか作成します。 プロジェクトは Foundry でエージェントとモデルのカスタマイズ作業を整理し、 同じリソースの下に複数を作成できます。
リソースにバンドルされているサービスの一部を調べます。
| サービス | 説明 |
|---|---|
Foundry エージェント サービス |
生成 AI モデルの力と、エージェントが実際のデータ ソースにアクセスして操作できるようにするツールとを組み合わせます。 |
|
Azure モデル推論 |
Foundry モデル カタログ内のフラグシップ モデルのモデル推論を実行します。 |
Azure OpenAI |
さまざまな自然言語タスクを実行します。 |
コンテンツの安全性 |
不要なコンテンツを検出する Foundry ツール。 |
Document Intelligence |
ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。 |
Language |
業界をリードする自然言語理解機能を備えたアプリを構築します。 |
Speech |
音声テキスト変換、テキスト読み上げ、翻訳、話者認識。 |
Translator |
AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。 |
次のステップ
- 作業を 整理するプロジェクトを作成します。
- ツールを接続 して、より豊富なアプリケーションを構築します。
- Foundry で他のユーザーを作業環境に招待するアクセス制御について説明します。
- プライベート ネットワークを使用してリソースをセキュリティで保護する