Microsoft.App ajanları

Bicep kaynak tanımı

Ajanların kaynak türü, aşağıdaki hedeflerle konuşlandırılabilir:

  • kaynak grupları - Bkz. kaynak grubu dağıtım komutları

Her API sürümünde değiştirilen özelliklerin listesi için bkz. değişiklik günlüğü.

Kaynak biçimi

Microsoft.App/agents bir kaynak oluşturmak için aşağıdaki Bicep'i şablonunuza ekleyin.

resource symbolicname 'Microsoft.App/agents@2026-01-01' = {
  identity: {
    type: 'string'
    userAssignedIdentities: {
      {customized property}: {}
    }
  }
  location: 'string'
  name: 'string'
  properties: {
    actionConfiguration: {
      accessLevel: 'string'
      identity: 'string'
      mode: 'string'
    }
    agentIdentity: {
      initialSponsorGroupId: 'string'
    }
    agentSpaceId: 'string'
    defaultModel: {
      name: 'string'
      provider: 'string'
    }
    incidentManagementConfiguration: {
      connectionKey: 'string'
      connectionName: 'string'
      connectionUrl: 'string'
      oboUser: 'string'
      type: 'string'
    }
    knowledgeGraphConfiguration: {
      identity: 'string'
      managedResources: [
        'string'
      ]
    }
    logConfiguration: {
      applicationInsightsConfiguration: {
        appId: 'string'
        connectionString: 'string'
      }
    }
    upgradeChannel: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
}

Özellik Değerleri

Microsoft.App/agents

İsim Açıklama Değer
kimlik Bu kaynağa atanan yönetilen hizmet kimlikleri. ManagedServiceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı string

Constraints:
Desen = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (gerekli)
properties Bu kaynağın kaynağa özgü özellikleri. Ajan Özellikleri
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri

ActionConfiguration

İsim Açıklama Değer
erişim düzeyi Eylemin erişim seviyesi 'High'
'Low'
kimlik Eylemin kullandığı kimlik String
modu Eylem şekli 'Özerk'
'Salt Okunur'
'İnceleme'

AjanIdentity

İsim Açıklama Değer
initialSponsorGroupId İlk sponsor grup kimliği (temsilci kimliği için gereklidir) dize (gerekli)

Ajan Özellikleri

İsim Açıklama Değer
actionConfiguration Eylem için yapılandırma ActionConfiguration
ajanIdentity Kaynaklara erişim için ajan kimliği yapılandırması AjanIdentity
agentSpaceId Ajan tarafından referans verilen ajan uzay kimliği String
defaultModel Ajan için varsayılan yapay zeka model yapılandırması DefaultModel
incidentManagementConfiguration Olay yönetimi yapılandırmaları IncidentManagementConfiguration
knowledgeGraphConfiguration Ajan için bilgi grafiği yapılandırması KnowledgeGraphConfiguration
logConfiguration Log yapılandırmaları LogConfiguration
upgradeChannel Ajanın yükseltme kanalı 'Preview'
'Stable'

ApplicationInsightsConfiguration

İsim Açıklama Değer
appId (uygulama kimliği) Application Insights kaynağı için Uygulama Kimliği String
connectionString Application Insights kaynağı için bağlantı dizisi string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.

DefaultModel

İsim Açıklama Değer
isim Model adı (örneğin, gpt-5, claude-opus-4-5, claude-sonnet-4-5) String
provider Yapay zeka sağlayıcı adı (örneğin, MicrosoftFoundry, Anthropic) String

IncidentManagementConfiguration

İsim Açıklama Değer
bağlantıAnahtarı Bağlantının anahtarı string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
connectionName (bağlantıadı) Bağlantının adı String
connectionUrl Bağlantının URL'si String
oboUser Bağlantı için kullanıcı String
türü Olay yönetim sistemi türü String

KnowledgeGraphConfiguration

İsim Açıklama Değer
kimlik Bilgi grafiğine erişmek için kullanılan kimlik String
managedResources Ajan tarafından yönetilen kaynaklar listesi string[]

Günlük Yapılandırması

İsim Açıklama Değer
applicationInsightsConfiguration Application Insights Configuration ApplicationInsightsConfiguration

ManagedServiceIdentity

İsim Açıklama Değer
türü Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
userAssignedIdentities Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

İsim Açıklama Değer

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentity

İsim Açıklama Değer

ARM şablonu kaynak tanımı

Ajanların kaynak türü, aşağıdaki hedeflerle konuşlandırılabilir:

Kullanım Örnekleri

Kaynak biçimi

Microsoft.App/agents bir kaynak oluşturmak için aşağıdaki JSON'u şablonunuza ekleyin.

{
  "type": "Microsoft.App/agents",
  "apiVersion": "2026-01-01",
  "name": "string",
  "identity": {
    "type": "string",
    "userAssignedIdentities": {
      "{customized property}": {
      }
    }
  },
  "location": "string",
  "properties": {
    "actionConfiguration": {
      "accessLevel": "string",
      "identity": "string",
      "mode": "string"
    },
    "agentIdentity": {
      "initialSponsorGroupId": "string"
    },
    "agentSpaceId": "string",
    "defaultModel": {
      "name": "string",
      "provider": "string"
    },
    "incidentManagementConfiguration": {
      "connectionKey": "string",
      "connectionName": "string",
      "connectionUrl": "string",
      "oboUser": "string",
      "type": "string"
    },
    "knowledgeGraphConfiguration": {
      "identity": "string",
      "managedResources": [ "string" ]
    },
    "logConfiguration": {
      "applicationInsightsConfiguration": {
        "appId": "string",
        "connectionString": "string"
      }
    },
    "upgradeChannel": "string"
  },
  "tags": {
    "{customized property}": "string"
  }
}

Özellik Değerleri

Microsoft.App/agents

İsim Açıklama Değer
apiVersion API sürümü '2026-01-01'
kimlik Bu kaynağa atanan yönetilen hizmet kimlikleri. ManagedServiceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı string

Constraints:
Desen = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (gerekli)
properties Bu kaynağın kaynağa özgü özellikleri. Ajan Özellikleri
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü. Bkz. şablonlardaki Etiketleri
türü Kaynak türü 'Microsoft.App/agents'

ActionConfiguration

İsim Açıklama Değer
erişim düzeyi Eylemin erişim seviyesi 'High'
'Low'
kimlik Eylemin kullandığı kimlik String
modu Eylem şekli 'Özerk'
'Salt Okunur'
'İnceleme'

AjanIdentity

İsim Açıklama Değer
initialSponsorGroupId İlk sponsor grup kimliği (temsilci kimliği için gereklidir) dize (gerekli)

Ajan Özellikleri

İsim Açıklama Değer
actionConfiguration Eylem için yapılandırma ActionConfiguration
ajanIdentity Kaynaklara erişim için ajan kimliği yapılandırması AjanIdentity
agentSpaceId Ajan tarafından referans verilen ajan uzay kimliği String
defaultModel Ajan için varsayılan yapay zeka model yapılandırması DefaultModel
incidentManagementConfiguration Olay yönetimi yapılandırmaları IncidentManagementConfiguration
knowledgeGraphConfiguration Ajan için bilgi grafiği yapılandırması KnowledgeGraphConfiguration
logConfiguration Log yapılandırmaları LogConfiguration
upgradeChannel Ajanın yükseltme kanalı 'Preview'
'Stable'

ApplicationInsightsConfiguration

İsim Açıklama Değer
appId (uygulama kimliği) Application Insights kaynağı için Uygulama Kimliği String
connectionString Application Insights kaynağı için bağlantı dizisi string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.

DefaultModel

İsim Açıklama Değer
isim Model adı (örneğin, gpt-5, claude-opus-4-5, claude-sonnet-4-5) String
provider Yapay zeka sağlayıcı adı (örneğin, MicrosoftFoundry, Anthropic) String

IncidentManagementConfiguration

İsim Açıklama Değer
bağlantıAnahtarı Bağlantının anahtarı string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
connectionName (bağlantıadı) Bağlantının adı String
connectionUrl Bağlantının URL'si String
oboUser Bağlantı için kullanıcı String
türü Olay yönetim sistemi türü String

KnowledgeGraphConfiguration

İsim Açıklama Değer
kimlik Bilgi grafiğine erişmek için kullanılan kimlik String
managedResources Ajan tarafından yönetilen kaynaklar listesi string[]

Günlük Yapılandırması

İsim Açıklama Değer
applicationInsightsConfiguration Application Insights Configuration ApplicationInsightsConfiguration

ManagedServiceIdentity

İsim Açıklama Değer
türü Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
userAssignedIdentities Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

İsim Açıklama Değer

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentity

İsim Açıklama Değer

Terraform (AzAPI sağlayıcısı) kaynak tanımı

Ajanların kaynak türü, aşağıdaki hedeflerle konuşlandırılabilir:

Kaynak biçimi

Microsoft.App/agents bir kaynak oluşturmak için aşağıdaki Terraform'u şablonunuza ekleyin.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.App/agents@2026-01-01"
  name = "string"
  parent_id = "string"
  identity {
    type = "string"
    identity_ids = [
      "string"
    ]
  }
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      actionConfiguration = {
        accessLevel = "string"
        identity = "string"
        mode = "string"
      }
      agentIdentity = {
        initialSponsorGroupId = "string"
      }
      agentSpaceId = "string"
      defaultModel = {
        name = "string"
        provider = "string"
      }
      incidentManagementConfiguration = {
        connectionKey = "string"
        connectionName = "string"
        connectionUrl = "string"
        oboUser = "string"
        type = "string"
      }
      knowledgeGraphConfiguration = {
        identity = "string"
        managedResources = [
          "string"
        ]
      }
      logConfiguration = {
        applicationInsightsConfiguration = {
          appId = "string"
          connectionString = "string"
        }
      }
      upgradeChannel = "string"
    }
  }
}

Özellik Değerleri

Microsoft.App/agents

İsim Açıklama Değer
kimlik Bu kaynağa atanan yönetilen hizmet kimlikleri. ManagedServiceIdentity
location Kaynağın bulunduğu coğrafi konum dize (gerekli)
isim Kaynak adı string

Constraints:
Desen = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (gerekli)
properties Bu kaynağın kaynağa özgü özellikleri. Ajan Özellikleri
tags Kaynak etiketleri Etiket adları ve değerleri sözlüğü.
türü Kaynak türü "Microsoft.App/agents@2026-01-01"

ActionConfiguration

İsim Açıklama Değer
erişim düzeyi Eylemin erişim seviyesi 'High'
'Low'
kimlik Eylemin kullandığı kimlik String
modu Eylem şekli 'Özerk'
'Salt Okunur'
'İnceleme'

AjanIdentity

İsim Açıklama Değer
initialSponsorGroupId İlk sponsor grup kimliği (temsilci kimliği için gereklidir) dize (gerekli)

Ajan Özellikleri

İsim Açıklama Değer
actionConfiguration Eylem için yapılandırma ActionConfiguration
ajanIdentity Kaynaklara erişim için ajan kimliği yapılandırması AjanIdentity
agentSpaceId Ajan tarafından referans verilen ajan uzay kimliği String
defaultModel Ajan için varsayılan yapay zeka model yapılandırması DefaultModel
incidentManagementConfiguration Olay yönetimi yapılandırmaları IncidentManagementConfiguration
knowledgeGraphConfiguration Ajan için bilgi grafiği yapılandırması KnowledgeGraphConfiguration
logConfiguration Log yapılandırmaları LogConfiguration
upgradeChannel Ajanın yükseltme kanalı 'Preview'
'Stable'

ApplicationInsightsConfiguration

İsim Açıklama Değer
appId (uygulama kimliği) Application Insights kaynağı için Uygulama Kimliği String
connectionString Application Insights kaynağı için bağlantı dizisi string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.

DefaultModel

İsim Açıklama Değer
isim Model adı (örneğin, gpt-5, claude-opus-4-5, claude-sonnet-4-5) String
provider Yapay zeka sağlayıcı adı (örneğin, MicrosoftFoundry, Anthropic) String

IncidentManagementConfiguration

İsim Açıklama Değer
bağlantıAnahtarı Bağlantının anahtarı string

Constraints:
Hassas değer. Güvenli parametre olarak geçirin.
connectionName (bağlantıadı) Bağlantının adı String
connectionUrl Bağlantının URL'si String
oboUser Bağlantı için kullanıcı String
türü Olay yönetim sistemi türü String

KnowledgeGraphConfiguration

İsim Açıklama Değer
kimlik Bilgi grafiğine erişmek için kullanılan kimlik String
managedResources Ajan tarafından yönetilen kaynaklar listesi string[]

Günlük Yapılandırması

İsim Açıklama Değer
applicationInsightsConfiguration Application Insights Configuration ApplicationInsightsConfiguration

ManagedServiceIdentity

İsim Açıklama Değer
türü Yönetilen hizmet kimliği türü (hem SystemAssigned hem de UserAssigned türlerine izin verilir). 'Hiçbiri'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned' (gerekli)
userAssignedIdentities Kaynakla ilişkili kullanıcı tarafından atanan kimlik kümesi. userAssignedIdentities sözlük anahtarları şu formda ARM kaynak kimlikleri olacaktır: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Sözlük değerleri, isteklerdeki boş nesneler ({}) olabilir. ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

İsim Açıklama Değer

TrackedResourceTags

İsim Açıklama Değer

UserAssignedIdentity

İsim Açıklama Değer