Microsoft Copilot Studios agentlager

Copilot Studio-agentlageret giver IT- og sikkerhedsadministratorer et centraliseret overblik over alle agenter, der er oprettet med Copilot Studio eller Agent Builder i lejeren. Lageret dækker både ikke-udgivne (kladde) og udgivne agenter. For hver agent viser lageret nøglemetadata, såsom hvem der har oprettet agenten, hvornår den sidst blev offentliggjort, hvilke kanaler den er implementeret på, hvordan den godkender brugere, dens funktioner og meget mere. Lagerdata opdateres automatisk, og ændringer af en agent vises typisk inden for 20 minutter.

Administratorer kan tilgå lagerdataene via flere metoder, herunder Power Platform Administration, Power Platform API'et og Azure Resource Graph. Se den komplette liste over adgangsmetoder og nødvendige roller i Power Platform-lager.

Denne artikel beskriver felterne, der er specifikke for Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-lageret. For delte felter, der er tilgængelige på alle ressourcetyper, kan du se Power Platform-lagerskemareference.

Bemærk!

Lageroversigten inkluderer ikke agenter oprettet med V1 af Copilot Studio (også kendt som "Klassiske bots" eller "Power Virtual Agents"). Du kan dog stadig gå til Power Platform Administration og vælge Administrer>Copilot Studio>Klassiske chatbots for at se disse agenter.

Vigtigt!

Denne artikel indeholder dokumentation til prøveversionen af Microsoft Copilot Studio. Der kan forekomme ændringer.

Prøveversionsfunktionerne er ikke beregnet til produktionsformål og kan have begrænset funktionalitet. Disse funktioner er tilgængelige før en officiel udgivelse, så du kan få tidlig adgang og give feedback.

Hvis du skal bygge en produktionsklar agent, kan du se Oversigt over Microsoft Copilot Studio.

Egenskaber for agent

Lageroversigten indeholder følgende egenskaber for hver agent.

Bemærk!

  • Lageret afspejler strukturen i den offentliggjorte version af hver agent. Hvis en agent har ændringer, der ikke er offentliggjorte (et nyere udkast), vises disse ændringer ikke i lageret, før agenten er offentliggjort.

  • Agentens konfiguration påvirker, hvilke felter der bliver udfyldt. Nogle egenskaber kan være null afhængigt af, hvordan agenten er indstillet. isManaged er f.eks. null for agenter oprettet i Agent Builder.

Grundlæggende egenskaber

API-feltsti Datatype Beskrivelse Eksempel Status
properties.displayName string Agentens viste navn. Customer support agent Generelt tilgængelig
properties.name GUID Agentens id i det specifikke Dataverse-miljø (CDS-bot-id). aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.createdAt dato/klokkeslæt Dato og klokkeslæt for oprettelse af agenten. 2024-12-13T04:00:00Z Generelt tilgængelig
properties.createdBy GUID Entra ID for den bruger, der oprettede agenten. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.ownerId string Objekt-id'et (Entra ID) for agentens nuværende ejer. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.environmentId string Id'et for Power Platform-miljøet, der indeholder ressourcen. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.lastPublishedAt dato/klokkeslæt Datoen og klokkeslættet for den seneste publicering af agenten. Tom/null, hvis agenten stadig er i kladdestadiet. 2026-01-15T10:30:00Z Generelt tilgængelig
properties.createdIn string Udviklingsværktøjet, hvor agenten blev oprettet: Copilot Studio eller Microsoft 365 Copilot Agent Builder. Copilot Studio Generelt tilgængelig
properties.schemaName string Dataverse-skemaets navn. Tilgængelig for Copilot Studio-agenter og Microsoft 365 Copilot Agent Builder-agenter. cr5e3_agentName Generelt tilgængelig
properties.isQuarantined boolean Om agenten i øjeblikket er i karantæne false Forhåndsversion
properties.quarantinedAt dato/klokkeslæt Den dato og det klokkeslæt, agenten sidst var i karantæne. 2026-02-01T08:00:00Z Forhåndsversion
properties.isManaged boolean Om agenten er en del af en administreret Dataverse-løsning. Null for agenter, der er oprettet i Agent Builder. false Forhåndsversion

Egenskaber for Entra-identitet

API-feltsti Datatype Beskrivelse Eksempel Status
properties.botId string CDS-bot-id'et i miljøet. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAppId string Entra-appregistrerings-id tilknyttet agenten, når det findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAgentId string Entra Agent Identity-id, hvis det findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAgentBlueprintId string Entra Agent Blueprint-id, hvis der findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig

Bemærk!

Ikke alle identitetsegenskaber er tilgængelige for alle agenttyper: entraAppId er en ældre identifikator, nyere agenter bruger entraAgentId og entraAgentBlueprintId. Disse felter udfyldes kun, når de gælder for den specifikke agent. Ingen af disse identitetsegenskaber gælder for Microsoft 365 Copilot Agent Builder-agenter.

Hvis du vil vide mere om Entra-identitetsbegreber, kan du se Appregistrering, agentidentiteter og godkendelse for Copilot Studio.

Konfigurationsegenskaber

API-feltsti Datatype Beskrivelse Eksempel Status
properties.orchestration string Agentens orkestreringstilstand (læs mere i Orkestreringstilstande). Generative Forhåndsversion
properties.model string AI-modellen, som agenten bruger. gpt-4o Forhåndsversion
properties.authentication string Den godkendelsestilstand, der er konfigureret for agenten (læs mere i Godkendelsestilstande). Microsoft Entra Forhåndsversion
properties.channels matrix De viste navne på de kanaler, som agenten publiceres til. ["Teams","SharePoint"] Forhåndsversion
properties.sharedWithViewers objekt Antal individuelle visningsbrugere (userCount) og visningsgrupper (groupCount), som agenten er delt med. Hvis en udvikler har delt agenten med hele lejeren, indstilles entireTenant til true, selvom en administrator ikke har godkendt delingen. "groupCount": 0, "userCount": 0, "entireTenant": false Forhåndsversion
properties.sharedWithEditors objekt Antal brugere med redigeringsadgang (userCount) og redigeringsgrupper (groupCount), som agenten deles med "groupCount": 0, "userCount": 0 Forhåndsversion
properties.capabilitiesCounts objekt Samlet adskilt antal for hver type konfigurerede egenskaber "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Forhåndsversion

Orkestreringstilstande

Feltet properties.orchestration accepterer følgende værdier:

Værdi Description
Klassisk Agenten bruger klassisk emnebaseret orkestrering med oprettede dialogtræer.
Generativ Agenten bruger generativ orkestrering, hvor en AI-model dynamisk vælger emner og handlinger.

Godkendelsestilstande

Feltet properties.authentication accepterer følgende værdier:

Værdi Description
None Ingen godkendelse kræves.
Microsoft Entra Godkendelse via Microsoft Entra ID.
Generic OAuth 2.0 Godkendelse via en generisk OAuth 2.0-udbyder.

Agentfunktioner

Dette afsnit viser agentens funktioner (værktøjer og viden). I øjeblikket vises kun detaljerede data om de connectorer, der bruges af agenten, samt videnskonfigurationen, som beskrevet i de følgende afsnit.

Lageret har en begrænsning på maksimalt 200 ressourcer af hver type pr. agent. Få mere at vide i Kendte begrænsninger.

Lageret fjerner automatisk dublerede ressourcer, såsom en Power Platform-connector, som du har konfigureret to gange i en agent med samme konfiguration.

Connectoregenskaber

Lageret indeholder en matrix kaldet powerPlatformConnectors, som indeholder de Power Platform-connectorer, der er konfigureret i en agent. Hver connector identificeres ved sin connectorId (en streng, der indeholder connectorens resource-id, for eksempel shared_excelonlinebusiness). For hver konfigureret connector er der en liste over konfigurerede operations. Listen indeholder følgende egenskaber:

Property Datatype Beskrivelse Status
OperationId string Id'et for den specifikke handling i connectoren,,, f.eks. AddRowV2 Forhåndsversion
createdBy GUID Den bruger, der konfigurerede handlingen Forhåndsversion
isEnabled boolean Om connectorhandlingen aktuelt er aktiveret Forhåndsversion
usedAs string Sådan bruges handlingen:
  • Tool, hvis konfigureret som et generelt værktøj
  • Topic Tool, hvis konfigureret som et værktøj inden for et specifikt emne
  • Knowledge, hvis connectoren er konfigureret som en videnskilde
 Forhåndsversion
requiresEndUserConsent boolean Om slutbrugerne skal give samtykke, før agenten kan bruge handlingen Forhåndsversion
whenCanBeUsed string Når handlingen kan aktiveres:
  • Anytime, hvis værktøjet er tilgængeligt for agenten uden begrænsninger
  • ViaDirectReferenceOnly, hvis agenten kun bruger værktøjet, når udvikleren eksplicit har konfigureret det i specifikke emner
  • Conditional, hvis agenten kan bruge værktøjet efter en foruddefineret logik af udvikleren
 Forhåndsversion
connectionProvider string Hvem leverer forbindelsen til handlingen:
  • User, hvis slutbrugeren leverer legitimationsoplysninger under kørsel
  • Maker, hvis udvikleren angiver forbindelsen ved oprettelsestidspunktet
 Forhåndsversion
connectionIdSharedByMaker GUID Forbindelses-id, kun udfyldt, når connectionProvider = Maker Forhåndsversion
Eksempel
{
  "type": "microsoft.copilotstudio/agents",
  "properties": {
    "displayName": "Customer Support Agent",
    "createdIn": "Copilot Studio",
    "powerPlatformConnectors": [
      {
        "connectorId": "shared_excelonlinebusiness",
        "operations": [
          {
            "operationId": "RunScriptProd",
            "usedAs": "Tool",
            "isEnabled": true,
            "requiresEndUserConsent": false,
            "whenCanBeUsed": "ViaDirectReferenceOnly",
            "connectionProvider": "Maker",
            "connectionIdSharedByMaker": "11112222-3333-4444-5555-666677778888",
            "createdBy": "52bff06b-5db5-42cd-9919-28f95e3c07af"
          }
        ]
      }
    ],
    "capabilitiesCounts": {
      "distinctPowerPlatformConnectors": 2,
      "distinctPowerPlatformConnectorsOperations": 3
    }
  }
}

Videnegenskaber

Lageret indeholder følgende egenskab for viden:

Property Datatype Beskrivelse Status
IsWebSearchEnabledForKnowledge boolean Sandt, hvis agenten kan bruge websøgning som videnskilde Forhåndsversion

Kendte begrænsninger

  • V1-agenter bliver ikke sporet - Agentoversigten inkluderer ikke agenter, der er oprettet med den originale Power Virtual Agents V1 runtime. Den sporer kun V2-agenter (Copilot Studio).
  • Identitetsegenskaber er muligvis ikke tilgængelige for alle agenter – Felterne entraAgentId og entraAgentBlueprintId udfyldes kun for agenter, der er klargjort med den nyere Entra-agentidentitetsmodel. Ældre agenter har måske kun entraAppId, og Microsoft 365 Copilot Agent Builder-agenter har ikke nogen af disse identitetsegenskaber.
  • Antal funktioner - Lageret har en begrænsning på maksimalt 200 ressourcer af hver type pr. agent. Hvis en agent har mere end 200 konfigurerede ressourcer fra en bestemt type (for eksempel Power Platform-connector), viser lageret tilfældige 200. Administratorer kan bruge capabilitiesCounts-feltet til at forstå, hvor mange ressourcer der er konfigureret i en agent af hver type.

Relateret indhold

  • Last updated on