Monitor agenten door Agent Inventory te gebruiken in Copilot Agent Kit

De functie Agent Inventory biedt beheerders tenantbrede zichtbaarheid in alle Copilot Studio custom agents en declarative agents in de organisatie, verspreid over omgevingen heen. Agent Inventory-gegevens omvatten levenscyclus- en eigendomsmetadata, configuratie- en capability-adoptiesignalen, governance-indicatoren en gebruiksstatistieken.

Note

Dit artikel beschrijft de huidige ervaring met de Agent Inventory. De eerdere ervaring is gedocumenteerd in de Copilot Agent Kit-repository op GitHub in het AGENT_INVENTORY_V1.md-bestand.

Dashboard

Het Agent Inventory-dashboard geeft je een huurder-brede samenvatting en een doorloopnavigatie in de inventaris. Selecteer een tegel, grafiek of lijstitem om een gefilterde weergave te openen in het agentenraster.

Inventariscontext

De statusrij bovenaan het dashboard toont de huidige status van de inventaris:

Of de inventaris nu actueel, leeg is of een synchronisatie bezig is.
Het percentage van de records dat is verrijkt met gedetailleerde configuratie.
Het aantal agenten waarvan beperkte details beschikbaar zijn.
Het aantal gesynchroniseerde omgevingen.
De laatst succesvolle synchronisatietijd, wanneer beschikbaar.

Portefeuillestatistieken

De metrische tegels helpen je direct in belangrijke segmenten van de inventaris te springen:

Aantal agenten
Aangedreven door
Autonome agenten
Conceptagents
Agenten met kennis

Selecteer een tegel om het agentenraster te openen, gefilterd naar dat segment. De Powered by-tegel groepeert agenten in categorieën zoals Standard, GitHub Copilot en Copilot Chat.

Analyse en beheer

Het dashboard bevat ook grafieken en lijsten die je helpen patronen en risico's te herkennen:

Portefeuillegroei met periodes van zes en twaalf maanden.
Authenticatiedistributie.
Governanceprioriteiten die beoordeling door een beheerder vereisen.
Portefeuillestatusverdeling .
Capaciteitsacceptatie voor verrijkte agents.
Topomgevingen gerangschikt op aantal agenten.
Agents om in de gaten te houden voor records die aandacht vereisen.

Percentages hangen af van de omgevingen waarvoor de geconfigureerde verbindingsidentiteiten agentgegevens en gedetailleerde configuratie kunnen ophalen. Lees meer in dataverzamelingsmodi.

Bekijk alle agenten

Selecteer Volledig overzicht weergeven op het dashboard om het agentenoverzicht te openen. Gebruik het raster om voorraadgegevens te vinden, te groeperen en te exporteren.

Je kunt filteren, sorteren en groeperen op elke kolom, kolommen toevoegen of verwijderen om het raster aan te passen aan jouw wensen, en de huidige weergave exporteren naar Excel.

Details van agent

Selecteer een agentnaam uit het raster om agentgegevens te openen. De header toont de agentidentiteit, omgevingscontext, levenscyclusstatus, eigendom en beschikbare acties. Een informatiebanner geeft aan of het record volledige Dataverse-verrijking heeft of slechts beperkte configuratiedetails.

Tabblad Overzicht

Het tabblad Overzicht toont de samenvatting van de agenten en omgevingsinformatie, governance-houding en signalen, en een gebruiksmomentopname wanneer de gebruiksgeschiedenis bestaat. Als door AI gegenereerde beschrijvingen zijn ingeschakeld en de agent een geschikte GitHub Copilot-agent is, wordt ook een door AI gegenereerde beschrijving getoond.

Tabblad Onderdelen

Het tabblad Componenten verschijnt alleen wanneer componentgegevens beschikbaar zijn voor de agent. Gebruik dit tabblad om de agentarchitectuur te verkennen in de Component map-weergave , blader door gecategoriseerde inhoud in de Component-groepsweergave , vergroot één ingevulde componentgroep tegelijk, zet de Raw-modus in om de JSON te inspecteren, of kopieer component-JSON voor onderzoek of ondersteuning.

Tabblad Gebruik

Het tabblad Usage verschijnt alleen wanneer er gebruiksrecords bestaan voor de agent. Deze bevat:

Maand tot nu toe, de twee voorgaande kalendermaanden, de laatste drie maanden en de laatste zes maanden. De laatste zes maanden wordt standaard geselecteerd.
Totaal aantal Copilot-studiepunten en gemiddeld aantal studiepunten per actieve week.
Gerapporteerde gebruikers en primaire gebruiksfunctie.
Wekelijkse krediettrends.
Gebruikshoogtepunten, credits per functie en kanaal, en recente gebruiksrecords.
Een agent-specifieke Excel-export.

Metadata-tabblad

Het tabblad Metadata is altijd beschikbaar. Gebruik het om technische waarden te inspecteren zoals agent-ID en schemanaam, omgevings-ID en URL, locatie- en bronidentificaties, en de ruwe inventarisvelden die worden gebruikt voor diagnostiek en integratie.

Synchroniseer of ververs de voorraadgegevens

Agent Inventory scheidt synchronisatie van dashboardvernieuwing.

Synchronisatieagenten

Selecteer Sync agents wanneer je de tenant-inventaris opnieuw moet verzamelen. De synchronisatie volgt de filters, omgevingsgroepen, gegevensverzamelingsmodus, gebruiksinstellingen en schema die zijn opgeslagen in Configure Agent Inventory.

Terwijl een synchronisatie draait:

De inventarisstatus verandert naar Synchronisatie in uitvoering.
Sync agents is uitgeschakeld om dubbele bewerkingen te voorkomen.
Instellingen die de actieve synchronisatieconfiguratie kunnen wijzigen zijn niet beschikbaar.
Het dashboard laadt agentgegevens, gebruiksgeschiedenis, synchronisatiestatus en laatst gesynchroniseerde informatie opnieuw nadat de synchronisatie is vastgesteld.

Ververs dashboardgegevens

Selecteer dashboardgegevens verversen om gegevens te herladen die al zijn opgeslagen in de tabellen Agent Details en Agent Usage History . Refresh start geen Agent Sync en herontdekt geen omgevingen of agenten. Gebruik het na een voltooide synchronisatie, of wanneer het dashboard verouderde gecachte data toont.

Important

Agent-synchronisatie gebruikt geen Copilot-credits. Credits worden alleen gebruikt wanneer AI-gegenereerde beschrijvingen zijn ingeschakeld en de detailpagina van een geschikte GitHub Copilot-agent wordt bezocht.

Governanceacties

Agent Inventory ondersteunt Reassigne, Quarantaine en Unquarantaine-acties . Acties verschijnen alleen wanneer elke geselecteerde agent in aanmerking komt.

Actiebeschikbaarheid

De Statuskolom in het raster wordt ingevuld tijdens de laatste inventaris-synchronisatie en geeft de waarde weer die afkomstig is van het Power Platform admincentrum (One Inventory data). Welke acties worden getoond hangt af van hoeveel records je selecteert en hun status.

Action	Selectieregel	Verborgen wanneer
Opnieuw toewijzen	Er kunnen één of meerdere records (maximaal 50) worden geselecteerd.	Elke geselecteerde agent komt niet in aanmerking voor herplaatsing.
Quarantaine	Eén of meerdere records in de status Draft of Available (maximaal 50) kunnen worden geselecteerd.	Elke geselecteerde agent is geblokkeerd of komt niet in aanmerking voor quarantaine.
Uit quarantaine halen	Eén of meerdere records in Blokkeerde status (maximaal 50) kunnen worden geselecteerd.	Elke geselecteerde agent is Draft, Available, of komt niet in aanmerking voor onquarantaine.

Als een geselecteerd record niet compatibel is met een operatie, wordt die bewerking verborgen in de commandobalk. Records waarvan de Power Platform admin center-context niet overeenkomt met de inventarisomgeving krijgen geen niet-ondersteunde governance-acties aangeboden.

Op de pagina met Agentgegevens is quarantaine- en ontquarantainebeschikbaarheid gebaseerd op de live-status van de agent, in plaats van de gesynchroniseerde status die in het raster wordt weergegeven.

Opnieuw toewijzen

Sommige organisaties vereisen dat agenten eigenaren hebben voor compliancedoeleinden. De eigenaar kan de agent bewerken, updates publiceren, verwijderen of delen met teamgenoten volgens hun rechten.

Selecteer Hertoewijzen en kies een gebruiker met een Microsoft 365 Copilot-licentie. Voor bulkhertoewijzing toont het dialoogvenster de geselecteerde omgevingen, agenten, huidige eigenaren en operationele status. Na voltooiing van de hertoewijzing wordt de status van de hertoewijzing als voltooid weergegeven voor elke succesvol verwerkte agent.

In quarantaine plaatsen en uit quarantaine halen

Quarantaine blokkeert een geschikte agent. Uit quarantaine halen herstelt een geblokkeerde agent die hiervoor in aanmerking komt. Bevestigingsdialoog identificeert de getroffen agenten, omgevingen en statussen voordat een operatie wordt ingediend.

Bulkacties ondersteunen tot 50 agenten per operatie en zijn alleen beschikbaar wanneer elk geselecteerd record in aanmerking komt.

Agentinventaris configureren

Selecteer Instellingen in de dashboardheader om de Agent-synchronisatieconfiguratie te openen. Gebruik het om te controleren welke omgevingen en agenttypes worden verzameld, pas de inventarisopties aan en stel het synchronisatieschema en de verzamelmodus in.

Note

Deze instellingen in de app gaan ervan uit dat de vereiste verbindingsreferenties van de oplossing al zijn geconfigureerd. Lees meer over het aansluiten van de verbindingsreferenties in Configure Agent Inventory.

Omgevingstypen

Kies welke omgevingstypen worden gescand:

Developer
Default
Zandbak
Productie
Proefversie
Teams

Als je geen omgevingstype selecteert, bevat het systeem alle omgevingstypen.

Agenttypen

Kies of de inventaris het volgende bevat:

Op maat gemaakte agenten
Declaratieve agents

Als je geen agententype selecteert, bevat de inventaris alle agenttypen.

Omgevingsgroepen

Omgevingsgroepen bieden herbruikbare synchronisatiebereiken. Als beheerder kunt u het volgende doen:

Maak een groep aan en bewerk deze.
Selecteer lidomgevingen door gebruik te maken van omgevingstype- en regiofilters.
Schakel de groep in of uit.
Verwijder een groep die je niet meer nodig hebt.

Als je een groep niet inschakelt, zijn alle omgevingen die door de andere instellingen zijn toegestaan inbegrepen.

Voorraadopties

Stel de volgende opties in om te bepalen wat het systeem verzamelt tijdens synchronisatie:

Systeemagenten uitsluiten: Slaat Microsoft-geleverde systeemagenten over tijdens synchronisatie.
Schakel door AI gegenereerde beschrijving in voor GitHub Copilot-agenten: Maakt het genereren van beschrijvingen mogelijk wanneer een pagina met details van een geschikte agent wordt bezocht.
Gebruiksstatistieken opnemen: Verzamelt het bewaarde gebruiksvenster van 180 dagen tijdens de synchronisatie.

Synchronisatieschema en verzamelmodus

Kies hoe synchronisatie verloopt en welke dataverzamelmodus je gebruikt:

One Inventory (Power Platform admin center): Combineert administratiecentruminventaris met omgevingsdata voor bredere ontdekking en rijkere metadata.
Standaard (alleen omgevingen): Haalt de inventaris direct op uit toegankelijke omgevingen.
Schakel dagelijkse automatische synchronisatie in: Voert Agent Inventory uit op het geconfigureerde dagelijkse schema.

Selecteer Opslaan om wijzigingen toe te passen. Slaan is uitgeschakeld wanneer er geen instellingen zijn gewijzigd, wanneer het opslaan bezig is of wanneer instellingen niet beschikbaar zijn tijdens een actieve synchronisatie.

Aanbeveling

Gebruik Dashboardgegevens verversen na een voltooide synchronisatie wanneer het dashboard bestaande tabelgegevens opnieuw moet laden. Gebruik Sync-agenten alleen wanneer de inventarisverzameling opnieuw moet worden uitgevoerd. Houd omgevings- en agentfilters zo smal mogelijk in zeer grote tenants, en schakel gebruiksverzameling uit wanneer 180-dagen gebruiksanalyse niet nodig is.

Gegevensverzamelingsmodi

De instelling voor gegevensverzamelingsmodus bepaalt hoe het systeem agentrecords ontdekt en verzamelt.

Eén inventarismodus (aanbevolen)

Wanneer je de verzamelmodus op Eén Inventaris zet, gebruikt Agent Inventory Eén Inventarisgegevens:

Het haalt agentgegevens op van One Inventory via het Power Platform admin center.
Het geeft omgevingen weer met behulp van de Copilot Agent Kit - Power Platform for Admins V2 verbindingsreferentie.
Het combineert de gegevens van de One Inventory-agent met de omgevingslijst om omgevingsdetails te construeren.
Voor elke omgeving laadt het agentgegevens in de Agent Inventory door agenten die uit de omgeving zijn gehaald te combineren met de bijbehorende One Inventory-gegevens.

Gebruik deze modus wanneer je bredere tenant-ontdekking en rijkere Power Platform admin center metadata nodig hebt. Agenten die via het administratiecentrum worden ontdekt maar niet toegankelijk zijn in hun omgeving, worden nog steeds toegevoegd met beperkte details.

Standaardmodus

Wanneer je de verzamelmodus op Standaard zet, gebruikt Agent Inventory de standaard dataverzamelingsmethode:

Het geeft alle omgevingen weer met behulp van de Copilot Agent Kit - Power Platform for Admins verbindingsreferentie (V1).
Het haalt agenten op voor elke omgeving.
Het laadt agentgegevens in de Agent Inventory.

Gebruik deze modus wanneer je wilt dat verzameling alleen afhankelijk is van toegankelijke omgevingen.

In beide modi gebruikt Agent Inventory de Copilot Agent Kit - Dataverse-verbindingsreferentie om verbinding te maken met elke omgeving en gedetailleerde agentinformatie te verzamelen, waaronder metadata, functiegebruik en configuratie. Het systeem haalt gedetailleerde informatie alleen op voor omgevingen waar het geconfigureerde account systeembeheerderstoegang heeft.

Lees meer over de volledige lijst van connectoren die in de kit worden gebruikt in Connectorvereisten.

Metrische gebruiksgegevens

Agent Inventory kan tot 180 dagen aan agentgebruiksgegevens behouden en weergeven. Om gebruiksanalyse mogelijk te maken:

Zorg ervoor dat de benodigde oplossingsverbindingen zijn geconfigureerd en toegestaan volgens databeleid.
Open agentsynchronisatieconfiguratie.
Schakel Gebruiksgegevens opnemen in.
Selecteer Opslaan.
Selecteer Sync agents, of wacht op de dagelijkse automatische synchronisatie.

Gebruiksgegevens worden opgeslagen in de tabellen Agent Details en Agent Usage History . Het tabblad Usage van een agent verschijnt alleen wanneer er overeenkomende gebruiksgeschiedenisrecords beschikbaar zijn.

Configureer de HTTP met de Microsoft Entra ID-verbinding

Gebruiksstatistieken zijn afhankelijk van de HTTP met Microsoft Entra ID (vooraf geautoriseerde) connector. De verbindingswaarden hangen af van de cloud waarin je tenant draait. Gebruik de Base Resource URL en de Microsoft Entra ID Resource URI die overeenkomen met je cloud wanneer je de verbinding aanmaakt.

Wolk	URL van basisresource	Microsoft Entra ID Resource URI
Zakelijk	`https://licensing.powerplatform.microsoft.com/`	`https://licensing.powerplatform.microsoft.com/`
GCC	`https://gov.licensing.powerplatform.microsoft.us/`	`https://gov.licensing.powerplatform.microsoft.us/`
GCC High	`https://high.licensing.powerplatform.microsoft.us/`	`https://high.licensing.powerplatform.microsoft.us/`

Machtigingen en vereisten voor connectors

De verbindingsverwijzingen in de oplossing beperken en de zichtbaarheid van de agents beheren. Voor volledige tenantbrede zichtbaarheid configureer je de verbindingsreferenties met een account dat de Power Platform-beheerderrol heeft. Om alle feature-level details op te halen, heeft dat account ook systeembeheerderstoegang nodig tot de relevante omgevingen. U kunt andere accounts gebruiken, maar de zichtbaarheid van de agentinventaris is beperkt tot de omgevingen waar de gebruiker systeembeheerderstoegang heeft.

Agent Inventory is gebaseerd op de volgende connectoren, die moeten worden toegestaan door het gegevensbeleid dat op de omgeving is toegepast:

Microsoft Dataverse
Power Platform voor beheerders
Power Platform voor beheerders V2
HTTP met Microsoft Entra-id (vooraf geverifieerd)