Microsoft Copilot Studio agentoversikt

Copilot Studio agentbeholdning gir IT- og sikkerhetsadministratorer en sentralisert visning av alle agenter som er opprettet ved hjelp av Copilot Studio eller Agent Builder i leieren. Beholdningen dekker både upubliserte (utkast) og publiserte agenter. For hver agent viser beholdningen viktige metadata, for eksempel hvem som opprettet agenten, når den sist ble publisert, hvilke kanaler den distribueres til, hvordan den godkjenner brukere, dens funksjoner og mer. Lagerdata oppdateres automatisk, og endringer i en agent vises vanligvis innen 20 minutter.

Administratorer kan bruke lagerdataene gjennom flere metoder, inkludert administrasjonssenteret for Power Platform, Power Platform API og Azure Resource Graph. Hvis du vil ha en fullstendig liste over tilgangsmetoder og nødvendige roller, kan du se Power Platform-beholdningen.

Denne artikkelen beskriver feltene som er spesifikke for Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-beholdningen. Hvis du vil ha delte felt tilgjengelig på alle ressurstyper, kan du se Referanse for Lagerskjema for Power Platform.

Notat

Beholdningen inkluderer ikke agenter som er opprettet med V1 av Copilot Studio (også kjent som klassiske roboter eller Power Virtual Agents). Du kan imidlertid fortsatt gå til administrasjonssenteret for Power Platform og velge Manage>Copilot Studio>Classic chatbots for å se disse agentene.

Important

Denne artikkelen inneholder dokumentasjon for Microsoft Copilot Studio-forhåndsversjonen og kan bli endret.

Evalueringsfunksjonalitet er ikke ment for produksjonsbruk og kan ha begrensninger. Disse funksjonene er tilgjengelige før en offisielle utgivelsen slik at du kan få tidlig tilgang og gi tilbakemeldinger.

Hvis du skal bygge en produksjonsklar agent, kan du se Oversikt over Microsoft Copilot Studio.

Agentegenskaper

Beholdningen inneholder følgende egenskaper for hver agent.

Notat

  • Beholdningen gjenspeiler strukturen til den publiserte versjonen av hver agent. Hvis en agent har upubliserte endringer (en nyere kladd), viser ikke beholdningen disse endringene før agenten er publisert.

  • Konfigurasjonen til en agent påvirker hvilke felt som fylles ut. Noen egenskaper kan være null avhengig av hvordan agenten er konfigurert. For eksempel er isManagednull for agenter som er opprettet i Agent Builder.

Kjerneegenskaper

API-feltsti Datatype Beskrivelse Eksempel Status
properties.displayName streng Agentens visningsnavn. Customer support agent Tilgjengelig
properties.name GUID Agentens ID i det spesifikke dataverse miljøet (CDS bot ID). aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.createdAt datetime Dato og klokkeslett agenten ble opprettet. 2024-12-13T04:00:00Z Tilgjengelig
properties.createdBy GUID Entra ID av brukeren som opprettet agenten. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.ownerId streng Objekt-IDen (Entra ID) til agentens gjeldende eier. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.environmentId streng Identifikatoren for Power Platform-miljøet som inneholder ressursen. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.lastPublishedAt datetime Datoen og klokkeslettet da agenten sist ble publisert. Tom eller null hvis agenten fortsatt er et utkast. 2026-01-15T10:30:00Z Tilgjengelig
properties.createdIn streng Redigeringsverktøyet der agenten ble opprettet: Copilot Studio eller Microsoft 365 Copilot Agent Builder. Copilot Studio Tilgjengelig
properties.schemaName streng Navnet på dataversskjemaet. Tilgjengelig for Copilot Studio-agenter og Microsoft 365 Copilot Agent Builder-agenter. cr5e3_agentName Tilgjengelig
properties.isQuarantined boolsk Om agenten er satt i karantene. false Forhåndsversjon
properties.quarantinedAt datetime Datoen og klokkeslettet da agenten sist ble satt i karantene. 2026-02-01T08:00:00Z Forhåndsversjon
properties.isManaged boolsk Om agenten er en del av en administrert dataversløsning. Null for agenter som er opprettet i Agent Builder. false Forhåndsversjon

Entra-identitetsegenskaper

API-feltsti Datatype Beskrivelse Eksempel Status
properties.botId streng CDS-bot-ID-en i miljøet. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAppId streng Registrerings-ID for Entra-appen som er knyttet til agenten, når den finnes. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAgentId streng Entra-agent-ID, når den finnes. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAgentBlueprintId streng Entra Agent Blueprint ID, når det finnes. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig

Notat

Ikke alle identitetsegenskaper er tilgjengelige for alle agenttyper: entraAppId er en eldre identifikator, nyere agenter bruker entraAgentId og entraAgentBlueprintId. Disse feltene fylles bare ut når de gjelder for den bestemte agenten. Ingen av disse identitetsegenskapene gjelder for Microsoft 365 Copilot Agent Builder-agenter.

Lær mer om agentidentiteter og autentisering i Copilot Studio.

Konfigurasjonsegenskaper

API-feltsti Datatype Beskrivelse Eksempel Status
properties.orchestration streng Orkestreringsmodusen til agenten (finn ut mer i orkestreringsmoduser). Generative Forhåndsversjon
properties.model streng AI-modellen som brukes av agenten. gpt-4o Forhåndsversjon
properties.authentication streng Godkjenningsmodusen som er konfigurert for agenten (finn ut mer i godkjenningsmoduser). Microsoft Entra Forhåndsversjon
properties.channels matrise Visningsnavnene for kanalene agenten publiseres til. ["Teams","SharePoint"] Forhåndsversjon
properties.sharedWithViewers objekt Antall individuelle visningsbrukere (userCount) og seergrupper (groupCount) agenten deles med. Hvis en oppretter delte agenten med hele leieren, entireTenant er satt til true, selv om en administrator ikke godkjente delingen. "groupCount": 0, "userCount": 0, "entireTenant": false Forhåndsversjon
properties.sharedWithEditors objekt Antall individuelle redigeringsbrukere (userCount) og redigeringsgrupper (groupCount) agenten deles med. "groupCount": 0, "userCount": 0 Forhåndsversjon
properties.capabilitiesCounts objekt Totalt distinkt antall av hver type konfigurerte funksjoner "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Forhåndsversjon

Orkestreringsmoduser

Feltet properties.orchestration godtar følgende verdier:

Verdi Beskrivelse
Klassisk Agenten bruker klassisk emnebasert orkestrering med forfattet dialogbokstrær.
Generativ Agenten bruker generativ iverksetting der en modell for kunstig intelligens dynamisk velger emner og verktøy.

Godkjenningsmoduser

Feltet properties.authentication godtar følgende verdier:

Verdi Beskrivelse
Ingen Ingen godkjenning kreves.
Microsoft Entra Godkjenning via Microsoft Entra-ID.
Generisk OAuth 2.0 Godkjenning via en generisk OAuth 2.0-leverandør.

Agentfunksjoner

Denne delen viser funksjonene (verktøy og kunnskap) til agenten. For øyeblikket viser den bare detaljerte data om koblinger som brukes av agenten og en kunnskapskonfigurasjon som beskrevet i de følgende avsnittene.

Beholdningen har en begrensning på maksimalt 200 ressurser av hver type per agent. Finn ut mer i kjente begrensninger.

Beholdningen fjerner automatisk dupliserte ressurser, for eksempel en Power Platform-kobling som du konfigurerte to ganger i en agent med samme konfigurasjon.

Koblingsegenskaper

Beholdningen inneholder en matrise kalt powerPlatformConnectors, som inneholder Power Platform-koblingene som er konfigurert i en agent. Hver kobling identifiseres av connectorId dens (en streng som inneholder koblingens ressurs-ID, for eksempel shared_excelonlinebusiness). Det finnes en liste over konfigurerte koblinger for hver konfigurerte operationskobling. Listen inneholder følgende egenskaper:

Egenskap Datatype Beskrivelse Status
OperationId streng ID-en for den bestemte operasjonen i koblingen. for eksempel AddRowV2 Forhåndsversjon
createdBy GUID Brukeren som konfigurerte operasjonen Forhåndsversjon
isEnabled boolsk Om koblingsoperasjonen er aktivert Forhåndsversjon
usedAs streng Slik brukes operasjonen:
  • Tool hvis konfigurert som et generelt verktøy
  • Topic Tool hvis konfigurert som et verktøy i et bestemt emne
  • Knowledge hvis koblingen er konfigurert som en kunnskapskilde
Forhåndsversjon
requiresEndUserConsent boolsk Om sluttbrukere må samtykke før agenten kan bruke operasjonen Forhåndsversjon
whenCanBeUsed streng Når operasjonen kan aktiveres:
  • Anytime hvis verktøyet er tilgjengelig for agenten uten begrensninger
  • ViaDirectReferenceOnly hvis agenten bare bruker verktøyet når oppretteren eksplisitt konfigurerte det i bestemte emner
  • Conditional hvis agenten kan bruke verktøyet i henhold til en forhåndsdefinert logikk av oppretteren
Forhåndsversjon
connectionProvider streng Hvem som angir tilkoblingen for operasjonen:
  • User hvis sluttbrukeren oppgir legitimasjon i kjøretid
  • Maker hvis oppretteren angir tilkoblingen ved redigeringstidspunkt
Forhåndsversjon
connectionIdSharedByMaker GUID Tilkoblings-ID, bare fylt ut når connectionProvider = Maker Forhåndsversjon
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
    }
  }
}

Kunnskapsegenskaper

Beholdningen inneholder følgende egenskap for kunnskap:

Egenskap Datatype Beskrivelse Status
IsWebSearchEnabledForKnowledge boolsk Sann hvis agenten kan bruke nettsøk som kunnskapskilde Forhåndsversjon

Kjente begrensninger

  • V1-agenter spores ikke – Beholdningen inkluderer ikke agenter som er opprettet med den opprinnelige Power Virtual Agents V1-kjøretiden. Den sporer bare V2-agenter (Copilot Studio).
  • Identitetsegenskaper er kanskje ikke tilgjengelige for alle agenter – Feltene entraAgentId og entraAgentBlueprintId fylles bare ut for agenter som er klargjort med den nyere Entra-agent-ID-modellen. Eldre agenter har kanskje bare entraAppId, og Microsoft 365 Copilot Agent Builder-agenter har ikke noen av disse identitetsegenskapene.
  • Antall funksjoner – Lageret har en begrensning på maksimalt 200 ressurser av hver type per agent. Hvis en agent har mer enn 200 konfigurerte ressurser fra en bestemt type (for eksempel Power Platform-koblinger), viser beholdningen tilfeldige 200. Administratorer kan bruke feltet capabilitiesCounts til å forstå hvor mange ressurser som er konfigurert i en agent per type.