Inventarisschema van Copilot Studio-agents

In dit artikel worden de velden beschreven die specifiek zijn voor Copilot Studio-agents (microsoft.copilotstudio/agents) in de Power Platform-inventaris. Zie de power Platform-inventarisschemareferentie voor gedeelde velden die beschikbaar zijn voor alle resourcetypen. Zie Power Platform-inventaris voor een overzicht van de inventarisfunctie.

Kerneigenschappen

API-veldpad Gegevenstype Beschrijving Example Status
properties.ownerId touw De object-ID van de resource-eigenaar. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.environmentId touw De identificatiecode van de omgeving die de resource bevat. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.lastPublishedAt datetime De datum en tijd waarop de agent voor het laatst is gepubliceerd. Leeg als de agent nog in concept is. 2026-01-15T10:30:00Z Algemeen beschikbaar
properties.createdIn touw Het ontwerpprogramma waar de agent is gemaakt: Copilot Studio of Microsoft 365 Copilot Agent Builder. Copilot Studio Algemeen beschikbaar
properties.schemaName touw De naam van het Dataverse-schema. Beschikbaar voor Copilot Studio-agents en Microsoft 365 Copilot Agent Builder-agents. cr5e3_agentName Algemeen beschikbaar
properties.isQuarantined boolean Of de agent in quarantaine is geplaatst. false Voorvertoning
properties.quarantinedAt datetime De datum en tijd waarop de agent voor het laatst in quarantaine is geplaatst. 2026-02-01T08:00:00Z Voorvertoning
properties.isManaged boolean Of de agent deel uitmaakt van een beheerde oplossing. false Voorvertoning

Identiteitseigenschappen

API-veldpad Gegevenstype Beschrijving Example Status Beschikbaar voor
properties.botId touw De CDS-Bot-ID in de omgeving. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar Copilot Studio-agenten, Microsoft 365 Copilot Agent Builder-agenten
properties.entraAppId touw De registratie-id van de entra-app. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar Copilot Studio agenten
properties.entraAgentId touw De Id-id van de Entra-agent. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar Copilot Studio agenten
properties.entraAgentBlueprintId touw De blauwdruk-id van de Entra-agent. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar Copilot Studio agenten

Note

Het entraAppId veld is een verouderde id. Nieuwere agents gebruiken entraAgentId en entraAgentBlueprintId in plaats daarvan. Geen van deze identiteitseigenschappen is van toepassing op Microsoft 365 Copilot Agent Builder-agents.

Configuratie-eigenschappen

API-veldpad Gegevenstype Beschrijving Example Status
properties.orchestration touw De orchestratiemodus van de agent (zie Orchestratiemodi). Generative Voorvertoning
properties.model touw Het AI-model dat door de agent wordt gebruikt. gpt-4o Voorvertoning
properties.authentication touw De verificatiemodus die is geconfigureerd voor de agent (zie verificatiemodi). Microsoft Entra Voorvertoning
properties.channels gegevensreeks De weergavenamen van de kanalen waarop de agent is gepubliceerd. ["Teams","SharePoint"] Voorvertoning

Orchestratiemodi

De volgende waarden zijn mogelijk voor het properties.orchestration veld.

Waarde Beschrijving
Classic De agent maakt gebruik van klassieke, op onderwerp gebaseerde orkestratie met geschreven dialoogbomen.
Generative De agent maakt gebruik van generatieve indeling, waarbij een AI-model dynamisch onderwerpen en acties selecteert.

Verificatiemodi

De volgende waarden zijn mogelijk voor het properties.authentication veld.

Waarde Beschrijving
None Er is geen verificatie vereist.
Microsoft Entra Verificatie via Microsoft Entra-id.
Generic OAuth 2.0 Verificatie via een algemene OAuth 2.0-provider.

Bekende beperkingen

  • V1-agents worden niet gemonitord. Agents die zijn gemaakt met de oorspronkelijke Power Virtual Agents V1-runtime, worden niet opgenomen in de inventaris. Alleen V2-agents (Copilot Studio) worden bijgehouden.
  • Identiteitseigenschappen zijn mogelijk niet beschikbaar voor alle agents. De entraAgentId velden en entraAgentBlueprintId velden worden alleen ingevuld voor agents die zijn ingericht met het nieuwere Entra-agentidentiteitsmodel. Oudere agents kunnen mogelijk alleen entraAppId hebben, en Microsoft 365 Copilot Agent Builder agents hebben geen van deze identiteitseigenschappen.