inventaris van Microsoft Copilot Studio agent

De Copilot Studio agentinventaris biedt IT- en beveiligingsbeheerders een gecentraliseerde weergave van alle agents die zijn gemaakt met behulp van Copilot Studio of Agent Builder in de tenant. De inventaris omvat zowel ongepubliceerde (concept) als gepubliceerde agenten. Voor elke agent worden in de inventaris belangrijke metagegevens weergegeven, zoals wie de agent heeft gemaakt, wanneer deze voor het laatst is gepubliceerd, op welke kanalen deze is ingezet, hoe gebruikers worden geverifieerd, over welke mogelijkheden deze beschikt en meer. Inventarisgegevens worden automatisch vernieuwd en wijzigingen in een agent worden doorgaans binnen 20 minuten weergegeven.

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

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.

Note

De inventaris bevat geen agents die zijn gemaakt met V1 van Copilot Studio (ook wel klassieke bots of Power Virtual Agents genoemd). U kunt echter nog steeds naar het Power Platform-beheercentrum gaan en Manage>Copilot Studio>Classic chatbots selecteren om deze agents te zien.

Important

Dit artikel bevat Microsoft Copilot Studio preview-documentatie en kan worden gewijzigd.

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.

Als u een productieklare agent bouwt, raadpleegt u Microsoft Copilot Studio Overview.

Agenteigenschappen

De inventaris bevat de volgende eigenschappen voor elke agent.

Note

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

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

Kerneigenschappen

API-veldpad Gegevenstype Description Example 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 datetime De datum en tijd waarop de agent is aangemaakt. 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 datetime De datum en tijd waarop de agent voor het laatst is gepubliceerd. Leeg/null als de agent nog in concept is. 2026-01-15T10:30:00Z Algemeen beschikbaar
properties.createdIn string Het ontwerpprogramma waar de agent is gemaakt: Copilot Studio of Microsoft 365 Copilot Agent Builder. Copilot Studio Algemeen beschikbaar
properties.schemaName string 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 momenteel in quarantaine is geplaatst. false Preview
properties.quarantinedAt datetime 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 Agent Builder zijn gemaakt. false Preview

Eigenschappen van entra-identiteit

API-veldpad Gegevenstype Description Example Status
properties.botId string De CDS-Bot-ID in de omgeving. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAppId string Registratie-id van de Entra-app die aan de agent is gekoppeld, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAgentId string Entra Agent-ID, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar
properties.entraAgentBlueprintId string Blueprint-id van Entra Agent, indien aanwezig. aaaa0000-bb11-2222-33cc-444444dddddd Algemeen beschikbaar

Note

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

Lees meer over agentidentiteiten en authenticatie in Copilot Studio.

Configuratie-eigenschappen

API-veldpad Gegevenstype Description Example Status
properties.orchestration string De orkestratiemodus van de agent (meer informatie over Orkestratiemodi). Generative Preview
properties.model string Het AI-model dat door de agent wordt gebruikt. gpt-4o Preview
properties.authentication string De verificatiemodus die is geconfigureerd voor de agent (meer informatie in verificatiemodi). Microsoft Entra Preview
properties.channels array De weergavenamen van de kanalen waarop de agent is gepubliceerd. ["Teams","SharePoint"] Preview
properties.sharedWithViewers object Het aantal afzonderlijke viewergebruikers (userCount) en viewergroepen (groupCount) waarmee de agent wordt gedeeld. Als een maker de agent met de hele tenant heeft gedeeld, entireTenant is ingesteld op true, zelfs als een beheerder het delen niet heeft goedgekeurd. "groupCount": 0, "userCount": 0, "entireTenant": false Preview
properties.sharedWithEditors object Het aantal afzonderlijke editorgebruikers (userCount) en editorgroepen (groupCount) waarmee de agent wordt gedeeld. "groupCount": 0, "userCount": 0 Preview
properties.capabilitiesCounts object Totaal aantal afzonderlijke typen geconfigureerde mogelijkheden "distinctPowerPlatformConnectorsOperations": 0, "distinctPowerPlatformConnectors": 0 Preview

Orchestratiemodi

Het properties.orchestration veld accepteert de volgende waarden:

Value Description
Klassiek De agent maakt gebruik van klassieke, op onderwerp gebaseerde orkestratie met geschreven dialoogbomen.
Generatieve De agent maakt gebruik van generatieve indeling, waarbij een AI-model dynamisch onderwerpen en tools selecteert.

Verificatiemodi

Het properties.authentication veld accepteert de volgende waarden:

Value Description
Geen Er is geen verificatie vereist.
Microsoft Entra Verificatie via Microsoft Entra-id.
Generieke OAuth 2.0 Verificatie via een algemene OAuth 2.0-provider.

Agentmogelijkheden

In deze sectie vindt u de mogelijkheden (hulpprogramma's en kennis) van de agent. Op dit moment 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 beperking 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 in een agent hebt geconfigureerd met dezelfde configuratie.

Connectoreigenschappen

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

Property Gegevenstype Description 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 algemeen hulpprogramma
  • Topic Tool als deze is geconfigureerd als een hulpprogramma in een specifiek onderwerp
  • Knowledge als 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 het hulpprogramma zonder beperkingen beschikbaar is voor de agent
  • ViaDirectReferenceOnly als de agent het hulpprogramma alleen gebruikt wanneer maker het expliciet heeft geconfigureerd in specifieke onderwerpen
  • Conditional als de agent het hulpprogramma kan gebruiken volgens een vooraf gedefinieerde logica van de maker
 Preview
connectionProvider string Wie biedt de verbinding voor de bewerking:
  • User als de eindgebruiker referenties opgeeft in runtime
  • Maker als de maker de verbinding tijdens het ontwerpen instelt
 Preview
connectionIdSharedByMaker GUID Verbindings-id, alleen ingevuld wanneer connectionProvider = Maker Preview
Example
{
  "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:

Property Gegevenstype Description Status
IsWebSearchEnabledForKnowledge boolean Waar indien de agent de webzoekfunctie als een kennisbron kan gebruiken Preview

Bekende beperkingen

  • V1-agents worden niet bijgehouden : de inventaris bevat geen agents die zijn gemaakt met de oorspronkelijke Power Virtual Agents V1-runtime. Er worden alleen V2-agenten (Copilot Studio) bijgehouden.
  • Identiteitseigenschappen zijn mogelijk niet beschikbaar voor alle agenten - De velden entraAgentId en entraAgentBlueprintId worden alleen gevuld voor agenten die zijn ingericht met het nieuwere Entra Agent-ID-model. Oudere agents hebben mogelijk alleen entraAppId en Microsoft 365 Copilot Agent Builder-agents hebben geen van deze identiteitseigenschappen.
  • Aantal mogelijkheden : de inventaris heeft een beperking 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), geeft de inventaris willekeurige 200 weer. Beheerders kunnen het capabilitiesCounts veld gebruiken om te begrijpen hoeveel resources in een agent per type zijn geconfigureerd.

Verwante onderwerpen

  • Last updated on