次の方法で共有

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

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

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

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

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

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

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

注

Foundry (新しい) ポータルでは、既定のprojectのみを使用できます。 Foundry (クラシック) ポータルを使用して、Foundry リソース上の他のすべてのプロジェクトと対話します。

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

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

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

前提条件

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

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

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

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

Azure portal.

ヒント

Foundry portal では、基本的な既定の設定を使用して新しい Foundry リソースを作成できます。

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

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

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

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

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

ヒント

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

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

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

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

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

前提条件

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

Azure CLIをインストールしてサインインする

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

az login

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

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

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

重要

  • Microsoft Foundry リソースを呼び出すときに必要なAzureの場所を覚えておいてください。
  • Foundry Tools の一部の可用性は、リージョンによって異なる場合があります。 詳細については、「Azure 製品のリージョン別を参照してください。
az account list-locations --query "[].{Region:name}" --out table

Azureの場所を作成したら、az group create コマンドを使用してAzure CLIに新しいリソース グループを作成します。 次の例では、Azureの場所 westus2 を、サブスクリプションで使用可能なAzureの場所のいずれかに置き換えます。

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 サブスクリプション - Create one 無料。
  • Azure PowerShell バージョン 5.0 以降。
  • RBAC ロールをAzureしてリソースを作成します。 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の場所を取得したら、New-AzResourceGroup コマンドを使用してAzure PowerShellに新しいリソース グループを作成します。 次の例では、Azureの場所 westus2 を、サブスクリプションで使用可能なAzureの場所のいずれかに置き換えます。

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

リソースをAccessする

最初のリソースを作成したら、Foundry ポータルを使用して UX プロトタイプ作成、開発用のFoundry SDK、または管理管理用の Azure portal を介してを使用してaccessできます。

セットアップを確認する

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

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

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

Role 説明
ai Project Manager のAzure 開発アクセス許可とproject管理アクセス許可を付与します。 他のユーザーを招待して、"Azure AI ユーザー" としてprojectで共同作業を行うことができます。
Azure AI ユーザー 開発アクセス許可を付与します。
Azure AI アカウント所有者 AI プロジェクトとアカウントを管理するための完全なaccessを付与します。 他のユーザーを招待して、"Azure AI ユーザー" としてprojectで共同作業を行うことができます。
Azure AI 所有者 マネージド AI プロジェクトとアカウントに完全なaccessを付与し、プロジェクトを使用してビルドおよび開発します。

注

Azure AI 所有者ロールは、近日中に Azure および Foundry ポータルで割り当てることができます。

Foundry の組み込みロールの図。

access要件に基づく厳密なロールを持つ大規模な企業の場合は、Azure AI ユーザー ロールを最小限の特権の開発者アクセス許可として使用することをお勧めします。 開発者が組織内でセルフサービスすることを望む小規模な企業の場合は、開発者のアクセス許可とリソース作成アクセス許可に Azure AI 所有者ロールを使用することをお勧めします。

承認されたユーザー (通常、Azure サブスクリプションまたはリソース グループ所有者) のみが、[Azure portal](Azure portalへのリンク) または [管理経由の Foundry ポータル](Foundry ポータルへのリンク) を使用してロールを割り当てることができます。 ロールベースのaccess controlの詳細を参照してください。

重要

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

最初のprojectでビルドを開始する

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

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

サービス 説明
Foundry icon Foundry Agent Service ジェネレーティブ AI モデルの能力と、エージェントが実際のデータ ソースをaccessして対話できるようにするツールを組み合わせます。
Foundry アイコン Azure モデル推論 Foundry モデル カタログ内のフラグシップ モデルのモデル推論を実行します。
Azure OpenAI in Foundry Models アイコン Azure OpenAI さまざまな自然言語タスクを実行します。
Content Safety icon Content Safety 不要なコンテンツを検出する Foundry ツール。
Document Intelligence アイコン Document Intelligence ドキュメントをインテリジェントなデータ ドリブン ソリューションに変換します。
Language アイコン Language 業界をリードする自然なlanguage understanding機能を備えたアプリを構築します。
Speech アイコン Speech 音声テキスト変換、text to speech、翻訳、話者認識。
Translator アイコン Translator AI を利用した翻訳テクノロジを使用して、100 以上の使用中の言語、危険にさらされている言語、消滅の危機に瀕している言語や方言を翻訳します。

次のステップ

  • Last updated on