你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
如果要将 Azure 代理服务用于已有的资源,请使用本文。
注释
- 如果在 Azure AI Foundry 模型资源中使用现有的 AI 服务/Azure OpenAI,则不会部署任何模型。 可以在代理设置完成后将模型部署到资源。
- 确保 Azure OpenAI 资源和 Azure AI Foundry 项目位于同一区域。
选择基本代理或标准代理设置
要使用自己的资源,可以在提供的部署模板中编辑参数。 若要开始,请确定是要编辑 基本代理设置模板还是 标准代理设置模板。
基本设置:在基本项目中创建的代理使用完全由Microsoft管理的多租户搜索和存储资源。 你无法查看或控制这些基础 Azure 资源。 只能将自己的 AI 服务帐户用于此选项。
标准设置:在标准项目中创建的代理使用客户拥有的单租户搜索和存储资源。 通过此设置,可以完全控制这些资源并查看这些资源,但会根据使用情况产生成本。 可以通过此选项使用自己的 AI 服务帐户、Azure 存储帐户、Cosmos DB for NoSQL 帐户和/或 Azure AI 搜索资源。
基本代理设置:使用现有的 AI 服务/Azure OpenAI 资源
将 aiServiceAccountResourceId
的参数值替换为要使用的 AI 服务或 Azure OpenAI 资源的完整 arm 资源 ID。
要获取 AI 服务帐户资源 ID,请使用 AI 服务帐户登录到 Azure CLI 并选择订阅:
az login
将
<your-resource-group>
替换为包含资源的资源组,并将your-ai-service-resource-name
替换为 AI 服务资源的名称,然后运行:az cognitiveservices account show --resource-group <your-resource-group> --name <your-ai-service-resource-name> --query "id" --output tsv
返回的值是需要在模板中使用的
aiServiceAccountResourceId
。在基本代理模板文件中,替换以下占位符:
aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName} [Azure OpenAI Only] aiServiceKind: AzureOpenAI
如果要使用现有的 Azure OpenAI 资源,则需要更新参数文件中的
aiServiceAccountResourceId
和aiServiceKind
参数。 aiServiceKind 参数应设置为 AzureOpenAI。
标准代理设置:使用现有的 AI 服务/Azure OpenAI、Azure 存储帐户、用于 NoSQL 帐户的 Azure Cosmos DB 和/或 Azure AI 搜索资源
通过在标准代理模板文件中提供完整的 ARM 资源 ID,使用现有的 AI 服务/Azure OpenAI、Azure 存储帐户、Azure Cosmos DB for NoSQL 帐户和/或 Azure AI 搜索资源。
使用现有的 AI 服务或 Azure OpenAI 资源
按照基本代理设置中的步骤获取 AI 服务帐户资源 ID。
在标准代理模板文件中,替换以下占位符:
aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName} [Azure OpenAI Only] aiServiceKind: AzureOpenAI
将现有的 Azure 存储帐户用于文件存储
要获取存储帐户资源 ID,请使用存储帐户登录到 Azure CLI 并选择订阅:
az login
然后运行 命令:
az storage account show --resource-group <your-resource-group> --name <your-storage-account> --query "id" --output tsv
输出是需要在模板中使用的
aiStorageAccountResourceID
。在标准代理模板文件中,替换以下占位符:
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/秒
若要获取 Azure Cosmos DB 帐户资源 ID,请登录到 Azure CLI,并使用帐户选择订阅:
az login
然后运行 命令:
az cosmosdb show --resource-group <your-resource-group> --name <your-comosdb-account> --query "id" --output tsv
输出是需要在模板中使用的
cosmosDBResourceId
。在标准代理模板文件中,替换以下占位符:
cosmosDBResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DocumentDB/databaseAccounts/{cosmosDbAccountName}
使用现有的 Azure AI 搜索资源
要获取 Azure AI 搜索资源 ID,请登录到 Azure CLI,并使用搜索资源选择订阅:
az login
然后运行 命令:
az search service show --resource-group <your-resource-group> --name <your-search-service> --query "id" --output tsv
在标准代理模板文件中,替换以下占位符:
aiSearchServiceResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Search/searchServices/{searchServiceName}
另请参阅
- 了解代理人可以使用的不同工具。