Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Bicep-Ressourcendefinition
Der Ressourcentyp des Agenten kann mit Operationen eingesetzt werden, die gezielt auf folgende Ziele abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.App/agents Ressource zu erstellen, fügen Sie den folgenden Bizeps Ihrer Vorlage hinzu.
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'
}
}
Eigenschaftswerte
Microsoft.App/agents
| Name | Beschreibung | Wert |
|---|---|---|
| identity | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
| location | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Constraints: Pattern = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (erforderlich) |
| properties | Die ressourcenspezifischen Eigenschaften für diese Ressource. | Agent-Eigenschaften |
| Schlagwörter | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
ActionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accessLevel | Die Zugangsstufe der Aktion | "Hoch" "Niedrig" |
| identity | Die von der Aktion verwendete Identität | Schnur |
| mode | Die Wirkungsweise | "Autonom" 'ReadOnly' 'Rezension' |
AgentIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| initialSponsorGroupId | Erste Sponsor-Gruppen-ID (erforderlich für die Agentenidentität) | Zeichenfolge (erforderlich) |
Agent-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| actionConfiguration | Konfiguration für die Aktion | ActionConfiguration |
| agentIdentity | Agent-Identitätskonfiguration für den Zugriff auf Ressourcen | AgentIdentity |
| agentSpaceId | Die vom Agent referenzierte Agentenraum-ID | Schnur |
| defaultModel | Standard-KI-Modellkonfiguration für den Agenten | DefaultModel |
| incidentManagementKonfiguration | Vorfallmanagement-Konfigurationen | IncidentManagementKonfiguration |
| knowledgeGraphConfiguration | Knowledge Graph-Konfiguration für den Agenten | KnowledgeGraphConfiguration |
| logKonfiguration | Log-Konfigurationen | LogConfiguration- |
| upgradeChannel | Der Upgrade-Kanal des Agenten | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Anwendungs-ID | Die Anwendungs-ID für die Application Insights-Ressource | Schnur |
| connectionString | Die Verbindungskette für die Application Insights-Ressource | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
DefaultModel
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Modellname (z. B. gpt-5, claude-opus-4-5, claude-sonnett-4-5) | Schnur |
| provider | KI-Anbietername (z. B. MicrosoftFoundry, Anthropic) | Schnur |
IncidentManagementKonfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| connectionKey | Der Schlüssel zur Verbindung | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| Verbindungsname | Der Name der Verbindung | Schnur |
| connectionUrl | Die URL der Verbindung | Schnur |
| oboUser | Der Benutzer für die Verbindung | Schnur |
| Typ | Die Art des Vorfallmanagementsystems | Schnur |
KnowledgeGraphConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| identity | Die Identität, mit der auf den Knowledge Graph zugegriffen wird | Schnur |
| managedResources | Die Liste der vom Agenten verwalteten Ressourcen | string[] |
LogConfiguration (Protokollkonfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| applicationInsightsConfiguration | Anwendungs-Insights-Konfiguration | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Typ | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | ManagedServiceIdentityUserAssignedIdentities- |
ManagedServiceIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
ARM-Vorlagenressourcendefinition
Der Ressourcentyp des Agenten kann mit Operationen eingesetzt werden, die gezielt auf folgende Ziele abzielen:
- Ressourcengruppen – Siehe Ressourcengruppenbereitstellungsbefehle
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.App/agents Ressource zu erstellen, fügen Sie das folgende JSON Ihrer Vorlage hinzu.
{
"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"
}
}
Eigenschaftswerte
Microsoft.App/agents
| Name | Beschreibung | Wert |
|---|---|---|
| apiVersion | Die API-Version | '2026-01-01' |
| identity | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
| location | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Constraints: Pattern = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (erforderlich) |
| properties | Die ressourcenspezifischen Eigenschaften für diese Ressource. | Agent-Eigenschaften |
| Schlagwörter | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. Siehe Tags in Vorlagen |
| Typ | Der Ressourcentyp | 'Microsoft.App/agents' |
ActionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accessLevel | Die Zugangsstufe der Aktion | "Hoch" "Niedrig" |
| identity | Die von der Aktion verwendete Identität | Schnur |
| mode | Die Wirkungsweise | "Autonom" 'ReadOnly' 'Rezension' |
AgentIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| initialSponsorGroupId | Erste Sponsor-Gruppen-ID (erforderlich für die Agentenidentität) | Zeichenfolge (erforderlich) |
Agent-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| actionConfiguration | Konfiguration für die Aktion | ActionConfiguration |
| agentIdentity | Agent-Identitätskonfiguration für den Zugriff auf Ressourcen | AgentIdentity |
| agentSpaceId | Die vom Agent referenzierte Agentenraum-ID | Schnur |
| defaultModel | Standard-KI-Modellkonfiguration für den Agenten | DefaultModel |
| incidentManagementKonfiguration | Vorfallmanagement-Konfigurationen | IncidentManagementKonfiguration |
| knowledgeGraphConfiguration | Knowledge Graph-Konfiguration für den Agenten | KnowledgeGraphConfiguration |
| logKonfiguration | Log-Konfigurationen | LogConfiguration- |
| upgradeChannel | Der Upgrade-Kanal des Agenten | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Anwendungs-ID | Die Anwendungs-ID für die Application Insights-Ressource | Schnur |
| connectionString | Die Verbindungskette für die Application Insights-Ressource | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
DefaultModel
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Modellname (z. B. gpt-5, claude-opus-4-5, claude-sonnett-4-5) | Schnur |
| provider | KI-Anbietername (z. B. MicrosoftFoundry, Anthropic) | Schnur |
IncidentManagementKonfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| connectionKey | Der Schlüssel zur Verbindung | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| Verbindungsname | Der Name der Verbindung | Schnur |
| connectionUrl | Die URL der Verbindung | Schnur |
| oboUser | Der Benutzer für die Verbindung | Schnur |
| Typ | Die Art des Vorfallmanagementsystems | Schnur |
KnowledgeGraphConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| identity | Die Identität, mit der auf den Knowledge Graph zugegriffen wird | Schnur |
| managedResources | Die Liste der vom Agenten verwalteten Ressourcen | string[] |
LogConfiguration (Protokollkonfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| applicationInsightsConfiguration | Anwendungs-Insights-Konfiguration | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Typ | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | ManagedServiceIdentityUserAssignedIdentities- |
ManagedServiceIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|
Verwendungsbeispiele
Terraform -Ressourcendefinition (AzAPI-Anbieter)
Der Ressourcentyp des Agenten kann mit Operationen eingesetzt werden, die gezielt auf folgende Ziele abzielen:
- Ressourcengruppen
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.
Ressourcenformat
Um eine Microsoft.App/agents Ressource zu erstellen, fügen Sie das folgende Terraform Ihrer Vorlage hinzu.
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"
}
}
}
Eigenschaftswerte
Microsoft.App/agents
| Name | Beschreibung | Wert |
|---|---|---|
| identity | Die verwalteten Dienstidentitäten, die dieser Ressource zugewiesen sind. | ManagedServiceIdentity- |
| location | Der geografische Standort, an dem sich die Ressource befindet | Zeichenfolge (erforderlich) |
| Name | Der Ressourcenname | string Constraints: Pattern = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (erforderlich) |
| properties | Die ressourcenspezifischen Eigenschaften für diese Ressource. | Agent-Eigenschaften |
| Schlagwörter | Ressourcenetiketten | Wörterbuch der Tagnamen und -werte. |
| Typ | Der Ressourcentyp | "Microsoft.App/agents@2026-01-01" |
ActionConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| accessLevel | Die Zugangsstufe der Aktion | "Hoch" "Niedrig" |
| identity | Die von der Aktion verwendete Identität | Schnur |
| mode | Die Wirkungsweise | "Autonom" 'ReadOnly' 'Rezension' |
AgentIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| initialSponsorGroupId | Erste Sponsor-Gruppen-ID (erforderlich für die Agentenidentität) | Zeichenfolge (erforderlich) |
Agent-Eigenschaften
| Name | Beschreibung | Wert |
|---|---|---|
| actionConfiguration | Konfiguration für die Aktion | ActionConfiguration |
| agentIdentity | Agent-Identitätskonfiguration für den Zugriff auf Ressourcen | AgentIdentity |
| agentSpaceId | Die vom Agent referenzierte Agentenraum-ID | Schnur |
| defaultModel | Standard-KI-Modellkonfiguration für den Agenten | DefaultModel |
| incidentManagementKonfiguration | Vorfallmanagement-Konfigurationen | IncidentManagementKonfiguration |
| knowledgeGraphConfiguration | Knowledge Graph-Konfiguration für den Agenten | KnowledgeGraphConfiguration |
| logKonfiguration | Log-Konfigurationen | LogConfiguration- |
| upgradeChannel | Der Upgrade-Kanal des Agenten | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| Anwendungs-ID | Die Anwendungs-ID für die Application Insights-Ressource | Schnur |
| connectionString | Die Verbindungskette für die Application Insights-Ressource | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
DefaultModel
| Name | Beschreibung | Wert |
|---|---|---|
| Name | Modellname (z. B. gpt-5, claude-opus-4-5, claude-sonnett-4-5) | Schnur |
| provider | KI-Anbietername (z. B. MicrosoftFoundry, Anthropic) | Schnur |
IncidentManagementKonfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| connectionKey | Der Schlüssel zur Verbindung | string Constraints: Vertraulicher Wert. Übergeben Als sicherer Parameter. |
| Verbindungsname | Der Name der Verbindung | Schnur |
| connectionUrl | Die URL der Verbindung | Schnur |
| oboUser | Der Benutzer für die Verbindung | Schnur |
| Typ | Die Art des Vorfallmanagementsystems | Schnur |
KnowledgeGraphConfiguration
| Name | Beschreibung | Wert |
|---|---|---|
| identity | Die Identität, mit der auf den Knowledge Graph zugegriffen wird | Schnur |
| managedResources | Die Liste der vom Agenten verwalteten Ressourcen | string[] |
LogConfiguration (Protokollkonfiguration)
| Name | Beschreibung | Wert |
|---|---|---|
| applicationInsightsConfiguration | Anwendungs-Insights-Konfiguration | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Name | Beschreibung | Wert |
|---|---|---|
| Typ | Typ der verwalteten Dienstidentität (wobei systemAssigned- und UserAssigned-Typen zulässig sind). | 'None' 'SystemZugewiesen' "SystemAssigned,UserAssigned" "UserAssigned" (erforderlich) |
| userAssignedIdentities | Die Gruppe der benutzerzuweisungen Identitäten, die der Ressource zugeordnet sind. Die Wörterbuchschlüssel "userAssignedIdentities" sind ARM-Ressourcen-IDs im Formular: '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Die Wörterbuchwerte können leere Objekte ({}) in Anforderungen sein. | ManagedServiceIdentityUserAssignedIdentities- |
ManagedServiceIdentityUserAssignedIdentities
| Name | Beschreibung | Wert |
|---|
Verfolgte ResourceTags
| Name | Beschreibung | Wert |
|---|
UserAssignedIdentity
| Name | Beschreibung | Wert |
|---|