Microsoft Copilot Studio-agentinventaris

De agentinventaris van Copilot Studio biedt IT- en beveiligingsbeheerders een gecentraliseerd overzicht van alle agents die in de tenant zijn gemaakt met Copilot Studio of Agent Builder. De inventaris omvat zowel ongepubliceerde (concept) als gepubliceerde agents. Voor elke agent toont de inventaris belangrijke metadata, zoals wie de agent heeft gemaakt, wanneer deze voor het laatst is gepubliceerd, naar welke kanalen deze is geïmplementeerd, hoe deze gebruikers authenticeert, de mogelijkheden en meer. Inventarisgegevens worden automatisch vernieuwd en wijzigingen aan een agent worden doorgaans binnen 20 minuten weergegeven.

Beheerders kunnen de inventarisgegevens op verschillende manieren gebruiken, waaronder via het Power Platform-beheercentrum, de Power Platform API en Azure Resource Graph. Zie Power Platform-inventaris voor een volledige lijst met toegangsmethoden en vereiste rollen.

Dit artikel beschrijft de velden die specifiek zijn voor Copilot Studio-agenten (microsoft.copilotstudio/agents) in de Power Platform-inventaris. Voor gedeelde velden die beschikbaar zijn voor alle resourcetypen, zie Het schema van de Power Platform-inventaris.

Notitie

De inventaris bevat geen agenten die zijn gemaakt met versie 1 van Copilot Studio (ook wel bekend als Classic bots of Power Virtual Agents). U kunt echter nog steeds naar het Power Platform-beheercentrum gaan enBeheer>Copilot Studio>Klassieke chatbots om die agents te zien.

Belangrijk

Dit artikel bevat documentatie voor de preview van Microsoft Copilot Studio en kan nog veranderen.

Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar voor een officiële release zodat u vroeg toegang kunt krijgen en feedback kunt geven.

Zie Overzicht van Microsoft Copilot Studio als u een productieklare agent aan het bouwen bent.

Agenteigenschappen

De inventaris biedt de volgende eigenschappen voor elke agent.

Notitie

  • De inventaris weerspiegelt de structuur van de gepubliceerde versie van elke agent. Als een agent niet-gepubliceerde wijzigingen heeft (een nieuwer concept), worden die wijzigingen pas in de inventaris weergegeven als de agent is gepubliceerd.

  • De configuratie van een agent is van invloed op welke velden worden ingevuld. Sommige eigenschappen kunnen null zijn, afhankelijk van hoe de agent is ingesteld. isManaged is bijvoorbeeld null voor agents die zijn gemaakt in de agentopbouwfunctie.

Kerneigenschappen

API-veldpad Gegevenstype Omschrijving Voorbeeld -Status
properties.displayName string De weergavenaam van de agent. Customer support agent Algemeen beschikbaar
properties.name GUID De ID van de agent in de specifieke Dataverse-omgeving (CDS-bot-ID). aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.createdAt datumtijd Datum en tijd waarop de agent is gemaakt. 2024-12-13T04:00:00Z Algemeen beschikbaar
properties.createdBy GUID Entra-ID van de gebruiker die de agent heeft gemaakt. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.ownerId string De object-ID (Entra ID) van de huidige eigenaar van de agent. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.environmentId string De ID van de Power Platform-omgeving die de bron bevat. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.lastPublishedAt datumtijd De datum en tijd waarop de agent voor het laatst is gepubliceerd. Leeg/null als de agent zich nog in de conceptfase bevindt. 2026-01-15T10:30:00Z Algemeen beschikbaar
properties.createdIn string De ontwerptool waarin de agent is gemaakt: Copilot Studio of Microsoft 365 Copilot Agent Builder. Copilot Studio Algemeen beschikbaar
properties.schemaName string De Dataverse-schemanaam. Beschikbaar voor Copilot Studio-agenten en Microsoft 365 Copilot Agent Builder-agenten. cr5e3_agentName Algemeen beschikbaar
properties.isQuarantined boolean Of de agent momenteel in quarantaine is geplaatst. false Preview
properties.quarantinedAt datumtijd De datum en tijd waarop de agent voor het laatst in quarantaine is geplaatst. 2026-02-01T08:00:00Z Preview
properties.isManaged boolean Of de agent deel uitmaakt van een beheerde Dataverse-oplossing. Null voor agents die in de agentopbouwfunctie zijn gemaakt. false Preview

Entra-identiteitseigenschappen

API-veldpad Gegevenstype Omschrijving Voorbeeld -Status
properties.botId string De CDS-bot-ID in de omgeving. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAppId string Entra-appregistratie-ID die aan de agent is gekoppeld, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAgentId string Entra-agentidentiteits-ID, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAgentBlueprintId string Entra-agentblauwdruk-ID, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar

Notitie

Niet alle identiteitseigenschappen zijn beschikbaar voor alle agenttypen: entraAppId is een verouderde identificatiecode; nieuwere agents gebruiken entraAgentId en entraAgentBlueprintId. Deze velden worden alleen ingevuld als ze van toepassing zijn op de specifieke agent. Geen van deze identiteitseigenschappen is van toepassing op Microsoft 365 Copilot Agent Builder-agents.

Zie App-registratie, agentidentiteiten en authenticatie voor Copilot Studio voor meer informatie over Entra-identiteitsconcepten.

Configuratie-eigenschappen

API-veldpad Gegevenstype Omschrijving Voorbeeld -Status
properties.orchestration string De orkestratiemodus van de agent (meer informatie in Orkestratiemodi). Generative Preview
properties.model string Het AI-model dat door de agent wordt gebruikt. gpt-4o Preview
properties.authentication string De authenticatiemodus die voor de agent is geconfigureerd (meer informatie in Authenticatiemodi). Microsoft Entra Preview
properties.channels matrix De weergavenamen van de kanalen waarop de agent wordt gepubliceerd. ["Teams","SharePoint"] Preview
properties.sharedWithViewers object Aantal individuele kijkers (userCount) en kijkersgroepen (groupCount) waarmee de agent wordt gedeeld. Als een maker de agent met de hele tenant heeft gedeeld, wordt entireTenant ingesteld op true, zelfs als een beheerder het delen niet heeft goedgekeurd. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors object Aantal individuele editors (userCount) en editorgroepen (groupCount) waarmee de agent wordt gedeeld. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts object Totaal aantal unieke exemplaren van elk type geconfigureerde mogelijkheden "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Indelingmodi

Het veld properties.orchestration accepteert de volgende waarden:

Waarde Omschrijving
Klassiek De agent gebruikt klassieke topic-gebaseerde indeling met door de auteur gedefinieerde dialoogstructuren.
Generatieve De agent maakt gebruik van generatieve indeling, waarbij een AI-model dynamisch onderwerpen en acties selecteert.

Authenticatiemodi

Het veld properties.authentication accepteert de volgende waarden:

Waarde Omschrijving
Geen Geen authenticatie vereist.
Microsoft Entra Authenticatie via Microsoft Entra ID.
Algemene OAuth 2.0 Authenticatie via een generieke OAuth 2.0-provider.

Agentmogelijkheden

In dit gedeelte worden de mogelijkheden (tools en kennis) van de agent weergegeven. Momenteel worden alleen gedetailleerde gegevens weergegeven over connectors die door de agent worden gebruikt en een kennisconfiguratie, zoals beschreven in de volgende secties.

De inventaris heeft een limiet van maximaal 200 resources van elk type per agent. Meer informatie vindt u in Bekende beperkingen.

De inventaris verwijdert automatisch dubbele resources, zoals een Power Platform-connector die u twee keer hebt geconfigureerd in een agent met dezelfde configuratie.

Connectoreigenschappen

De inventaris bevat een array met de naam powerPlatformConnectors, die de Power Platform-connectors bevat die in een agent zijn geconfigureerd. Elke connector wordt geïdentificeerd door de connectorId (een tekenreeks die de resource-ID van de connector bevat, bijvoorbeeld shared_excelonlinebusiness). Voor elke geconfigureerde connector bestaat er een lijst met geconfigureerde operations. De lijst bevat de volgende eigenschappen:

Eigenschap Gegevenstype Omschrijving -Status
OperationId string De ID van de specifieke bewerking binnen de connector; bijvoorbeeld, AddRowV2 Preview
createdBy GUID De gebruiker die de bewerking heeft geconfigureerd Preview
isEnabled boolean Of de connectorbewerking momenteel is ingeschakeld Preview
usedAs string Hoe de bewerking wordt gebruikt:
  • Tool indien geconfigureerd als een algemene tool
  • Topic Tool indien geconfigureerd als een tool in een specifiek onderwerp
  • Knowledge indien de connector is geconfigureerd als een kennisbron
 Preview
requiresEndUserConsent boolean Of eindgebruikers toestemming moeten geven voordat de agent de bewerking kan gebruiken Preview
whenCanBeUsed string Wanneer de bewerking kan worden aangeroepen:
  • Anytime als de tool zonder beperkingen beschikbaar is voor de agent
  • ViaDirectReferenceOnly als de agent de tool alleen gebruikt wanneer de maker deze expliciet heeft geconfigureerd in specifieke onderwerpen
  • Conditional als de agent de tool kan gebruiken volgens een vooraf gedefinieerde logica van de maker
 Preview
connectionProvider string Wie de verbinding voor de bewerking levert:
  • User als de eindgebruiker inloggegevens verstrekt tijdens runtime
  • Maker als de maker de verbinding instelt tijdens het maken van de code
 Preview
connectionIdSharedByMaker GUID Verbindings-ID, wordt alleen ingevuld wanneer connectionProvider = Maker Preview
Voorbeeld
{
  "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
    }
  }
}

Kenniseigenschappen

De inventaris bevat de volgende eigenschap voor kennis:

Eigenschap Gegevenstype Omschrijving Status
IsWebSearchEnabledForKnowledge boolean True als de agent webzoekopdrachten als kennisbron kan gebruiken Preview

Bekende beperkingen

  • V1-agents worden niet bijgehouden - De inventaris bevat geen agents die zijn gemaakt met de originele Power Virtual Agents V1-runtime. Hiermee worden alleen V2-agents (Copilot Studio) bijgehouden.
  • Identiteitseigenschappen zijn mogelijk niet beschikbaar voor alle agents - De velden entraAgentId en entraAgentBlueprintId worden alleen ingevuld voor agents die zijn geprovisioneerd met het nieuwere Entra-agentidentiteitsmodel. Oudere agents hebben mogelijk alleen entraAppId, en Microsoft 365 Copilot Agent Builder-agents hebben geen van deze identiteitseigenschappen.
  • Aantal mogelijkheden - De inventaris heeft een limiet van maximaal 200 resources van elk type per agent. Als een agent meer dan 200 geconfigureerde resources van een specifiek type heeft (bijvoorbeeld Power Platform-connectors), toont de inventaris een willekeurig getal van 200. Beheerders kunnen het veld capabilitiesCounts gebruiken om te zien hoeveel resources per type in een agent zijn geconfigureerd.

Gerelateerde inhoud

  • Last updated on