Microsoft.App agenti

Definizione di risorsa Bicep

Il tipo di risorsa dell'agente può essere dispiegato con operazioni che prendono di mira:

Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/agents, aggiungi il seguente Bicep al tuo modello.

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'
  }
}

Valori delle proprietà

Microsoft.App/agents

Nome	Descrizione	Valore
autenticazione	Identità del servizio gestito assegnate a questa risorsa.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	string Vincoli: Pattern = `^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$` (obbligatorio)
proprietà	Proprietà specifiche della risorsa.	Proprietà dell'agente
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedi tag nei template

ActionConfiguration

Nome	Descrizione	Valore
accessLevel	Il livello di accesso dell'azione	'High' 'Low'
autenticazione	L'identità usata dall'azione	string
mode	La modalità d'azione	'Autonomo' 'ReadOnly' 'Recensione'

AgentIdentity

Nome	Descrizione	Valore
initialSponsorGroupId	ID iniziale del gruppo sponsor (richiesto per l'identità dell'agente)	stringa (obbligatorio)

Proprietà dell'agente

Nome	Descrizione	Valore
actionConfiguration	Configurazione per l'azione	ActionConfiguration
agentIdentità	Configurazione dell'identità dell'agente per accedere alle risorse	AgentIdentity
agentSpaceId	L'ID dello spazio dell'agente a cui si fa riferimento l'agente	string
Modello predefinito	Configurazione predefinita del modello AI per l'agente	Modello Predefinito
incidentManagementConfigurazione	Configurazioni di gestione degli incidenti	ConfigurazioneGestione degli Incidenti
knowledgeGraphConfiguration	Configurazione del grafo della conoscenza per l'agente	KnowledgeGraphConfiguration
Configurazione del registro	Configurazioni dei log	Configurazione registro
upgradeChannel	Il canale di aggiornamento dell'agente	'Preview' 'Stable'

ApplicationInsightsConfiguration

Nome	Descrizione	Valore
ID dell'app	L'ID dell'applicazione per la risorsa Application Insights	string
stringa di connessione	La stringa di connessione per la risorsa Application Insights	string Vincoli: Valore sensibile. Passare come parametro sicuro.

Modello Predefinito

Nome	Descrizione	Valore
nome	Nome modello (ad esempio, gpt-5, claude-opus-4-5, claude-sonetto-4-5)	string
provider	Nome del fornitore di IA (ad esempio, MicrosoftFoundry, Anthropic)	string

ConfigurazioneGestione degli Incidenti

Nome	Descrizione	Valore
connessione Chiave	La chiave per la connessione	string Vincoli: Valore sensibile. Passare come parametro sicuro.
connectionName	Il nome della connessione	string
connectionUrl	L'URL della connessione	string
oboUser	L'utente per la connessione	string
tipo	Il tipo di sistema di gestione degli incidenti	string

KnowledgeGraphConfiguration

Nome	Descrizione	Valore
autenticazione	L'identità utilizzata per accedere al grafo della conoscenza	string
managedResources	L'elenco delle risorse gestite dall'agente	string[]

Configurazione registro

Nome	Descrizione	Valore
applicationInsightsConfiguration	Configurazione di Application Insights	ApplicationInsightsConfiguration

ManagedServiceIdentity

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
identità assegnate dall'utente	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentity

Nome	Descrizione	Valore

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa dell'agente può essere dispiegato con operazioni che prendono di mira:

Resource groups - Vedi resource group

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/agents, aggiungi il seguente JSON al tuo template.

{
  "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"
  }
}

Valori delle proprietà

Microsoft.App/agents

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'2026-01-01'
autenticazione	Identità del servizio gestito assegnate a questa risorsa.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	string Vincoli: Pattern = `^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$` (obbligatorio)
proprietà	Proprietà specifiche della risorsa.	Proprietà dell'agente
tags	Tag delle risorse	Dizionario di nomi e valori di tag. Vedi tag nei template
tipo	Tipo di risorsa	'Microsoft.App/agents'

ActionConfiguration

Nome	Descrizione	Valore
accessLevel	Il livello di accesso dell'azione	'High' 'Low'
autenticazione	L'identità usata dall'azione	string
mode	La modalità d'azione	'Autonomo' 'ReadOnly' 'Recensione'

AgentIdentity

Nome	Descrizione	Valore
initialSponsorGroupId	ID iniziale del gruppo sponsor (richiesto per l'identità dell'agente)	stringa (obbligatorio)

Proprietà dell'agente

Nome	Descrizione	Valore
actionConfiguration	Configurazione per l'azione	ActionConfiguration
agentIdentità	Configurazione dell'identità dell'agente per accedere alle risorse	AgentIdentity
agentSpaceId	L'ID dello spazio dell'agente a cui si fa riferimento l'agente	string
Modello predefinito	Configurazione predefinita del modello AI per l'agente	Modello Predefinito
incidentManagementConfigurazione	Configurazioni di gestione degli incidenti	ConfigurazioneGestione degli Incidenti
knowledgeGraphConfiguration	Configurazione del grafo della conoscenza per l'agente	KnowledgeGraphConfiguration
Configurazione del registro	Configurazioni dei log	Configurazione registro
upgradeChannel	Il canale di aggiornamento dell'agente	'Preview' 'Stable'

ApplicationInsightsConfiguration

Nome	Descrizione	Valore
ID dell'app	L'ID dell'applicazione per la risorsa Application Insights	string
stringa di connessione	La stringa di connessione per la risorsa Application Insights	string Vincoli: Valore sensibile. Passare come parametro sicuro.

Modello Predefinito

Nome	Descrizione	Valore
nome	Nome modello (ad esempio, gpt-5, claude-opus-4-5, claude-sonetto-4-5)	string
provider	Nome del fornitore di IA (ad esempio, MicrosoftFoundry, Anthropic)	string

ConfigurazioneGestione degli Incidenti

Nome	Descrizione	Valore
connessione Chiave	La chiave per la connessione	string Vincoli: Valore sensibile. Passare come parametro sicuro.
connectionName	Il nome della connessione	string
connectionUrl	L'URL della connessione	string
oboUser	L'utente per la connessione	string
tipo	Il tipo di sistema di gestione degli incidenti	string

KnowledgeGraphConfiguration

Nome	Descrizione	Valore
autenticazione	L'identità utilizzata per accedere al grafo della conoscenza	string
managedResources	L'elenco delle risorse gestite dall'agente	string[]

Configurazione registro

Nome	Descrizione	Valore
applicationInsightsConfiguration	Configurazione di Application Insights	ApplicationInsightsConfiguration

ManagedServiceIdentity

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
identità assegnate dall'utente	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentity

Nome	Descrizione	Valore

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa dell'agente può essere dispiegato con operazioni che prendono di mira:

Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.App/agents, aggiungi il seguente Terraform al tuo template.

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"
    }
  }
}

Valori delle proprietà

Microsoft.App/agents

Nome	Descrizione	Valore
autenticazione	Identità del servizio gestito assegnate a questa risorsa.	ManagedServiceIdentity
ubicazione	Posizione geografica in cui risiede la risorsa	stringa (obbligatorio)
nome	Nome della risorsa	string Vincoli: Pattern = `^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$` (obbligatorio)
proprietà	Proprietà specifiche della risorsa.	Proprietà dell'agente
tags	Tag delle risorse	Dizionario di nomi e valori di tag.
tipo	Tipo di risorsa	"Microsoft.App/agents@2026-01-01"

ActionConfiguration

Nome	Descrizione	Valore
accessLevel	Il livello di accesso dell'azione	'High' 'Low'
autenticazione	L'identità usata dall'azione	string
mode	La modalità d'azione	'Autonomo' 'ReadOnly' 'Recensione'

AgentIdentity

Nome	Descrizione	Valore
initialSponsorGroupId	ID iniziale del gruppo sponsor (richiesto per l'identità dell'agente)	stringa (obbligatorio)

Proprietà dell'agente

Nome	Descrizione	Valore
actionConfiguration	Configurazione per l'azione	ActionConfiguration
agentIdentità	Configurazione dell'identità dell'agente per accedere alle risorse	AgentIdentity
agentSpaceId	L'ID dello spazio dell'agente a cui si fa riferimento l'agente	string
Modello predefinito	Configurazione predefinita del modello AI per l'agente	Modello Predefinito
incidentManagementConfigurazione	Configurazioni di gestione degli incidenti	ConfigurazioneGestione degli Incidenti
knowledgeGraphConfiguration	Configurazione del grafo della conoscenza per l'agente	KnowledgeGraphConfiguration
Configurazione del registro	Configurazioni dei log	Configurazione registro
upgradeChannel	Il canale di aggiornamento dell'agente	'Preview' 'Stable'

ApplicationInsightsConfiguration

Nome	Descrizione	Valore
ID dell'app	L'ID dell'applicazione per la risorsa Application Insights	string
stringa di connessione	La stringa di connessione per la risorsa Application Insights	string Vincoli: Valore sensibile. Passare come parametro sicuro.

Modello Predefinito

Nome	Descrizione	Valore
nome	Nome modello (ad esempio, gpt-5, claude-opus-4-5, claude-sonetto-4-5)	string
provider	Nome del fornitore di IA (ad esempio, MicrosoftFoundry, Anthropic)	string

ConfigurazioneGestione degli Incidenti

Nome	Descrizione	Valore
connessione Chiave	La chiave per la connessione	string Vincoli: Valore sensibile. Passare come parametro sicuro.
connectionName	Il nome della connessione	string
connectionUrl	L'URL della connessione	string
oboUser	L'utente per la connessione	string
tipo	Il tipo di sistema di gestione degli incidenti	string

KnowledgeGraphConfiguration

Nome	Descrizione	Valore
autenticazione	L'identità utilizzata per accedere al grafo della conoscenza	string
managedResources	L'elenco delle risorse gestite dall'agente	string[]

Configurazione registro

Nome	Descrizione	Valore
applicationInsightsConfiguration	Configurazione di Application Insights	ApplicationInsightsConfiguration

ManagedServiceIdentity

Nome	Descrizione	Valore
tipo	Tipo di identità del servizio gestito (in cui sono consentiti sia i tipi SystemAssigned che UserAssigned).	'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' (obbligatorio)
identità assegnate dall'utente	Set di identità assegnate dall'utente associate alla risorsa. Le chiavi del dizionario userAssignedIdentities saranno ID risorsa ARM nel formato : '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. I valori del dizionario possono essere oggetti vuoti ({}) nelle richieste.	ManagedServiceIdentityUserAssignedIdentities

ManagedServiceIdentityUserAssignedIdentities

Nome	Descrizione	Valore

TrackedResourceTags

Nome	Descrizione	Valore

UserAssignedIdentity

Nome	Descrizione	Valore

Commenti e suggerimenti

Questa pagina è stata utile?

Last updated on 2026-04-06

Condividi tramite

Microsoft.App agenti

Definizione di risorsa Bicep

Formato risorsa

Valori delle proprietà

Microsoft.App/agents

ActionConfiguration

AgentIdentity

Proprietà dell'agente

ApplicationInsightsConfiguration

Modello Predefinito

ConfigurazioneGestione degli Incidenti

KnowledgeGraphConfiguration

Configurazione registro

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

TrackedResourceTags

UserAssignedIdentity

Definizione di risorsa del modello di Resource Manager

Formato risorsa

Valori delle proprietà

Microsoft.App/agents

ActionConfiguration

AgentIdentity

Proprietà dell'agente

ApplicationInsightsConfiguration

Modello Predefinito

ConfigurazioneGestione degli Incidenti

KnowledgeGraphConfiguration

Configurazione registro

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

TrackedResourceTags

UserAssignedIdentity

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Formato risorsa

Valori delle proprietà

Microsoft.App/agents

ActionConfiguration

AgentIdentity

Proprietà dell'agente

ApplicationInsightsConfiguration

Modello Predefinito

ConfigurazioneGestione degli Incidenti

KnowledgeGraphConfiguration

Configurazione registro

ManagedServiceIdentity

ManagedServiceIdentityUserAssignedIdentities

TrackedResourceTags

UserAssignedIdentity

Commenti e suggerimenti

Risorse aggiuntive