Merk
Tilgang til denne siden krever autorisasjon. Du kan prøve å logge på eller endre kataloger.
Tilgang til denne siden krever autorisasjon. Du kan prøve å endre kataloger.
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
nullavhengig av hvordan agenten er konfigurert. For eksempel erisManagednullfor 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:
|
Forhåndsversjon |
requiresEndUserConsent |
boolsk | Om sluttbrukere må samtykke før agenten kan bruke operasjonen | Forhåndsversjon |
whenCanBeUsed |
streng | Når operasjonen kan aktiveres:
|
Forhåndsversjon |
connectionProvider |
streng | Hvem som angir tilkoblingen for operasjonen:
|
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
entraAgentIdogentraAgentBlueprintIdfylles bare ut for agenter som er klargjort med den nyere Entra-agent-ID-modellen. Eldre agenter har kanskje bareentraAppId, 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
capabilitiesCountstil å forstå hvor mange ressurser som er konfigurert i en agent per type.