Agentbeholdning i Microsoft Copilot Studio

Copilot Studio-agentbeholdningen gir IT- og sikkerhetsadministratorer en sentralisert oversikt over alle agenter som er opprettet i Copilot Studio eller agentverktøy i leieren. Beholdningen dekker både upubliserte (utkast) og publiserte agenter. For hver agent viser beholdning nøkkelmetadata, for eksempel hvem som opprettet agenten, når den sist ble publisert, hvilke kanaler den er implementert på, hvordan den autentiserer brukere, funksjonene dens med mer. Inventardata blir automatisk oppdatert, og endringer i en agent blir vanligvis synlige innen 20 minutter.

Administratorer kan forbruke beholdningsdataene på flere måter, blant annet via administrasjonssenteret for Power Platform, Power Platform-API og Azure Resource Graph. For en komplett oversikt over tilgangsmetoder og nødvendige roller kan du se Power Platform-beholdning.

Denne artikkelen beskriver feltene som er spesifikke for Copilot Studio-agenter (microsoft.copilotstudio/agents) i Power Platform-beholdningen. For felles felter på tvers av alle ressurstyper kan du se Referanse for Power Platform-beholdningsskjema.

Notat

Beholdningen inkluderer ikke agenter laget med V1 av Copilot Studio (også kjent som klassiske roboter eller Power Virtual Agents). Du kan likevel gå til administrasjonssenteret for Power Platform og velge Administrer>Copilot Studio>Klassiske chatroboter for å se disse agentene.

Viktig!

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 viser følgende egenskaper for hver agent.

Notat

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

  • Agentens konfigurasjon avgjør hvilke felter som fylles ut. Enkelte egenskaper kan være null avhengig av hvordan agenten er konfigurert. For eksempel er isManagednull for agenter opprettet i agentverktøy.

Kjerneegenskaper

API-feltbane Datatype Bekrivelse Eksempel Status
properties.displayName string Agentens visningsnavn. Customer support agent Tilgjengelig
properties.name GUID Agentens ID i det spesifikke Dataverse-miljøet (CDS-robot-ID). aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.createdAt datetime Datoen og klokkeslettet da agenten ble opprettet. 2024-12-13T04:00:00Z Tilgjengelig
properties.createdBy GUID Entra-ID for brukeren som opprettet agenten. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.ownerId string Objekt-ID-en (Entra-ID) til agentens nåværende eier. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.environmentId string ID-en til 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/null hvis agenten fortsatt er i utkast. 2026-01-15T10:30:00Z Tilgjengelig
properties.createdIn string Redigeringsverktøyet der agenten ble opprettet: Copilot Studio eller Microsoft 365 Copilot-agentverktøy. Copilot Studio Tilgjengelig
properties.schemaName string Dataverse-skjemanavnet. Tilgjengelig for Copilot Studio-agenter og agenter for Microsoft 365 Copilot-agentverktøy. cr5e3_agentName Tilgjengelig
properties.isQuarantined boolsk Om agenten for øyeblikket er 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 del av en administrert Dataverse-løsning. Null for agenter opprettet i agentverktøy. false Forhåndsversjon

Entra-identitetsegenskaper

API-feltbane Datatype Bekrivelse Eksempel Status
properties.botId string CDS-robot-ID i miljøet. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAppId string Entra-appregistrerings-ID tilknyttet agenten, dersom den finnes aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAgentId string ID for Entra-agentidentitet, når den finnes. aaaa0000-bb11-2222-33cc-444444dddddd Tilgjengelig
properties.entraAgentBlueprintId string Blåkopi-ID for Entra-agent, når den 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 spesifikke agenten. Ingen av disse identitetsegenskapene gjelder for agenter for Microsoft 365 Copilot-agentverktøy.

Hvis du vil vite mer om Entra-identitetsbegreper, kan du se Appregistrering, agentidentiteter og autentisering for Copilot Studio.

Konfigurasjonsegenskaper

API-feltbane Datatype Bekrivelse Eksempel Status
properties.orchestration string Agentens iverksettingsmodus (les mer i Iverksettingsmoduser). Generative Forhåndsversjon
properties.model string Modellen for kunstig intelligens som brukes av agenten. gpt-4o Forhåndsversjon
properties.authentication string Autentiseringsmodus for agenten (les mer i Autentiseringsmoduser). Microsoft Entra Forhåndsversjon
properties.channels matrise Visningsnavnene til kanalene agenten publiseres til. ["Teams","SharePoint"] Forhåndsversjon
properties.sharedWithViewers objekt Antall individuelle visningsprogrambruker (userCount) og visningsprogramgrupper (groupCount) agenten er delt med. Hvis en oppretter delte agenten med hele leieren, er entireTenant satt til true, selv om en administrator ikke godkjente delingen. "groupCount": 0, "userCount": 0, "entireTenant": false Forhåndsversjon
properties.sharedWithEditors objekt Antall individuell redigeringsprogrambrukere (userCount) og redigeringsprogramgrupper (groupCount) agenten er delt med. "groupCount": 0, "userCount": 0 Forhåndsversjon
properties.capabilitiesCounts objekt Totalt distinkt antall av hver type konfigurerte egenskaper "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Forhåndsversjon

Iverksettingsmoduser

properties.orchestration-feltet godtar følgende verdier:

Verdi Description
Klassisk Agenten benytter klassisk emnebasert iverksetting med forfatterstyrte dialogtrær.
Generativ Agenten bruker generativ iverksetting, der en modell for kunstig intelligens dynamisk velger temaer og handlinger.

Godkjenningsmoduser

properties.authentication-feltet godtar følgende verdier:

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

Agentfunksjoner

Denne delen lister opp agentens egenskaper (verktøy og kunnskap). For øyeblikket viser den bare detaljerte data om koblinger brukt av agenten og en kunnskapskonfigurasjon som beskrevet i de følgende delene.

Oversikten har en begrensning på maksimalt 200 ressurser av hver type per agent. Les mer i Kjente begrensninger.

Beholdningen fjerner automatisk duplikatressurser, som en Power Platform-kobling som du har konfigurert to ganger i en agent med samme konfigurasjon.

Tilkoblingsegenskaper

Oversikten inneholder en matrise kalt powerPlatformConnectors, som inneholder Power Platform-koblinger konfigurert i en agent. Hver kobling identifiseres ved connectorId (en streng som inneholder koblingens ressurs-ID, f.eks. shared_excelonlinebusiness). For hver konfigurert kobling finnes det en liste over konfigurerte operations. Listen inkluderer følgende egenskaper:

Egenskap Datatype Description Status
OperationId string ID-en til den spesifikke operasjonen i koblingen; f.eks. AddRowV2 Forhåndsversjon
createdBy GUID Brukeren som konfigurerte operasjonen Forhåndsversjon
isEnabled boolsk Om koblingsoperasjonen for øyeblikket er aktivert Forhåndsversjon
usedAs string Hvordan operasjonen brukes:
  • Tool hvis det er konfigurert som et generelt verktøy
  • Topic Tool hvis det er konfigurert som et verktøy i et spesifikt 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 string Når operasjonen kan aktiveres:
  • Anytime hvis verktøyet er tilgjengelig for agenten uten begrensninger
  • ViaDirectReferenceOnly hvis agenten bare bruker verktøyet når utvikleren eksplisitt har konfigurert det i spesifikke emner
  • Conditional hvis agenten kan bruke verktøyet i henhold til en forhåndsdefinert logikk fra produsenten
 Forhåndsversjon
connectionProvider string Hvem som gir koblingen til operasjonen:
  • User hvis sluttbrukeren oppgir autentiseringsinformasjon under kjøring
  • Maker hvis utvikleren angir tilkoblingen ved redigeringstidspunktet
 Forhåndsversjon
connectionIdSharedByMaker GUID Tilkoblings-ID, angitt bare 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
    }
  }
}

Egenskaper for kunnskap

Beholdningen inkluderer følgende egenskap for kunnskap:

Egenskap Datatype Description Status
IsWebSearchEnabledForKnowledge boolsk Sant 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-agenten (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-agentidentitetsmodellen. Eldre agenter har kanskje bare entraAppId, og agenter for Microsoft 365 Copilot-agentverktøy har ingen av disse identitetsegenskapene.
  • Antall egenskaper – Beholdningen 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 (f.eks. Power Platform-koblinger), viser beholdningen tilfeldig 200. Administratorer kan bruke capabilitiesCounts-feltet til å forstå hvor mange ressurser som er konfigurert i en agent per type.

Relatert innhold

  • Last updated on