你当前正在访问 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。

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

    az login

  2. <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

  3. 在基本代理模板文件中,替换以下占位符:

    aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
    
    [Azure OpenAI Only] aiServiceKind: AzureOpenAI
    

    如果要使用现有的 Azure OpenAI 资源,则需要更新参数文件中的 aiServiceAccountResourceIdaiServiceKind 参数。 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 资源

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

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

    aiServiceAccountResourceId:/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.CognitiveServices/accounts/{serviceName}
    
    [Azure OpenAI Only] aiServiceKind: AzureOpenAI
    

将现有的 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}
    

另请参阅

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