Övervaka agenter genom att använda Agent Inventory i Copilot Agent Kit

Funktionen Agent Inventory ger administratörer hyresgästövergripande insyn i alla Copilot Studio-anpassade agenter och deklarativa agenter i organisationen, över olika miljöer. Data från agentinventariet inkluderar livscykel- och ägarmetadata, konfigurations- och kapabilitetsadoptionssignaler, styrningsindikatorer och användningsmått.

Dashboard

Agent Inventory-dashboarden ger dig en hyresgästövergripande sammanfattning och genomgångsnavigering i inventariet. Välj en ruta, diagram eller listobjekt för att öppna en filtrerad vy i agentens rutnät.

Inventariekontext

Statusraden högst upp på instrumentpanelen visar det aktuella läget för inventariet:

• Oavsett om inventariet är aktuellt, tomt eller om en synkronisering pågår.
• Andelen poster berikades med detaljerad konfiguration.
• Antalet agenter med begränsade uppgifter.
• Antalet synkroniserade miljöer.
• Den sista lyckade synkroniseringstiden, när den är tillgänglig.

Portföljmått

De metriska rutorna hjälper dig att hoppa direkt in i viktiga segment av inventariet:

• Antal agenter
• Drivs av
• Autonoma agenter
• Utkastsagenter
• Agenter med kunskap

Välj en ruta för att öppna agentens rutnät filtrerat till det segmentet. Powered by-tilen grupperar agenter i kategorier som Standard, GitHub Copilot och Copilot Chat.

Analys och styrning

Instrumentpanelen innehåller också diagram och listor som hjälper dig att upptäcka mönster och risker:

• Portföljtillväxt med sexmånaders- och tolvmånadersintervall.
• Autentiseringsdistribution .
• Styrningsprioriteringar som kräver administratörsgranskning.
• Portföljstatusfördelning .
• Införande av funktioner i utökade agenter.
• Toppmiljöer rankade efter antal agenter.
• Agenter att övervaka för poster som kräver åtgärd.

Procentandelar beror på vilka miljöer de konfigurerade anslutningsidentiteterna kan hämta agentdata och detaljerad konfiguration. Läs mer i datainsamlingslägen.

Bläddra bland alla agenter

Välj Visa hela inventariet från instrumentpanelen för att öppna agentens rutnät. Använd rutnätet för att hitta, gruppera och exportera inventariedata.

Du kan filtrera, sortera och gruppera efter vilken kolumn som helst, lägga till eller ta bort kolumner för att anpassa rutnätet efter dina behov, och exportera den aktuella vyn till Excel.

Agentinformation

Välj ett agentnamn från rutnätet för att öppna agentdetaljer. Headern visar agentens identitet, miljökontext, livscykelstatus, ägarskap och tillgängliga åtgärder. En informationsbanner visar om posten har full Dataverse-berikning eller endast begränsade konfigurationsdetaljer.

Fliken Översikt

Fliken Översikt visar agentens sammanfattning och miljöinformation, styrningsposition och signaler, samt en användningsöversikt när användningshistorik finns. Om AI-genererade beskrivningar är aktiverade och agenten är en berättigad GitHub Copilot-agent, visas även en AI-genererad beskrivning.

Fliken Komponenter

Komponentfliken visas endast när komponentdata är tillgänglig för agenten. Använd denna flik för att utforska agentarkitekturen i Komponentkartvyn , bläddra bland kategoriserat innehåll i Komponentgruppvyn , expandera en fylld komponentgrupp åt gången, slå på Raw-läge för att inspektera JSON, eller kopiera komponent-JSON för undersökning eller support.

Fliken Användning

Fliken Användning visas endast när användningsposter finns för agenten. Den innehåller:

• Månads-hittills-datum, de två föregående kalendermånaderna, de sista tre månaderna och de senaste sex månaderna. Sista sex månaderna väljs som standard.
• Totalt antal poäng för Copilot och genomsnittligt antal poäng per aktiv vecka.
• Rapporterade användare och primär användningsfunktion.
• Veckovisa trender för kredit
• Användningshöjdpunkter, krediter per funktion och kanal, samt senaste användningsregister.
• En Excel-export för en specifik agent.

Metadataflik

Metadata-fliken är alltid tillgänglig. Använd den för att inspektera tekniska värden såsom agent-ID och schemanamn, miljö-ID och URL, plats- och källidentifierare samt de råa inventariefälten som används för diagnostik och integration.

Synkronisera eller uppdatera inventariedata

Agent Inventory skiljer synkronisering från uppdatering av instrumentpanelen.

Synkroniseringsagenter

Välj Sync-agenter när du behöver samla in hyresgästinventariet igen. Synkroniseringen följer filter, miljögrupper, datainsamlingsläge, användningsinställningar och schema som sparats i Configure Agent Inventory.

Medan en synkronisering pågår:

• Inventariestatusen ändras till Synkronisering pågår.
• Sync agents är inaktiverat för att förhindra dubbletter av operationer.
• Inställningar som kan ändra den aktiva synkroniseringskonfigurationen är inte tillgängliga.
• Instrumentpanelen laddar om agentdetaljer, användningshistorik, synkroniseringsstatus och senast synkroniserad information efter att synkroniseringen är klar.

Uppdatera instrumentpanelens data

Välj Uppdatera dashboarddata för att ladda om data som redan lagrats i tabellerna Agent Details och Agent Usage History . Refresh startar inte en Agent Sync och återupptäcker inte miljöer eller agenter. Använd den efter en slutförd synkronisering, eller när instrumentpanelen visar föråldrad cachad data.

Styrningsåtgärder

Agent Inventory stöder omfördelning, karantän och avkarantänåtgärder . Åtgärder visas endast när varje vald agent är berättigad.

Åtgärdstillgänglighet

Statuskolumnen i rutnätet fylls i under den senaste inventariesynkroniseringen och speglar värdet från Power Platforms admincenter (One Inventory-data). Vilka handlingar som visas beror på hur många poster du väljer och deras status.

Om någon markerad post inte är kompatibel med en åtgärd döljs åtgärden i kommandofältet. Poster vars kontext i Power Platform-administratörscenter inte matchar inventeringsmiljön erbjuds inte styrningsåtgärder som inte stöds.

På sidan för agentens detaljer baseras tillgängligheten på karantän och avkarantän på agentens live-status, snarare än den synkroniserade status som visas i rutnätet.

Omfördela

Vissa organisationer kräver att agenter har ägare för efterlevnadsändamål. Ägaren kan redigera agenten, publicera uppdateringar, ta bort den eller dela den med lagkamrater enligt deras behörigheter.

Välj Omfördela och välj en användare som har en Microsoft 365 Copilot-licens. För massomfördelning visar dialogen de valda miljöerna, agenterna, nuvarande ägare och driftsstatus. Efter att omplaceringen är slutförd visas omplaceringsstatusen som slutförd för varje framgångsrikt behandlad agent.

Karantän och avkarantän

Karantän blockerar en kvalificerad agent. Ta bort karantän återställer en kvalificerad blockerad agent. Bekräftelsedialogen identifierar de berörda agenterna, miljöerna och statuserna innan en operation skickas in.

Massåtgärder har stöd för upp till 50 agenter i varje åtgärd och är bara tillgängliga när varje markerad post uppfyller kraven.

Konfigurera inventering för agenter

Välj Inställningar från dashboard-headern för att öppna Agent-synkroniseringskonfiguration. Använd den för att kontrollera vilka miljöer och agenttyper som samlas in, justera inventariealternativ och ställ in synkroniseringsschema och insamlingsläge.

Miljötyper

Välj vilka miljötyper som ska skannas:

• Developer
• Förinställning
• Sandlåda
• Produktion
• Rättegång
• Teams

Om du inte väljer en miljötyp inkluderar systemet alla miljötyper.

Agenttyper

Välj om inventariet inkluderar:

• Anpassade agenter
• Deklarativa agenter

Om du inte väljer en agenttyp inkluderar inventariet alla agenttyper.

Miljögrupper

Miljögrupper erbjuder återanvändbara synkroniseringsområden. Som administratör kan du:

• Skapa och redigera en grupp.
• Välj medlemsmiljöer genom att använda miljötyp- och regionfilter.
• Aktivera eller inaktivera gruppen.
• Radera en grupp som du inte längre behöver.

Om du inte aktiverar en grupp inkluderas alla miljöer som tillåts av de andra inställningarna.

Inventariealternativ

Ställ in följande alternativ för att styra vad systemet samlar in under synkroniseringen:

• Exkludera systemagenter: Hoppar över systemagenter som tillhandahållits av Microsoft under synkronisering.
• Aktivera AI-genererad beskrivning för GitHub Copilot-agenter: Tillåter beskrivningsgenerering när en sida med kvalificerade agentdetaljer besöks.
• Inkludera användningsmått: Samlar in det behållna 180-dagarsfönstret under synkronisering.

Synkroniseringsschema och insamlingsläge

Välj hur synkroniseringen går till och vilket datainsamlingsläge du ska använda:

• One Inventory (Power Platform admin center): Kombinerar administrationscenterinventarium med miljödata för bredare upptäckt och rikare metadata.
• Standard (endast miljöer): Hämtar inventarie direkt från tillgängliga miljöer.
• Aktivera daglig automatisk synkronisering: Kör Agent Inventory på det konfigurerade dagliga schemat.

Välj Spara för att tillämpa ändringarna. Sparfilen är inaktiverad när ingen inställning ändrats, när en sparfil pågår, eller när inställningar inte är tillgängliga under en aktiv synkronisering.

Datainsamlingslägen

Inställningen Datainsamlingsläge avgör hur systemet identifierar och samlar in agentposter.

One Inventory-läge (rekommenderas)

När du sätter insamlingsläget till One Inventory använder Agent Inventory One Inventory-data:

1. Den hämtar agentdata från One Inventory via Power Platform-administrationscentret.
2. Den listar miljöer genom att använda Copilot Agent Kit - Power Platform for Admins V2-anslutningsreferensen.
3. Den kombinerar One Inventory-agentdata med miljölistan för att konstruera miljödetaljer.
4. För varje miljö laddar den agentdetaljer in i Agent Inventory genom att slå ihop agenter hämtade från miljön med motsvarande One Inventory-data.

Använd detta läge när du behöver bredare tenant-upptäckt och rikare Power Platform-admincentermetadata. Agenter som upptäcks via administrationscentret men är otillgängliga i sin miljö läggs fortfarande till med begränsade detaljer.

Standardläge

När du sätter insamlingsläget till Standard använder Agent Inventory standarddatainsamlingsmetoden:

1. Den listar alla miljöer genom att använda Copilot Agent Kit - Power Platform for Admins anslutningsreferens (V1).
2. Den hämtar agenter för varje miljö.
3. Den laddar agentdata i Agent Inventory.

Använd detta läge när du vill att samlingen bara ska förlita sig på tillgängliga miljöer.

I båda lägena använder Agent Inventory Copilot Agent Kit - Dataverse-anslutningsreferensen för att ansluta till varje miljö och samla in detaljerad agentinformation, inklusive metadata, funktionsanvändning och konfiguration. Systemet hämtar detaljerad information endast för miljöer där det konfigurerade kontot har systemadministratörsbehörighet.

Läs mer om hela listan över kontakter som används i hela kiteten i Connector-krav.

Användningsstatistik

Agent Inventory kan behålla och visa upp till 180 dagars data om agentanvändning. För att möjliggöra användningsanalys:

1. Säkerställ att de nödvändiga lösningsanslutningarna är konfigurerade och tillåtna enligt datapolicys.
2. Konfiguration av öppen agentsynkronisering.
3. Slå på Inkludera användningsmått.
4. Välj Spara.
5. Välj Sync-agenter, eller vänta på den dagliga automatiska synkroniseringen.

Användningsdata lagras i tabellerna Agent Details och Agent Usage History . Fliken Användning för en agent visas endast när matchande poster i användningshistoriken är tillgängliga.

Konfigurera HTTP med Microsoft Entra ID-anslutningen

Användningsmått bygger på anslutningsprogrammet HTTP med Microsoft Entra ID (förauktoriserat). Anslutningsvärdena beror på vilket moln din klientorganisation finns i. Använd Base Resource URL och Microsoft Entra ID Resource URI som matchar ditt moln när du skapar anslutningen.

Behörigheter och anslutningskrav

Anslutningsreferenserna i lösningen begränsar och kontrollerar synligheten för agenterna. För fullständig synlighet i hela klientorganisationen konfigurerar du anslutningsreferenserna med ett konto som har rollen Power Platform-administratör. För att hämta alla funktionsnivådetaljer behöver kontot också systemadministratörsåtkomst till relevanta miljöer. Du kan använda andra konton, men synligheten för agentinventeringen är begränsad till de miljöer där användaren har systemadministratörsåtkomst.

Agent Inventory bygger på följande anslutningar, som de datapolicyer som tillämpas i miljön måste tillåta:

• Microsoft Dataverse
• Power Platform för administratörer
• Power Platform för administratörer V2
• HTTP med Microsoft Entra-ID (förauktoriserat)

Läs mer om hela listan över kontakter som används i hela kiteten i Connector-krav.

Följande Dataverse-tabeller lagrar agentinventariedata:

Nästa steg

Relaterad information

• Datakälla för agentinventering
• Konfigurera Agent Inventory-anslutningsreferenser
• Krav på kontakter