使用自己的资源

如果要使用自己的资源设置 Foundry 项目，请使用本文。

局限性

使用 Azure Cosmos DB for NoSQL 存储线程

• 标准设置中使用的现有 Azure Cosmos DB for NoSQL 帐户的总吞吐量限制必须至少为 3000 RU/秒。 同时支持预配的吞吐量和无服务器吞吐量。
• 在您现有的 Cosmos DB 帐户中将配置三个容器，每个容器需要 1000 RU/秒。

先决条件

• 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
  • 若要使用“使用必应搜索查找事实依据”工具，请运行以下命令：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'
  

选择基本代理或标准代理设置

要使用自己的资源，可以在提供的部署模板中编辑参数。 若要开始，请确定是要编辑 基本代理设置模板还是 标准代理设置模板。

基本设置

此设置与 OpenAI 助手兼容，并使用平台的内置存储管理代理状态。 它包括与助手 API 相同的工具和功能，增加了对非 OpenAI 模型和工具（如 Azure AI 搜索和必应）的支持。

标准设置

包括基本设置中的所有内容，并通过允许你使用自己的 Azure 资源对你的数据进行精细控制。 所有客户数据（包括文件、线程和矢量存储）都存储在你自己的 Azure 资源中，从而提供完全所有权和控制。

基本代理设置：使用现有的 Azure OpenAI 资源

将 existingAoaiResourceId 的参数值替换为要使用的 Azure OpenAI 资源的完整 ARM 资源 ID。

1. 若要获取 Azure OpenAI 帐户资源 ID，请登录到 Azure CLI，并使用 AI 服务帐户选择订阅：

   az login
   

2. 将 <your-resource-group> 替换为包含资源的资源组，并将 your-azure-openai-resource-name 替换为 AI 服务资源的名称，然后运行：

   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 存储帐户、Azure Cosmos DB for NoSQL 帐户和/或 Azure AI 搜索资源。

使用现有的 Azure OpenAI 资源

1. 按照基本代理设置中的步骤获取 AI 服务帐户资源 ID。

2. 在标准代理模板文件中，替换以下占位符：

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

将现有的 Azure 存储帐户用于文件存储

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. 在标准代理模板文件中，替换以下占位符：

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

将现有的 Azure Cosmos DB for NoSQL 帐户用于线程存储

用于 NoSQL 的 Azure Cosmos DB

• 标准设置中使用的现有 Azure Cosmos DB for NoSQL 帐户必须至少具有至少 3000 RU/秒的总吞吐量限制。 同时支持预配吞吐量和无服务器吞吐量。
  • 现有 Cosmos DB 帐户中将预配 3 个容器，每个容器都需要 1000 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. 在标准代理模板文件中，替换以下占位符：

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

使用现有的 Azure AI 搜索资源

1. 要获取 Azure AI 搜索资源 ID，请登录到 Azure CLI，并使用搜索资源选择订阅：

   az login

2. 然后运行 命令：

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

3. 在标准代理模板文件中，替换以下占位符：

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

另请参阅

• 了解代理人可以使用的不同工具。