使用自己的资源

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

Limitations

计划将现有资源与 Azure AI Foundry 代理服务配合使用时，应注意一些限制。

如果使用基于中心的项目或 Azure OpenAI 助手

目前，没有直接升级路径可将现有代理或其关联的数据资产（如文件、线程或向量存储）从基于中心的项目迁移到 Azure AI Foundry 项目。 也没有将现有 Azure OpenAI 助手转换为 Foundry 代理的升级路径，也没有自动迁移助手的文件、线程或向量存储的方法。

可以在 Foundry 项目中重复使用 Azure AI 服务或 Azure OpenAI 资源中的现有模型部署和配额。

基于中心的项目的 SDK 使用情况

从 2025 年 5 月开始，Azure AI 代理服务将为Foundry 项目启用终结点，而不是此前用于中心化项目的连接字符串。 SDK 和 REST API 的当前版本不再支持连接字符串。 建议创建新的铸造项目。

如果想要继续使用基于中心的项目和连接字符串，则需要：

• 使用项目概述中“连接字符串”下的项目连接字符串。

  

• 使用以前版本的 SDK 和关联的示例代码之一：

  • C#： 1.0.0-beta.2 或更早版本
  • Python： 1.0.0b10 或更早版本

用于 NoSQL 的 Azure Cosmos DB 用于存储线程

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

Prerequisites

• 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}
   

另请参阅

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