Not
Bu sayfaya erişim yetkilendirme gerektiriyor. Oturum açmayı veya dizinleri değiştirmeyi deneyebilirsiniz.
Bu sayfaya erişim yetkilendirme gerektiriyor. Dizinleri değiştirmeyi deneyebilirsiniz.
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:
- Kaynak grupları - Kaynak grubu dağıtım komutlarına bakınız Her API sürümünde değişen özelliklerin listesi için değişiklik günlüğüne bakınız.
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 grupları Her API sürümünde değişen ö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 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 |
|---|