Notatka
Dostęp do tej strony wymaga autoryzacji. Może spróbować zalogować się lub zmienić katalogi.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
Definicja zasobu Bicep
Typ zasobu agenta może być wdrażany z operacjami skierowanymi na:
- grupy zasobów — zobacz polecenia wdrażania grupy zasobów
Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.
Format zasobu
Aby stworzyć Microsoft.App/agents zasób, dodaj do szablonu następujący Biceps.
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'
}
}
Wartości właściwości
Microsoft.App/agents
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamości usługi zarządzanej przypisane do tego zasobu. | ManagedServiceIdentity (tożsamość usługi) |
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| nazwa | Nazwa zasobu | string Constraints: Wzorzec = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (wymagane) |
| properties | Właściwości specyficzne dla zasobu dla tego zasobu. | AgentProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
ActionConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| accessLevel (poziom dostępu) | Poziom dostępu do akcji | 'High' 'Low' |
| tożsamość | Tożsamość użyta przez działanie | ciąg |
| tryb | Tryb działania | "Autonomiczny" 'ReadOnly' 'Recenzja' |
AgentIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| initialSponsorGroupId | Początkowy identyfikator grupy sponsora (wymagany do identyfikacji agenta) | ciąg (wymagany) |
AgentProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| actionConfiguration | Konfiguracja działania | ActionConfiguration |
| agentIdentity | Konfiguracja tożsamości agenta do dostępu do zasobów | AgentIdentity |
| agentSpaceId | ID przestrzeni agenta odwołany przez agenta | ciąg |
| defaultModel | Domyślna konfiguracja modelu AI dla agenta | DefaultModel |
| Zarządzanie incydentamiKonfiguracja | Konfiguracje zarządzania incydentami | Konfiguracja zarządzania incydentami |
| knowledgeGraphConfiguration | Konfiguracja grafu wiedzy dla agenta | KnowledgeGraphConfiguration |
| logConfiguration (konfiguracja dziennika) | Konfiguracje logów | Konfiguracja dziennika |
| upgradeChannel | Kanał aktualizacji agenta | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Identyfikator aplikacji | Identyfikator aplikacji dla zasobu Application Insights | ciąg |
| Parametry połączenia | Ciąg połączeń dla zasobu Application Insights | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
DefaultModel
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa modelu (np. GPT-5, Claude-Opus-4-5, Claude-Sonet-4-5) | ciąg |
| dostawca | Nazwa dostawcy AI (np. MicrosoftFoundry, Anthropic) | ciąg |
Konfiguracja zarządzania incydentami
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionKey | Klucz do połączenia | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| connectionName (nazwa_połączenia) | Nazwa połączenia | ciąg |
| connectionUrl | URL połączenia | ciąg |
| oboUser | Użytkownik połączenia | ciąg |
| typ | Rodzaj systemu zarządzania incydentami | ciąg |
KnowledgeGraphConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość użyta do dostępu do grafu wiedzy | ciąg |
| managedResources | Lista zasobów zarządzanych przez agenta | string[] |
Konfiguracja dziennika
| Nazwa | Opis | Wartość |
|---|---|---|
| applicationInsightsConfiguration | Konfiguracja Application Insights | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (wymagane) |
| userAssignedIdentities | Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
UserAssignedIdentity
| Nazwa | Opis | Wartość |
|---|
Definicja zasobu szablonu usługi ARM
Typ zasobu agenta może być wdrażany z operacjami skierowanymi na:
- Grupy zasobów – Zobacz polecenia wdrożenia grup zasobów Aby uzyskać listę zmienionych właściwości w każdej wersji API, zobacz log zmian.
Przykłady użycia
Format zasobu
Aby stworzyć Microsoft.App/agents zasób, dodaj do szablonu następujący JSON.
{
"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"
}
}
Wartości właściwości
Microsoft.App/agents
| Nazwa | Opis | Wartość |
|---|---|---|
| apiVersion | Wersja interfejsu API | '2026-01-01' |
| tożsamość | Tożsamości usługi zarządzanej przypisane do tego zasobu. | ManagedServiceIdentity (tożsamość usługi) |
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| nazwa | Nazwa zasobu | string Constraints: Wzorzec = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (wymagane) |
| properties | Właściwości specyficzne dla zasobu dla tego zasobu. | AgentProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. Zobacz tagi w szablonach |
| typ | Typ zasobu | 'Microsoft.App/agents' |
ActionConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| accessLevel (poziom dostępu) | Poziom dostępu do akcji | 'High' 'Low' |
| tożsamość | Tożsamość użyta przez działanie | ciąg |
| tryb | Tryb działania | "Autonomiczny" 'ReadOnly' 'Recenzja' |
AgentIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| initialSponsorGroupId | Początkowy identyfikator grupy sponsora (wymagany do identyfikacji agenta) | ciąg (wymagany) |
AgentProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| actionConfiguration | Konfiguracja działania | ActionConfiguration |
| agentIdentity | Konfiguracja tożsamości agenta do dostępu do zasobów | AgentIdentity |
| agentSpaceId | ID przestrzeni agenta odwołany przez agenta | ciąg |
| defaultModel | Domyślna konfiguracja modelu AI dla agenta | DefaultModel |
| Zarządzanie incydentamiKonfiguracja | Konfiguracje zarządzania incydentami | Konfiguracja zarządzania incydentami |
| knowledgeGraphConfiguration | Konfiguracja grafu wiedzy dla agenta | KnowledgeGraphConfiguration |
| logConfiguration (konfiguracja dziennika) | Konfiguracje logów | Konfiguracja dziennika |
| upgradeChannel | Kanał aktualizacji agenta | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Identyfikator aplikacji | Identyfikator aplikacji dla zasobu Application Insights | ciąg |
| Parametry połączenia | Ciąg połączeń dla zasobu Application Insights | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
DefaultModel
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa modelu (np. GPT-5, Claude-Opus-4-5, Claude-Sonet-4-5) | ciąg |
| dostawca | Nazwa dostawcy AI (np. MicrosoftFoundry, Anthropic) | ciąg |
Konfiguracja zarządzania incydentami
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionKey | Klucz do połączenia | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| connectionName (nazwa_połączenia) | Nazwa połączenia | ciąg |
| connectionUrl | URL połączenia | ciąg |
| oboUser | Użytkownik połączenia | ciąg |
| typ | Rodzaj systemu zarządzania incydentami | ciąg |
KnowledgeGraphConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość użyta do dostępu do grafu wiedzy | ciąg |
| managedResources | Lista zasobów zarządzanych przez agenta | string[] |
Konfiguracja dziennika
| Nazwa | Opis | Wartość |
|---|---|---|
| applicationInsightsConfiguration | Konfiguracja Application Insights | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (wymagane) |
| userAssignedIdentities | Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
UserAssignedIdentity
| Nazwa | Opis | Wartość |
|---|
Definicja zasobu narzędzia Terraform (dostawcy AzAPI)
Typ zasobu agenta może być wdrażany z operacjami skierowanymi na:
- Grupy zasobów Listę zmienionych właściwości w każdej wersji API można znaleźć w dzienniku zmian.
Format zasobu
Aby stworzyć Microsoft.App/agents zasób, dodaj do szablonu następujący Terraform.
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"
}
}
}
Wartości właściwości
Microsoft.App/agents
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamości usługi zarządzanej przypisane do tego zasobu. | ManagedServiceIdentity (tożsamość usługi) |
| lokalizacja | Lokalizacja geograficzna, w której znajduje się zasób | ciąg (wymagany) |
| nazwa | Nazwa zasobu | string Constraints: Wzorzec = ^[A-Za-z]([-A-Za-z0-9]{0,30}[A-Za-z0-9])$ (wymagane) |
| properties | Właściwości specyficzne dla zasobu dla tego zasobu. | AgentProperties |
| tags | Tagi zasobów | Słownik nazw tagów i wartości. |
| typ | Typ zasobu | "Microsoft.App/agents@2026-01-01" |
ActionConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| accessLevel (poziom dostępu) | Poziom dostępu do akcji | 'High' 'Low' |
| tożsamość | Tożsamość użyta przez działanie | ciąg |
| tryb | Tryb działania | "Autonomiczny" 'ReadOnly' 'Recenzja' |
AgentIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| initialSponsorGroupId | Początkowy identyfikator grupy sponsora (wymagany do identyfikacji agenta) | ciąg (wymagany) |
AgentProperties
| Nazwa | Opis | Wartość |
|---|---|---|
| actionConfiguration | Konfiguracja działania | ActionConfiguration |
| agentIdentity | Konfiguracja tożsamości agenta do dostępu do zasobów | AgentIdentity |
| agentSpaceId | ID przestrzeni agenta odwołany przez agenta | ciąg |
| defaultModel | Domyślna konfiguracja modelu AI dla agenta | DefaultModel |
| Zarządzanie incydentamiKonfiguracja | Konfiguracje zarządzania incydentami | Konfiguracja zarządzania incydentami |
| knowledgeGraphConfiguration | Konfiguracja grafu wiedzy dla agenta | KnowledgeGraphConfiguration |
| logConfiguration (konfiguracja dziennika) | Konfiguracje logów | Konfiguracja dziennika |
| upgradeChannel | Kanał aktualizacji agenta | 'Preview' 'Stable' |
ApplicationInsightsConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| Identyfikator aplikacji | Identyfikator aplikacji dla zasobu Application Insights | ciąg |
| Parametry połączenia | Ciąg połączeń dla zasobu Application Insights | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
DefaultModel
| Nazwa | Opis | Wartość |
|---|---|---|
| nazwa | Nazwa modelu (np. GPT-5, Claude-Opus-4-5, Claude-Sonet-4-5) | ciąg |
| dostawca | Nazwa dostawcy AI (np. MicrosoftFoundry, Anthropic) | ciąg |
Konfiguracja zarządzania incydentami
| Nazwa | Opis | Wartość |
|---|---|---|
| connectionKey | Klucz do połączenia | string Constraints: Wartość wrażliwa. Przekaż jako bezpieczny parametr. |
| connectionName (nazwa_połączenia) | Nazwa połączenia | ciąg |
| connectionUrl | URL połączenia | ciąg |
| oboUser | Użytkownik połączenia | ciąg |
| typ | Rodzaj systemu zarządzania incydentami | ciąg |
KnowledgeGraphConfiguration
| Nazwa | Opis | Wartość |
|---|---|---|
| tożsamość | Tożsamość użyta do dostępu do grafu wiedzy | ciąg |
| managedResources | Lista zasobów zarządzanych przez agenta | string[] |
Konfiguracja dziennika
| Nazwa | Opis | Wartość |
|---|---|---|
| applicationInsightsConfiguration | Konfiguracja Application Insights | ApplicationInsightsConfiguration |
ManagedServiceIdentity
| Nazwa | Opis | Wartość |
|---|---|---|
| typ | Typ tożsamości usługi zarządzanej (gdzie dozwolone są typy SystemAssigned i UserAssigned). | 'None' 'SystemAssigned' "SystemAssigned,UserAssigned" "UserAssigned" (wymagane) |
| userAssignedIdentities | Zestaw tożsamości przypisanych przez użytkownika skojarzonych z zasobem. Klucze słownika userAssignedIdentities będą identyfikatorami zasobów usługi ARM w postaci: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ManagedIdentity/userAssignedIdentities/{identityName}. Wartości słownika mogą być pustymi obiektami ({}) w żądaniach. | ManagedServiceIdentityUserAssignedIdentities |
ManagedServiceIdentityUserAssignedIdentities
| Nazwa | Opis | Wartość |
|---|
TrackedResourceTags
| Nazwa | Opis | Wartość |
|---|
UserAssignedIdentity
| Nazwa | Opis | Wartość |
|---|