Microsoft Copilot Studio-agentoversigt

Den Copilot Studio agentoversigt giver it- og sikkerhedsadministratorer en central visning af alle agenter, der er oprettet ved hjælp af Copilot Studio eller Agent Builder i lejeren. Oversigten dækker både ikke-offentliggjorte (kladde) og publicerede agenter. For hver agent viser oversigten vigtige metadata, f.eks. hvem der oprettede agenten, hvornår den sidst blev publiceret, hvilke kanaler den er udrullet til, 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 bruge lagerdataene via flere metoder, herunder Power Platform Administration, Power Platform-API'en og Azure Resource Graph. Du kan se en komplet liste over adgangsmetoder og påkrævede roller under Power Platform-oversigt.

I denne artikel beskrives de felter, der er specifikke for Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-oversigten. Du kan se delte felter, der er tilgængelige på alle ressourcetyper, under Reference til Power Platform-lagerskema.

Bemærk

Lageret omfatter ikke agenter, der er oprettet med V1 af Copilot Studio (også kendt som klassiske robotter eller Power Virtual Agents). Du kan dog stadig gå til Power Platform Administration og vælge Administrer>Copilot Studio>Classic chatbots for at se disse agenter.

Vigtig

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

Prøveversionsfunktioner er ikke beregnet til produktionsbrug 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.

Agentegenskaber

Lageret indeholder følgende egenskaber for hver agent.

Bemærk

  • Oversigten afspejler strukturen af den publicerede version af hver agent. Hvis en agent har ikke-publicerede ændringer (en nyere kladde), viser lageret ikke disse ændringer, før agenten er publiceret.

  • En agents konfiguration påvirker, hvilke felter der udfyldes. Nogle egenskaber kan være null afhængigt af, hvordan agenten er konfigureret. For eksempel er isManagednull for agenter, der er oprettet i Agent Builder.

Grundlæggende egenskaber

Sti til API-felt Datatyp Beskrivelse Eksempel Status
properties.displayName streng Agentens visningsnavn. 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 datetime Dato og klokkeslæt, hvor agenten blev oprettet. 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 streng Objekt-id (Entra ID) for agentens nuværende ejer. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.environmentId streng Id'et for det Power Platform-miljø, der indeholder ressourcen. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.lastPublishedAt datetime Den dato og det klokkeslæt, hvor agenten sidst blev publiceret. Tom/null, hvis agenten stadig er i kladde. 2026-01-15T10:30:00Z Generelt tilgængelig
properties.createdIn streng Oprettelsesværktøjet, hvor agenten blev oprettet: Copilot Studio eller Microsoft 365 Copilot Agent Builder. Copilot Studio Generelt tilgængelig
properties.schemaName streng Navnet på Dataverse-skemaet. Tilgængelig for Copilot Studio-agenter og Microsoft 365 Copilot Agent Builder-agenter. cr5e3_agentName Generelt tilgængelig
properties.isQuarantined boolesk Om agenten i øjeblikket er sat i karantæne. false Forhåndsvisning
properties.quarantinedAt datetime Den dato og det klokkeslæt, hvor agenten sidst blev sat i karantæne. 2026-02-01T08:00:00Z Forhåndsvisning
properties.isManaged boolesk Angiver, om agenten er en del af en administreret Dataverse-løsning. Null for agenter, der er oprettet i Agent Builder. false Forhåndsvisning

Egenskaber for Entra-identitet

Sti til API-felt Datatyp Beskrivelse Eksempel Status
properties.botId streng CDS-bot-id'et i miljøet. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAppId streng Entra App Registration ID, der er knyttet til agenten, når det findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAgentId streng Entra Agent Identity ID, når det findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig
properties.entraAgentBlueprintId streng Entra Agent Blueprint ID, når det findes. aaaa0000-bb11-2222-33cc-444444dddddd Generelt tilgængelig

Bemærk

Ikke alle identitetsegenskaber er tilgængelige for alle agenttyper: entraAppId er et ældre id, 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.

Du kan få mere at vide om Entra-identitetsbegreber under Appregistrering, agentidentiteter og godkendelse for Copilot Studio.

Konfigurationsegenskaber

Sti til API-felt Datatyp Beskrivelse Eksempel Status
properties.orchestration streng Agentens orkestreringstilstand (få mere at vide i Orchestration-tilstande). Generative Forhåndsvisning
properties.model streng Den AI-model, der bruges af agenten. gpt-4o Forhåndsvisning
properties.authentication streng Den godkendelsestilstand, der er konfigureret for agenten (få mere at vide i godkendelsestilstande). Microsoft Entra Forhåndsvisning
properties.channels matrix De viste navne på de kanaler, som agenten publiceres til. ["Teams","SharePoint"] Forhåndsvisning
properties.sharedWithViewers objekt Antallet af individuelle seerebrugere (userCount) og seergrupper (groupCount), som agenten deles med. Hvis en opretter delte agenten med hele lejeren, entireTenant angives til true, også selvom en administrator ikke godkendte delingen. "groupCount": 0, "userCount": 0, "entireTenant": false Forhåndsvisning
properties.sharedWithEditors objekt Antallet af individuelle editorbrugere (userCount) og editorgrupper (groupCount), som agenten deles med. "groupCount": 0, "userCount": 0 Forhåndsvisning
properties.capabilitiesCounts objekt Samlet antal entydige for hver type konfigurerede egenskaber "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Forhåndsvisning

Orkestreringstilstande

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

Værdi Beskrivelse
Klassisk Agenten bruger klassisk emnebaseret orkestrering med oprettede dialogbokstræ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 Beskrivelse
Ingen Der kræves ingen godkendelse.
Microsoft Entra Godkendelse via Microsoft Entra ID.
Generisk OAuth 2.0 Godkendelse via en generisk OAuth 2.0-udbyder.

Agentfunktioner

I dette afsnit vises agentens funktioner (værktøjer og viden). I øjeblikket vises der kun detaljerede data om connectors, der bruges af agenten, og en videnskonfiguration som beskrevet i følgende afsnit.

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

Lageret fjerner automatisk dubletressourcer, f.eks. en Power Platform-connector, som du har konfigureret to gange i en agent med den samme konfiguration.

Egenskaber for forbindelse

Lageret indeholder en matrix kaldet powerPlatformConnectors, som indeholder de Power Platform-connectors, der er konfigureret i en agent. Hver connector identificeres ved hjælp af dens connectorId (en streng, der indeholder connectorens ressource-id, shared_excelonlinebusinessf.eks. ). For hver konfigureret connector er der en liste over konfigurerede operations. Listen indeholder følgende egenskaber:

Egenskab Datatyp Beskrivelse Status
OperationId streng Id'et for den specifikke handling i connectoren. f.eks. AddRowV2 Forhåndsvisning
createdBy GUID Den bruger, der har konfigureret handlingen Forhåndsvisning
isEnabled boolesk Angiver, om connectorhandlingen er aktiveret i øjeblikket Forhåndsvisning
usedAs streng Sådan bruges handlingen:
  • Tool hvis konfigureret som et generelt værktøj
  • Topic Tool hvis konfigureret som et værktøj i et bestemt emne
  • Knowledge hvis connectoren er konfigureret som en videnskilde
 Forhåndsvisning
requiresEndUserConsent boolesk Om slutbrugerne skal give samtykke, før agenten kan bruge handlingen Forhåndsvisning
whenCanBeUsed streng 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 konfigurerede det i bestemte emner
  • Conditional hvis agenten kan bruge værktøjet i henhold til en foruddefineret logik af udvikleren
 Forhåndsvisning
connectionProvider streng Hvem leverer forbindelsen til handlingen:
  • User hvis slutbrugeren angiver legitimationsoplysninger i runtime
  • Maker hvis opretteren angiver forbindelsen på oprettelsestidspunktet
 Forhåndsvisning
connectionIdSharedByMaker GUID Forbindelses-id, der kun udfyldes, når connectionProvider = Maker Forhåndsvisning
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
    }
  }
}

Egenskaber for viden

Lageret indeholder følgende egenskab til viden:

Egenskab Datatyp Beskrivelse Status
IsWebSearchEnabledForKnowledge boolesk Sand, hvis agenten kan bruge websøgning som en videnskilde Forhåndsvisning

Kendte begrænsninger

  • V1-agenter spores ikke – Lageret omfatter ikke agenter, der er oprettet med den oprindelige Power Virtual Agents V1-kørsel. 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 agent-identitetsmodel. Ældre agenter har muligvis kun entraAppId, og Microsoft 365 Copilot Agent Builder-agenter har ingen af disse identitetsegenskaber.
  • Antal egenskaber – 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 (f.eks. Power Platform-connectors), vises der tilfældige 200 på lageret. Administratorer kan bruge feltet capabilitiesCounts til at forstå, hvor mange ressourcer der er konfigureret i en agent pr. type.

Relateret indhold

  • Last updated on