连接到自己的存储

Microsoft Foundry 将代理、Azure OpenAI、语音和语言服务汇集在一个统一的资源类型下。 使用自带存储（BYOS）可将这些功能生成的数据路由到你拥有和管理的 Azure 存储帐户。 配置模式与早期独立语音和语言资源类型保持一致（并提供向后兼容性）。

本文介绍如何使用两种总体方法将存储连接到 Foundry：

• 连接：建议用于大多数功能的基线。 连接提供共享数据指针。
• 功能主机：选择性地替代某一特定功能（例如，智能体标准设置）或显式将其绑定到几个连接中的一个连接。
• userOwnedStorage 字段：仅由语音和语言使用的资源级绑定。

先决条件

在连接存储之前，请确保具备：

拥有有效订阅的 Azure 帐户。 如果没有帐户，请创建一个 免费的 Azure 帐户，其中包括免费试用订阅。

1. 同一订阅中的 Azure 存储帐户（支持 Blob 存储服务）。
2. 对 Foundry 资源和存储帐户拥有参与者或所有者权限。
3. 明确计划使用的功能（代理、评估、数据集、内容理解、语音、语言）。
4. （可选）对存储帐户进行客户管理的密钥（CMK）加密的计划。

了解存储连接方法

铸造厂连接

Foundry 连接充当跨 Foundry 功能的共享数据指针（代理、评估、数据集、内容理解）。 每个连接都会包装目标存储终结点和身份验证，以便具有项目访问权限的用户可以在没有直接存储帐户权限的情况下使用数据。 使用连接作为默认模式；仅当需要将单个功能显式绑定（覆盖）到多个连接中的一个时，才创建一个功能主机。

功能主机

当存在多个存储连接时，功能主机会将特定功能绑定到指定的连接。 它们定义特定功能使用的存储连接。 最常将功能主机用于代理标准设置。 如果未为代理创建功能主机，Foundry 会为该功能使用Microsoft托管存储。

有关概念详细信息，请参阅 功能主机 。

userOwnedStorage （资源存储绑定）

该userOwnedStorage字段允许客户管理语音和语言功能的存储。 在资源级别创建资源期间设置此字段，因此资源中的所有项目共享同一存储帐户。

语音和语言功能共享存储帐户，但在其中使用不同的容器。 该设置在资源级别应用，创建后无法更改，而无需重新创建资源。

如果语音和语言方案之间需要严格的数据隔离，请使用不同的存储帐户创建单独的 Foundry 资源。

创建存储连接

为代理配置功能主机（合并的资源 + 项目步骤）

创建两个功能主机（一个位于资源级别，一个位于项目级别），每个主机引用相同的连接链，以便代理路由到存储。

1. 创建资源级连接（如上所示），如果尚不存在。

   注释

   如上一部分所述，选择“ 目录 ”选项卡并查找 Azure Blob 存储。

2. 创建一个引用该连接的资源级功能主机。
3. 在资源下创建一个项目或者打开一个项目。
4. 创建一个引用资源级功能主机的项目级功能主机。
5. 验证代理数据现在写入绑定的存储帐户。

示例 （Azure CLI） （说明）

# Placeholder example; adjust for actual CLI verbs when published
az ai-foundry capability-host create \
  --resource-name MyFoundryResource \
  --name agents-host \
  --feature agents \
  --connection-id /subscriptions/<sub>/resourceGroups/<rg>/providers/Microsoft.CognitiveServices/accounts/MyFoundryResource/connections/myblobconnection

示例 （PowerShell） （说明）

New-AIFCapabilityHost -ResourceName MyFoundryResource -Name agents-host -Feature agents -ConnectionId "/subscriptions/<sub>/resourceGroups/<rg>/.../connections/myblobconnection"

ARM 模板代码片段 （说明）

{
  "type": "Microsoft.CognitiveServices/accounts/capabilityHosts",
  "apiVersion": "2025-05-01-preview",
  "name": "[concat(parameters('foundryName'), '/agents-host')]",
  "properties": {
    "feature": "agents",
    "connectionId": "[resourceId('Microsoft.CognitiveServices/accounts/connections', parameters('foundryName'), 'myblobconnection')]"
  }
}

为代理配置功能主机

设置功能主机，以将存储连接用于代理标准设置。 需要在资源和项目级别配置功能主机。

创建资源级功能主机

1. 使用 Azure CLI 或 Azure REST API 示例创建资源级功能主机。

2. 在功能主机配置中引用以前创建的存储连接。

3. 设置功能类型以支持代理。

创建项目级功能主机

创建 Foundry 项目后：

1. 创建一个引用资源级功能主机的项目级功能主机。

2. 配置功能主机以启用代理功能。

3. 验证功能主机是否已正确链接到存储连接，如这个标准代理设置的代码示例中所示。

您的代理的标准设置现在使用您自己的存储帐户，而不是微软托管的存储。

为语音和语言设置 userOwnedStorage

通过 Bicep、ARM、Terraform、CLI 或 PowerShell 在资源创建过程中设置字段。

Bicep 示例

resource foundry 'Microsoft.CognitiveServices/accounts@2025-05-01-preview' = {
  name: myFoundryName
  location: location
  kind: 'AIServices'
  sku: { name: 'S0' }
  properties: {
    userOwnedStorage: {
      storageResourceId: storageAccount.id
    }
  }
}

Terraform 代码片段

请参阅 Terraform cognitive_account。

resource "azurerm_cognitive_account" "foundry" {
  name                = var.foundry_name
  location            = var.location
  resource_group_name = azurerm_resource_group.rg.name
  kind                = "AIServices"
  sku_name            = "S0"

  storage { # userOwnedStorage equivalent
    resource_id = azurerm_storage_account.speechlang.id
  }
}

角色分配

在 Azure 存储帐户上为 Foundry 资源（帐户）托管标识（而不是项目托管标识）创建角色分配。 分配 Storage Blob Data Contributor。

客户管理的端到端存储检查清单

1. 如果需要语音/语言，请使用 userOwnedStorage 创建资源。
2. 创建存储连接。
3. 创建资源级功能主机（代理在需要时替代）。
4. 创建项目级功能主机（代理在项目中替代）。
5. 将内容理解绑定到存储连接。

执行这些步骤后，所有功能（代理、评估、数据集、内容理解、语音、语言）路由到客户管理的存储。

相关内容

• 代理的功能主机
• 了解代理标准设置
• 将连接添加到您的项目中
• 恢复存储帐户
• Azure 存储文档
• 基础结构设置示例
• 连接语音/语言存储