次の方法で共有

独自のリソースを使用する

独自のリソースを使用して Foundry プロジェクトを設定する場合は、この記事を使用します。

制限事項

Azure Cosmos DB for NoSQL を使用してスレッドを格納する

  • 標準セットアップで使用される既存の Azure Cosmos DB for NoSQL アカウントには、3,000 RU/秒以上の合計スループット制限が必要です。 プロビジョニングされたスループットとサーバーレスの両方がサポートされています。
  • 既存の Cosmos DB アカウントに 3 つのコンテナーがプロビジョニングされ、それぞれ 1,000 RU/秒が必要です

注

  • Azure OpenAI リソースと Azure AI Foundry アカウントとプロジェクトが同じリージョンにあることを確認します。

[前提条件]

  • Azure サブスクリプション。無料で作成できます。

  • アカウントとプロジェクトを作成する個々のユーザーが、サブスクリプション スコープで Azure AI アカウント所有者 ロールを持っていることを確認します

  • 標準セットアップを構成する場合、同じ個人が必要なリソース (Cosmos DB、検索、ストレージ) にロールを割り当てるアクセス許可も必要です。 Azure AI Foundry での RBAC の詳細については、Azure AI Foundry での RBAC に関するページを参照してください。

    • 必要な組み込みロールは 、ロール ベースのアクセス管理者です。
    • または、サブスクリプション レベルで 所有者 ロールを持つことも、この要件を満たします。
    • 必要な主なアクセス許可は次のとおりです。 Microsoft.Authorization/roleAssignments/write

  • プロバイダーを登録します。 次のプロバイダーを登録する必要があります。

    • Microsoft.KeyVault
    • Microsoft.CognitiveServices
    • Microsoft.Storage
    • Microsoft.MachineLearningServices
    • Microsoft.Search
    • Microsoft.App
    • Microsoft.ContainerService
    • Bing 検索を使用した典拠ツール を使用するには: Microsoft.Bing
       az provider register --namespace 'Microsoft.KeyVault'
   az provider register --namespace 'Microsoft.CognitiveServices'
   az provider register --namespace 'Microsoft.Storage'
   az provider register --namespace 'Microsoft.MachineLearningServices'
   az provider register --namespace 'Microsoft.Search'
   az provider register --namespace 'Microsoft.App'
   az provider register --namespace 'Microsoft.ContainerService'
   # only to use Grounding with Bing Search tool
   az provider register --namespace 'Microsoft.Bing'

エージェントの Basic セットアップまたは Standard セットアップを選択する

独自のリソースを使用するために、提供されたデプロイ テンプレートのパラメーターを編集できます。 開始するには、 基本的なエージェント セットアップ テンプレートと標準エージェント セットアップ テンプレートのどちらを編集するかを決定 します。

基本的なセットアップ

このセットアップは OpenAI Assistants と互換性があり、プラットフォームの組み込みストレージを使用してエージェントの状態を管理します。 これには、Assistants API と同じツールと機能が含まれており、Azure AI Search や Bing などの非 OpenAI モデルとツールのサポートが追加されています。

標準セットアップ

独自の Azure リソースを使用できるようにすることで、基本的なセットアップとデータに対するきめ細かい制御のすべてを含みます。 ファイル、スレッド、ベクター ストアを含むすべての顧客データは、独自の Azure リソースに格納され、完全な所有権と制御が提供されます。

基本的なエージェントのセットアップ: 既存の Azure OpenAI リソースを使用する

existingAoaiResourceIdのパラメーター値を、使用する Azure OpenAI リソースのフル アーム リソース ID に置き換えます。

  1. Azure OpenAI アカウントのリソース ID を取得するには、Azure CLI にサインインし、AI サービス アカウントでサブスクリプションを選択します。

    az login

  2. <your-resource-group> を使用するリソースが含まれるリソース グループに、your-azure-openai-resource-name を使用する AI Services リソースの名前に置き換え、実行します。

    az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv

    返される値は existingAoaiResourceId で、テンプレートで使用する必要があります。

  3. 基本的なエージェント テンプレート ファイルで、次のプレースホルダーを置き換えます。

    existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}

標準エージェントのセットアップ: 既存のサービス リソースとストレージ アカウントを使用する

標準エージェント テンプレート ファイルに完全な ARM リソース ID を指定して、既存の Azure OpenAI、Azure Storage アカウント、Azure Cosmos DB for NoSQL アカウント、または Azure AI Search リソースを使用します。

既存の Azure OpenAI リソースを使用する

  1. Basic エージェント セットアップのステップに従い、AI Services アカウントのリソース ID を取得します。

  2. Standard エージェント テンプレート ファイルで、次のプレースホルダーを置き換えます。

    existingAoaiResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}

ファイル ストレージに既存の Azure Storage アカウントを使用する

  1. ストレージ アカウントのリソース ID を取得するには、Azure CLI にサインインして、使用するストレージ アカウントのサブスクリプションを選択します。

    az login

  2. 次に、 コマンドを実行します。

    az storage account show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv

    その出力は aiStorageAccountResourceID で、テンプレートで使用する必要があります。

  3. Standard エージェント テンプレート ファイルで、次のプレースホルダーを置き換えます。

    aiStorageAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Storage/storageAccounts/{storageAccountName}

スレッド ストレージに既存の Azure Cosmos DB for NoSQL アカウントを使用する

Azure Cosmos DB for NoSQL

  • 標準セットアップで使用される既存の Azure Cosmos DB for NoSQL アカウントには、少なくとも 3,000 RU/秒の合計スループット制限が必要です。 プロビジョニング済みスループットとサーバーレスの両方がサポートされています。
    • 既存の Cosmos DB アカウントに 3 つのコンテナーがプロビジョニングされ、それぞれに 1,000 RU/秒が必要です

  1. Azure Cosmos DB アカウントのリソース ID を取得するには、Azure CLI にサインインし、自分のアカウントでサブスクリプションを選択します。

    az login

  2. 次に、 コマンドを実行します。

    az cosmosdb show --resource-group  <your-resource-group> --name <your-comosdb-account>  --query "id" --output tsv

    その出力は cosmosDBResourceId で、テンプレートで使用する必要があります。

  3. Standard エージェント テンプレート ファイルで、次のプレースホルダーを置き換えます。

    cosmosDBResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosDbAccountName}

Azure AI Search の既存のリソースを使用する

  1. Azure AI Search のリソース ID を取得するには、Azure CLI にサインインして、使用する Search のリソースのサブスクリプションを選択します。

    az login

  2. 次に、 コマンドを実行します。

    az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv

  3. Standard エージェント テンプレート ファイルで、次のプレースホルダーを置き換えます。

    aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}

こちらも参照ください

  • エージェントが使用できるさまざまな ツール について説明します。