你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Microsoft。CognitiveServices 账户/项目/应用

Bicep资源定义

帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:

有关每个 API 版本中已更改属性的列表,请参阅更改日志

资源格式

去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource ,把以下 Bicep 添加到你的模板里。

resource symbolicname 'Microsoft.CognitiveServices/accounts/projects/applications@2026-05-15-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    agentIdentityBlueprint: {
      clientId: 'string'
      kind: 'string'
      principalId: 'string'
      subject: 'string'
      tenantId: 'string'
      type: 'string'
    }
    agents: [
      {
        agentId: 'string'
        agentName: 'string'
      }
    ]
    authorizationPolicy: {
      type: 'string'
      // For remaining properties, see ApplicationAuthorizationPolicy objects
    }
    baseUrl: 'string'
    defaultInstanceIdentity: {
      clientId: 'string'
      kind: 'string'
      principalId: 'string'
      subject: 'string'
      tenantId: 'string'
      type: 'string'
    }
    description: 'string'
    displayName: 'string'
    tags: {
      {customized property}: 'string'
    }
    trafficRoutingPolicy: {
      protocol: 'string'
      rules: [
        {
          deploymentId: 'string'
          description: 'string'
          ruleId: 'string'
          trafficPercentage: int
        }
      ]
    }
  }
}

ApplicationAuthorizationPolicy 对象

设置 type 属性以指定对象的类型。

对于 频道,请使用:

{
  type: 'Channels'
}

对于 默认,请使用:

{
  type: 'Default'
}

对于 OrganizationScope,请使用:

{
  type: 'OrganizationScope'
}

属性值

Microsoft。认知服务/账户/项目/应用

Name Description 价值
姓名 资源名称 字符串(必需)
父级 在 Bicep 中,你可以指定子资源的父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源
类型资源的符号名称:帐户/项目
属性 [必需]实体的其他属性。 AgenticApplicationProperties (必备)

AgenticApplicationProperties(代理应用属性)

Name Description 价值
agentIdentity蓝图 应用程序的 EntraId 代理蓝图。 已分配身份
代理 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 代理参考属性[]
authorizationPolicy 获取或设置与此代理应用程序实例关联的授权策略。 应用程序授权策略
baseUrl 应用程序的专用调用终结点。 字符串
defaultInstanceIdentity 应用程序的(默认)代理实例标识。 已分配身份
描述 资产说明文本。 字符串
displayName 应用程序的显示名称。 字符串
tags 标记字典。 可以添加、删除和更新标记。 ResourceBaseTags
trafficRoutingPolicy 获取或设置应用程序部署的流量路由策略。 应用程序交通路由策略

代理参考属性

Name Description 价值
agentId 获取组织(订阅)中代理的唯一标识符。 字符串
agentName (代理名称) 获取代理的名称(在项目/应用中唯一)。 字符串

应用程序授权策略

Name Description 价值
类型 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 “通道”
'Default'
'OrganizationScope'(必需)

应用程序交通路由策略

Name Description 价值
协议 用于将流量路由到应用程序部署的方法。 “固定比率”
规则 获取或设置流量路由规则的集合。 TrafficRoutingRule[]

已分配身份

Name Description 价值
clientId 标识的客户端 ID。 字符串(必需)
kind 指定此对象描述的 Entra 标识类型。 “代理蓝图”
“代理用户”
'代理实例'
'Managed'
“无”(必需)
principalId 标识的主体 ID。 字符串(必需)
主题 此标识分配的主题。 字符串
tenantId 标识的租户 ID。 字符串(必需)
类型 从管理角度枚举身份类型。 'None'
'System'
“User”(必需)

ChannelsBuiltIn授权政策

Name Description 价值
类型 授权方案类型。 “通道”(必备)

OrganizationSharedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'OrganizationScope'(必需)

ResourceBaseTags

Name Description 价值

RoleBasedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'Default'(必填)

TrafficRouting规则

Name Description 价值
deploymentId 此规则将流量路由到的部署的唯一标识符。 字符串
描述 用户为此流量路由规则提供的说明。 字符串
规则 ID 此流量路由规则的标识符。 字符串
流量百分比 获取或设置分配给此实例的流量百分比。 int

ARM 模板资源定义

帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:

用法示例

资源格式

去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource,在模板中添加以下JSON。

{
  "type": "Microsoft.CognitiveServices/accounts/projects/applications",
  "apiVersion": "2026-05-15-preview",
  "name": "string",
  "properties": {
    "agentIdentityBlueprint": {
      "clientId": "string",
      "kind": "string",
      "principalId": "string",
      "subject": "string",
      "tenantId": "string",
      "type": "string"
    },
    "agents": [
      {
        "agentId": "string",
        "agentName": "string"
      }
    ],
    "authorizationPolicy": {
      "type": "string"
      // For remaining properties, see ApplicationAuthorizationPolicy objects
    },
    "baseUrl": "string",
    "defaultInstanceIdentity": {
      "clientId": "string",
      "kind": "string",
      "principalId": "string",
      "subject": "string",
      "tenantId": "string",
      "type": "string"
    },
    "description": "string",
    "displayName": "string",
    "tags": {
      "{customized property}": "string"
    },
    "trafficRoutingPolicy": {
      "protocol": "string",
      "rules": [
        {
          "deploymentId": "string",
          "description": "string",
          "ruleId": "string",
          "trafficPercentage": "int"
        }
      ]
    }
  }
}

ApplicationAuthorizationPolicy 对象

设置 type 属性以指定对象的类型。

对于 频道,请使用:

{
  "type": "Channels"
}

对于 默认,请使用:

{
  "type": "Default"
}

对于 OrganizationScope,请使用:

{
  "type": "OrganizationScope"
}

属性值

Microsoft。认知服务/账户/项目/应用

Name Description 价值
apiVersion API 版本 '2026-05-15-预览'
姓名 资源名称 字符串(必需)
属性 [必需]实体的其他属性。 AgenticApplicationProperties (必备)
类型 资源类型 “Microsoft。认知服务/账户/项目/应用

AgenticApplicationProperties(代理应用属性)

Name Description 价值
agentIdentity蓝图 应用程序的 EntraId 代理蓝图。 已分配身份
代理 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 代理参考属性[]
authorizationPolicy 获取或设置与此代理应用程序实例关联的授权策略。 应用程序授权策略
baseUrl 应用程序的专用调用终结点。 字符串
defaultInstanceIdentity 应用程序的(默认)代理实例标识。 已分配身份
描述 资产说明文本。 字符串
displayName 应用程序的显示名称。 字符串
tags 标记字典。 可以添加、删除和更新标记。 ResourceBaseTags
trafficRoutingPolicy 获取或设置应用程序部署的流量路由策略。 应用程序交通路由策略

代理参考属性

Name Description 价值
agentId 获取组织(订阅)中代理的唯一标识符。 字符串
agentName (代理名称) 获取代理的名称(在项目/应用中唯一)。 字符串

应用程序授权策略

Name Description 价值
类型 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 “通道”
'Default'
'OrganizationScope'(必需)

应用程序交通路由策略

Name Description 价值
协议 用于将流量路由到应用程序部署的方法。 “固定比率”
规则 获取或设置流量路由规则的集合。 TrafficRoutingRule[]

已分配身份

Name Description 价值
clientId 标识的客户端 ID。 字符串(必需)
kind 指定此对象描述的 Entra 标识类型。 “代理蓝图”
“代理用户”
'代理实例'
'Managed'
“无”(必需)
principalId 标识的主体 ID。 字符串(必需)
主题 此标识分配的主题。 字符串
tenantId 标识的租户 ID。 字符串(必需)
类型 从管理角度枚举身份类型。 'None'
'System'
“User”(必需)

ChannelsBuiltIn授权政策

Name Description 价值
类型 授权方案类型。 “通道”(必备)

OrganizationSharedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'OrganizationScope'(必需)

ResourceBaseTags

Name Description 价值

RoleBasedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'Default'(必填)

TrafficRouting规则

Name Description 价值
deploymentId 此规则将流量路由到的部署的唯一标识符。 字符串
描述 用户为此流量路由规则提供的说明。 字符串
规则 ID 此流量路由规则的标识符。 字符串
流量百分比 获取或设置分配给此实例的流量百分比。 int

Terraform (AzAPI 提供程序)资源定义

帐户/项目/应用程序资源类型可以使用针对以下目标的作进行部署:

  • 资源组 关于每个API版本中变更属性的列表,请参见 更改日志

资源格式

去创造一个Microsoft。CognitiveServices/accounts/projects/applications resource ,将以下 Terraform 添加到你的模板中。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.CognitiveServices/accounts/projects/applications@2026-05-15-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      agentIdentityBlueprint = {
        clientId = "string"
        kind = "string"
        principalId = "string"
        subject = "string"
        tenantId = "string"
        type = "string"
      }
      agents = [
        {
          agentId = "string"
          agentName = "string"
        }
      ]
      authorizationPolicy = {
        type = "string"
        // For remaining properties, see ApplicationAuthorizationPolicy objects
      }
      baseUrl = "string"
      defaultInstanceIdentity = {
        clientId = "string"
        kind = "string"
        principalId = "string"
        subject = "string"
        tenantId = "string"
        type = "string"
      }
      description = "string"
      displayName = "string"
      tags = {
        {customized property} = "string"
      }
      trafficRoutingPolicy = {
        protocol = "string"
        rules = [
          {
            deploymentId = "string"
            description = "string"
            ruleId = "string"
            trafficPercentage = int
          }
        ]
      }
    }
  }
}

ApplicationAuthorizationPolicy 对象

设置 type 属性以指定对象的类型。

对于 频道,请使用:

{
  type = "Channels"
}

对于 默认,请使用:

{
  type = "Default"
}

对于 OrganizationScope,请使用:

{
  type = "OrganizationScope"
}

属性值

Microsoft。认知服务/账户/项目/应用

Name Description 价值
姓名 资源名称 字符串(必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:帐户/项目
属性 [必需]实体的其他属性。 AgenticApplicationProperties (必备)
类型 资源类型 “Microsoft。CognitiveServices/accounts/projects/applications@2026-05-15-preview”

AgenticApplicationProperties(代理应用属性)

Name Description 价值
agentIdentity蓝图 应用程序的 EntraId 代理蓝图。 已分配身份
代理 构成此应用程序的代理定义列表,作为对父项目下对象的引用返回;使用它来获取此应用程序表示的所有代理版本对的平面列表。 代理参考属性[]
authorizationPolicy 获取或设置与此代理应用程序实例关联的授权策略。 应用程序授权策略
baseUrl 应用程序的专用调用终结点。 字符串
defaultInstanceIdentity 应用程序的(默认)代理实例标识。 已分配身份
描述 资产说明文本。 字符串
displayName 应用程序的显示名称。 字符串
tags 标记字典。 可以添加、删除和更新标记。 ResourceBaseTags
trafficRoutingPolicy 获取或设置应用程序部署的流量路由策略。 应用程序交通路由策略

代理参考属性

Name Description 价值
agentId 获取组织(订阅)中代理的唯一标识符。 字符串
agentName (代理名称) 获取代理的名称(在项目/应用中唯一)。 字符串

应用程序授权策略

Name Description 价值
类型 ChannelsBuiltInAuthorizationPolicy 类型设置为“Channels”。 将 类型 RoleBasedBuiltInAuthorizationPolicy 设置为“默认”。 将类型 OrganizationSharedBuiltInAuthorizationPolicy 设置为“OrganizationScope”。 “通道”
'Default'
'OrganizationScope'(必需)

应用程序交通路由策略

Name Description 价值
协议 用于将流量路由到应用程序部署的方法。 “固定比率”
规则 获取或设置流量路由规则的集合。 TrafficRoutingRule[]

已分配身份

Name Description 价值
clientId 标识的客户端 ID。 字符串(必需)
kind 指定此对象描述的 Entra 标识类型。 “代理蓝图”
“代理用户”
'代理实例'
'Managed'
“无”(必需)
principalId 标识的主体 ID。 字符串(必需)
主题 此标识分配的主题。 字符串
tenantId 标识的租户 ID。 字符串(必需)
类型 从管理角度枚举身份类型。 'None'
'System'
“User”(必需)

ChannelsBuiltIn授权政策

Name Description 价值
类型 授权方案类型。 “通道”(必备)

OrganizationSharedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'OrganizationScope'(必需)

ResourceBaseTags

Name Description 价值

RoleBasedBuiltInAuthorizationPolicy

Name Description 价值
类型 授权方案类型。 'Default'(必填)

TrafficRouting规则

Name Description 价值
deploymentId 此规则将流量路由到的部署的唯一标识符。 字符串
描述 用户为此流量路由规则提供的说明。 字符串
规则 ID 此流量路由规则的标识符。 字符串
流量百分比 获取或设置分配给此实例的流量百分比。 int