Overvåk agenter ved å bruke Agent Inventory i Copilot Agent Kit

Agent Inventory-funksjonen gir administratorer leietakeromfattende innsikt i alle Copilot Studio-tilpassede agenter og deklarative agenter i organisasjonen, på tvers av miljøer. Agent Inventory-data inkluderer livssyklus- og eierskapsmetadata, konfigurasjons- og kapabilitetsadopsjonssignaler, styringsindikatorer og bruksmålinger.

Bemerkning

Denne artikkelen beskriver den nåværende opplevelsen av Agent Inventory. Den tidligere erfaringen er dokumentert i Copilot Agent Kit-repositoriet på GitHub i AGENT_INVENTORY_V1.md-filen.

Instrumentbord

Agent Inventory-dashbordet gir deg et leietakeromfattende sammendrag og gjennomgående navigasjon inn i inventaret. Velg en flis, et diagram eller et listeelement for å åpne en filtrert visning i agentens rutenett.

Skjermbilde av Agent Inventory-dashbordet som viser inventarkontekst, porteføljemålinger og analysefliser.

Inventarkontekst

Statusraden øverst på dashbordet viser den nåværende statusen til inventaret:

  • Enten inventaret er oppdatert, tomt, eller en synkronisering pågår.
  • Prosentandelen poster beriket med detaljert konfigurasjon.
  • Antallet agenter med begrensede detaljer.
  • Antallet synkroniserte miljøer.
  • Den siste vellykkede synkroniseringstiden, når tilgjengelig.

Porteføljemålinger

De metriske flisene hjelper deg å hoppe direkte inn i viktige segmenter av inventaret:

  • Antall agenter
  • Drevet av
  • Autonome agenter
  • Draftagenter
  • Agenter med kunnskap

Velg en flis for å åpne agentens rutenett filtrert til det segmentet. Powered by-flisen grupperer agenter i kategorier som Standard, GitHub Copilot og Copilot Chat.

Analyse og styring

Dashbordet inkluderer også diagrammer og lister som hjelper deg å oppdage mønstre og risikoer:

  • Porteføljevekst med seksmåneders- og tolvmånedersintervaller.
  • Autentiseringsdistribusjon .
  • Styringsprioriteringer som krever gjennomgang av administratorer.
  • Fordeling av porteføljestatus .
  • Innføring av funksjoner på tvers av berikede agenter.
  • Toppmiljøer rangert etter antall agenter.
  • Agenter må følge med på dokumenter som krever oppmerksomhet.

Skjermbilde av agentene å følge med på på Agent Inventory-dashbordet.

Prosentandeler avhenger av hvilke miljøer de konfigurerte tilkoblingsidentitetene kan hente agentdata og detaljert konfigurasjon for. Lær mer i datainnsamlingsmoduser.

Bla gjennom alle agenter

Velg Vis fullstendig inventar fra dashbordet for å åpne agentens rutenett. Bruk rutenettet til å finne, gruppere og eksportere inventardata.

Skjermbilde av Agent Inventory-agentens rutenett med filter-, sorterings-, gruppe- og kolonnetilpasningsmuligheter.

Du kan filtrere, sortere og gruppere etter hvilken som helst kolonne, legge til eller fjerne kolonner for å tilpasse rutenettet til dine behov, og eksportere den nåværende visningen til Excel.

Agentdetaljer

Velg et agentnavn fra rutenettet for å åpne agentdetaljer. Headeren viser agentens identitet, miljøkontekst, livssyklusstatus, eierskap og tilgjengelige handlinger. Et informasjonsbanner forteller deg om posten har full Dataverse-berikelse eller kun begrensede konfigurasjonsdetaljer.

Skjermbilde av agentens detaljside som viser agentens header og Oversikt-fanen.

Oversikt-fanen

Oversikt-fanen viser agentens sammendrag og miljøinformasjon, styringsposisjon og signaler, samt et bruksøyeblikksbilde når brukshistorikk eksisterer. Hvis AI-genererte beskrivelser er aktivert og agenten er en kvalifisert GitHub Copilot-agent, vises også en AI-generert beskrivelse.

Fanen Komponenter

Fanen Components vises kun når komponentdata er tilgjengelig for agenten. Bruk denne fanen for å utforske agentarkitekturen i Komponentkartvisningen , bla gjennom kategorisert innhold i Komponentgruppevisningen , utvide én utfylt komponentgruppe om gangen, slå på Raw-modus for å inspisere JSON, eller kopiere komponent-JSON for undersøkelse eller støtte.

Skjermbilde av fanen Komponenter, på Agent-detaljsiden i Komponentkartvisning.

Skjermbilde av fanen Komponenter, på Agent-detalj-siden i Komponent-gruppevisning.

Fanen Bruk

Brukerfanen vises kun når bruksposter finnes for agenten. Den omfatter:

  • Måned til dags dato, de to foregående kalendermånedene, de siste tre månedene og de siste seks månedene. De siste seks månedene velges som standard.
  • Totalt antall Copilot-poeng og gjennomsnittlig studiepoeng per aktiv uke.
  • Rapporterte brukere og primær bruksfunksjon.
  • Ukentlig kredittutvikling.
  • Brukshøydepunkter, krediteringer etter funksjon og kanal, samt nylige brukslogger.
  • En agent-spesifikk Excel-eksport.

Skjermbilde av fanen Bruk, på siden for agentdetaljer, som viser overskriftsmålinger og ukentlige kreditttrender.

Skjermbilde av fanen Bruk, på agentens detaljside, som viser kreditter etter funksjon og kanal samt nylige bruksposter.

Fanen Metadata

Metadata-fanen er alltid tilgjengelig. Bruk den til å inspisere tekniske verdier som agent-ID og skjemanavn, miljø-ID og URL, lokasjons- og kildeidentifikatorer, samt rå inventarfelt brukt til diagnostikk og integrasjon.

Skjermbilde av Metadata-fanen på Agent Details-siden som viser tekniske identifikatorer og rå inventarfelt.

Synkroniser eller oppdater lagerdata

Agent Inventory skiller synkronisering fra dashbordoppdatering.

Synkroniseringsagenter

Velg Sync-agenter når du trenger å samle inn leietakerinventaret på nytt. Synkroniseringen følger filtre, miljøgrupper, datainnsamlingsmodus, bruksinnstillinger og tidsplan lagret i Configure Agent Inventory.

Mens en synkronisering kjører:

  • Inventarstatusen endres til Synkronisering underveis.
  • Synkroniseringsagenter er deaktivert for å forhindre dupliserte operasjoner.
  • Innstillinger som kan endre den aktive synkroniseringskonfigurasjonen er ikke tilgjengelige.
  • Dashbordet laster inn agentdetaljer, brukshistorikk, synkroniseringsstatus og sist synkronisert informasjon etter at synkroniseringen er etablert.

Oppdater dashborddata

Velg Oppdater dashborddata for å laste inn data som allerede er lagret i tabellene Agent Detaljer og Agent Usage History . Refresh starter ikke en Agent Sync og gjenoppdager ikke miljøer eller agenter. Bruk den etter fullført synkronisering, eller når dashbordet viser utdaterte bufret data.

Important

Agentsynkronisering bruker ikke Copilot-kreditter. Kreditter brukes kun når AI-genererte beskrivelser er aktivert og en kvalifisert GitHub Copilot-agent-detaljside besøkes.

Styringshandlinger

Agent Inventory støtter omfordeling, karantene og avkarantene-handlinger . Handlinger vises kun når alle valgte agenter er kvalifisert.

Skjermbilde av bulkstyringshandlinger på Agent Inventory-agentens rutenett.

Handlingstilgjengelighet

Statuskolonnen i rutenettet fylles ut under siste inventar-synkronisering og gjenspeiler verdien som kommer fra Power Platform-administrasjonssenteret (One Inventory-data). Hvilke handlinger som vises avhenger av hvor mange poster du velger og deres status.

Tiltak Utvalgsregel Skjult når
Tilordne på nytt Én eller flere poster (opptil maksimalt 50) kan velges. Enhver valgt agent er ikke kvalifisert for omplassering.
Karantene En eller flere poster i Draft- eller Available-status (opptil maksimalt 50) kan velges. Enhver valgt agent er blokkert eller ikke kvalifisert for karantene.
Ikke-karantene Én eller flere poster i blokkert status (opptil maksimalt 50) kan velges. Alle valgte agenter er Utkast, Tilgjengelig, eller kan ikke tas ut av karantene.

Hvis en valgt post er inkompatibel med en operasjon, skjules den operasjonen fra kommandolinjen. Poster hvis Power Platform administrasjonssenterkontekst ikke samsvarer med inventarmiljøet, tilbys ikke ustøttede styringshandlinger.

På agentens detaljside baseres tilgjengeligheten på karantene og avkarantene på agentens live-status, i stedet for den synkroniserte statusen som vises i rutenettet.

Tilordne på nytt

Noen organisasjoner krever at agenter har eiere for å overholde reglene. Eieren kan redigere agenten, publisere oppdateringer, slette den eller dele den med lagkamerater i henhold til deres tillatelser.

Velg Omfordeling og velg en bruker som har Microsoft 365 Copilot-lisens. For masseomfordeling viser dialogen valgte miljøer, agenter, nåværende eiere og driftsstatus. Etter at omfordelingen er fullført, vises omfordelingsstatusen som fullført for hver vellykket behandlet agent.

Skjermbilde av bulk-omfordelingsdialogen som viser valgte miljøer, agenter, nåværende eiere og status.

Karantene og avkarantene

Karantene blokkerer en kvalifisert agent. Fjern fra karantene gjenoppretter en kvalifisert blokkert agent. Bekreftelsesdialogen identifiserer de berørte agentene, miljøene og statusene før en operasjon sendes inn.

Skjermbilde av bulk-karantenebekreftelsesdialogen som viser berørte agenter, miljøer og nåværende status.

Masseaksjoner støtter opptil 50 agenter per operasjon og er kun tilgjengelige når alle valgte poster er kvalifisert.

Konfigurer agentlager

Velg Innstillinger fra dashbordheaderen for å åpne Agent-synkroniseringskonfigurasjon. Bruk den til å kontrollere hvilke miljøer og agenttyper som samles inn, juster lagerinnstillinger, og sett synkroniseringsplan og innsamlingsmodus.

Skjermbilde av siden for innstillinger for agentsynkronisering.

Bemerkning

Disse innstillingene i appen forutsetter at de nødvendige løsningstilkoblingsreferansene allerede er satt opp. Lær mer om hvordan du kobler tilkoblingsreferansene i Configure Agent Inventory.

Miljøtyper

Velg hvilke miljøtyper som skal skannes:

  • Developer
  • Forhåndsinnstilt
  • Sandkasse
  • Produksjon
  • Prøveabonnement
  • Teams

Hvis du ikke velger en miljøtype, inkluderer systemet alle miljøtyper.

Agenttyper

Velg om inventaret inkluderer:

  • Egendefinerte agenter
  • Deklarative agenter

Hvis du ikke velger en agenttype, inkluderer inventaret alle agenttyper.

Miljøgrupper

Miljøgrupper gir gjenbrukbare synkroniseringsområder. Som administrator kan du gjøre følgende:

  • Lag og rediger en gruppe.
  • Velg medlemsmiljøer ved å bruke miljøtype- og regionfiltre.
  • Slå på eller deaktiver gruppen.
  • Slett en gruppe du ikke lenger trenger.

Hvis du ikke aktiverer en gruppe, er alle miljøer som er tillatt av de andre innstillingene inkludert.

Skjermbilde av konfigurasjonen av miljøgruppene på siden for agentsynkronisering.

Lageralternativer

Sett følgende innstillinger for å kontrollere hva systemet samler inn under synkronisering:

  • Ekskluder systemagenter: Hopper over systemagenter levert av Microsoft under synkronisering.
  • Aktiver AI-generert beskrivelse for GitHub Copilot-agenter: Tillater beskrivelsesgenerering når en liste med detaljer om kvalifiserte agenter besøkes.
  • Inkluder bruksmålinger: Samler inn det beholdte 180-dagers bruksvinduet under synkronisering.

Ta et skjermbilde av inventarvalgene og konfigurasjonen av synkroniseringsplanen på siden for Agentens synkroniseringskonfigurasjon.

Synkroniseringsplan og innsamlingsmodus

Velg hvordan synkronisering kjører og hvilken datainnsamlingsmodus du skal bruke:

  • One Inventory (Power Platform administrasjonssenter): Kombinerer administrasjonssenterinventar med miljødata for bredere oppdagelse og rikere metadata.
  • Standard (kun miljøer): Henter inventardata direkte fra tilgjengelige miljøer.
  • Aktiver daglig automatisk synkronisering: Kjører Agent Inventory på den konfigurerte daglige planen.

Velg Lagre for å bruke endringer. Lagring er deaktivert når ingen innstilling endres, når en lagring pågår, eller når innstillinger ikke er tilgjengelige under en aktiv synkronisering.

Tips

Bruk oppdater dashborddata etter fullført synkronisering når dashbordet må laste inn eksisterende tabelldata. Bruk Sync-agenter kun når inventarinnsamling må kjøres på nytt. Hold miljø- og agentfiltre så snevre som praktisk i svært store leietakere, og deaktiver forbruksinnsamling når 180-dagers bruksanalyse ikke er nødvendig.

Datainnsamlingsmoduser

Datainnsamlingsmodus-innstillingen bestemmer hvordan systemet oppdager og samler inn agentposter.

Når du setter innsamlingsmodusen til One Inventory, bruker Agent Inventory One Inventory-data:

  1. Den henter agentdata fra One Inventory gjennom Power Platform-administrasjonssenteret.
  2. Den lister miljøer ved å bruke Copilot Agent Kit - Power Platform for Admins V2-tilkoblingsreferansen.
  3. Den kombinerer One Inventory-agentdata med miljølisten for å konstruere miljødetaljer.
  4. For hvert miljø lastes agentdetaljer inn i Agent Inventory ved å slå sammen agenter hentet fra miljøet med tilsvarende One Inventory-data.

Bruk denne modusen når du trenger bredere leietakeroppdagelse og rikere Power Platform-administrasjonssentermetadata. Agenter oppdaget gjennom administrasjonssenteret, men utilgjengelige i sitt miljø, legges fortsatt til med begrensede detaljer.

Standardmodus

Når du setter innsamlingsmodusen til Standard, bruker Agent Inventory standard datainnsamlingsmetode:

  1. Den lister alle miljøer ved å bruke Copilot Agent Kit - Power Platform for Admins tilkoblingsreferanse (V1).
  2. Den henter agenter for hvert miljø.
  3. Den laster agentdata inn i Agent Inventory.

Bruk denne modusen når du vil at samlingen kun skal baseres på tilgjengelige miljøer.

I begge moduser bruker Agent Inventory Copilot Agent Kit - Dataverse-tilkoblingsreferansen for å koble til hvert miljø og samle detaljert agentinformasjon, inkludert metadata, funksjonsbruk og konfigurasjon. Systemet henter detaljert informasjon kun for miljøer hvor den konfigurerte kontoen har systemadministrator-tilgang.

Lær mer om den fullstendige listen over kontakter som brukes på tvers av settet i Connector-krav.

Bruksmåledata

Agent Inventory kan lagre og vise opptil 180 dager med agentbruksdata. For å muliggjøre bruksanalyse:

  1. Sørg for at nødvendige løsningstilkoblinger er konfigurert og tillatt i henhold til datapolicyer.
  2. Åpen agent-synkroniseringskonfigurasjon.
  3. Slå på Inkluder bruksmålinger.
  4. Velg Lagre.
  5. Velg Sync-agenter, eller vent på den daglige automatiske synkroniseringen.

Bruksdata lagres i tabellene Agent Details og Agent Usage History . Fanen Bruk for en agent vises kun når samsvarende bruksloggoppføringer er tilgjengelige.

Konfigurer HTTP med Microsoft Entra ID-tilkoblingen

Bruksmetrikker er avhengige av HTTP med Microsoft Entra ID (forhåndsautorisert) kobling. Tilkoblingsverdiene avhenger av hvilken sky leietakeren din kjører i. Bruk Base Resource URL og Microsoft Entra ID Resource URI som matcher skyen din når du oppretter tilkoblingen.

Skyen Grunnressurs-URL Microsoft Entra ID Resource URI
Kommersielle 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/

Tillatelser og tilkoblingskrav

Tilkoblingsreferansene i løsningsgrensen og kontrollsynligheten til agentene. For full oversikt over hele leietakeren, konfigurer tilkoblingsreferansene med en konto som har Power Platform-administratorrollen . For å hente alle funksjonsnivå-detaljer trenger den kontoen også systemadministrator-tilgang til de relevante miljøene. Du kan bruke andre kontoer, men synligheten til agentbeholdningen er begrenset til miljøene der brukeren har tilgang til systemansvarlig.

Agent Inventory er avhengig av følgende koblinger, som datapolicyene som anvendes på miljøet må tillate:

  • Microsoft Dataverse
  • Power Platform for administratorer
  • Power Platform for administratorer V2
  • HTTP med Microsoft Entra ID (forhåndsautorisert)

Lær mer om den fullstendige listen over kontakter som brukes på tvers av settet i Connector-krav.

Følgende Dataverse-tabeller lagrer Agent Inventory-data:

Tabell Formål
cat_agentdetails Oppdagede agenter, metadata, kapabiliteter, eierskap og synkronisert status
cat_agentusagehistory Beholdt bruksdimensjoner og Copilot-kredittverdier
cat_agentinventorysettings Inventarfiltre, modus og funksjonsinnstillinger
cat_environmentgroups Omfang for gjenbrukbare miljøer
cat_agentinventoryactionaudit Sporing av styringshandlinger
cat_copilotstudiokitlogs Funksjons- og driftslogging

Neste trinn: