Overvåg agenter ved at bruge Agent Inventory i Copilot Agent Kit

Funktionen Agentoversigt giver administratorer et samlet overblik på tværs af lejeren over alle brugerdefinerede Copilot Studio-agenter og deklarative agenter i organisationen på tværs af miljøer. Agent Inventory-data inkluderer livscyklus- og ejerskabsmetadata, konfigurations- og kapabilitetsadoptionssignaler, styringsindikatorer og brugsmålinger.

Bemærkning

Denne artikel beskriver den nuværende oplevelse med Agent Inventory. Den tidligere erfaring er dokumenteret i Copilot Agent Kit-repositoriet på GitHub i AGENT_INVENTORY_V1.md-filen.

Dashboard

Agent Inventory-dashboardet giver dig et lejerdækkende overblik og en gennemgangsnavigation ind i inventaret. Vælg en flise, et diagram eller et listeelement for at åbne en filtreret visning i agentens gitter.

Skærmbillede af Agent Inventory-dashboardet, der viser inventarkontekst, porteføljemetrikker og analysefliser.

Inventarkontekst

Statusrækken øverst på dashboardet viser den aktuelle status for lageret:

  • Uanset om inventaret er aktuelt, tomt eller en synkronisering er i gang.
  • Procentdelen af poster, der er beriget med en detaljeret konfiguration.
  • Antallet af agenter med begrænsede oplysninger.
  • Antallet af synkroniserede miljøer.
  • Den sidste vellykkede synkroniseringstid, når den er tilgængelig.

Porteføljemålinger

De metriske felter hjælper dig med at hoppe direkte ind i vigtige segmenter af inventaret:

  • Antal agenter
  • Drevet af
  • Autonome agenter
  • Udskrivningsagenter
  • Agenter med viden

Vælg en flise for at åbne agentens gitter, filtreret til det segment. Powered by-tilen grupperer agenter i kategorier som Standard, GitHub Copilot og Copilot Chat.

Analyse og styring

Dashboardet indeholder også diagrammer og lister, der hjælper dig med at identificere mønstre og risici:

  • Porteføljevækst med seksmåneders og tolvmåneders intervaller.
  • Distribution af godkendelse.
  • Ledelsesprioriteter , der kræver administratorgennemgang.
  • Fordeling af porteføljestatus .
  • Kapacitetsadoption på tværs af berigede agenter.
  • Topmiljøer rangeret efter antal agenter.
  • Agenter skal holde øje med optegnelser, der kræver opmærksomhed.

Skærmbillede af de agenter, man skal holde øje med, på Agent Inventory-dashboardet.

Procenter afhænger af de miljøer, hvor de konfigurerede forbindelsesidentiteter kan hente agentdata og detaljeret konfiguration. Lær mere i dataindsamlingsmetoder.

Gennemse alle agenter

Vælg Se hele oversigten på dashboardet for at åbne agentoversigten. Brug gitteret til at finde, gruppere og eksportere lagerdata.

Skærmbillede af agenternes agentgitter med filter-, sorterings-, gruppe- og kolonnetilpasningsmuligheder.

Du kan filtrere, sortere og gruppere efter en hvilken som helst kolonne, tilføje eller fjerne kolonner for at tilpasse gitteret til dine behov og eksportere den aktuelle visning til Excel.

Oplysninger om helpdesk-medarbejder

Vælg et agentnavn fra gitteret for at åbne agentdetaljer. Headeren viser agentens identitet, miljøkontekst, livscyklusstatus, ejerskab og tilgængelige handlinger. Et informationsbanner fortæller dig, om posten har fuld Dataverse-berigelse eller kun begrænsede konfigurationsdetaljer.

Skærmbillede af siden med agentdetaljer, der viser agentens header og Oversigtsfanen.

Oversigt-fanen

Oversigtsfanen viser agentens oversigt og miljøinformation, styringsposition og signaler samt et brugsøjebliksbillede, når brugshistorik eksisterer. Hvis AI-genererede beskrivelser er aktiveret, og agenten er en berettiget GitHub Copilot-agent, vises der også en AI-genereret beskrivelse.

Fanen Komponenter

Fanen Komponenter vises kun, når komponentdata er tilgængelige for agenten. Brug denne fane til at udforske agentarkitekturen i Komponentkortvisningen , gennemse kategoriseret indhold i Komponent-gruppevisningen , udvide én udfyldt komponentgruppe ad gangen, aktivere Raw-tilstand for at inspicere JSON'en, eller kopiere komponent-JSON til undersøgelse eller support.

Skærmbillede af fanen Komponenter på siden Agentdetaljer i Komponentkortvisning.

Skærmbillede af fanen Komponenterne på siden Agentdetaljer i Komponentgruppevisning.

Fanen Forbrug

Brugerfanen vises kun, når der findes brugerposter for agenten. Det omfatter:

  • Måned-til-dato, de to foregående kalendermåneder, de sidste tre måneder og de sidste seks måneders intervaller. De sidste seks måneder vælges som standard.
  • Samlede Copilot-point og gennemsnitlige point pr. aktiv uge.
  • Rapporterede brugere og primær brugsfunktion.
  • Ugentlige kredittrends.
  • Brugshøjdepunkter, krediteringer efter funktion og kanal samt seneste brugsregistre.
  • En agent-specifik Excel-eksport.

Skærmbillede af fanen Usage på siden Agent Details, der viser overskriftsmålinger og ugentlige kredittrends.

Skærmbillede af fanen Usage på siden Agent Details, der viser credits efter funktion og kanal samt seneste brugsregistreringer.

Metadata-fanen

Metadata-fanen er altid tilgængelig. Brug den til at inspicere tekniske værdier som agent-ID og skemanavn, miljø-ID og URL, lokations- og kildeidenticeller samt de rå inventarfelter, der bruges til diagnostik og integration.

Skærmbillede af Metadata-fanen på siden Agentdetaljer, der viser tekniske identifikatorer og rå lagerfelter.

Synkroniser eller opdater lagerdata

Agent Inventory adskiller synkronisering fra dashboard-opdatering.

Synkroniseringsagenter

Vælg Sync-agenter , når du skal samle lejerinventaret igen. Synkroniseringen følger filtrene, miljøgrupperne, dataindsamlingstilstanden, brugsindstillingen og tidsplanen, der er gemt i Configure Agent Inventory.

Mens en synkronisering kører:

  • Inventarstatus ændres til Synkronisering undervejs.
  • Sync agents er deaktiveret for at forhindre duplikerede operationer.
  • Indstillinger, der kan ændre den aktive synkroniseringskonfiguration, er ikke tilgængelige.
  • Dashboardet genindlæser agentdetaljer, brugshistorik, synkroniseringsstatus og sidst synkroniserede oplysninger, når synkroniseringen er afklaret.

Opdater dashboarddata

Vælg Opdater dashboarddata for at genindlæse data, der allerede er gemt i tabellerne Agent Details og Agent Usage History . Refresh starter ikke en Agent Sync og genopdager ikke miljøer eller agenter. Brug det efter en gennemført synkronisering, eller når dashboardet viser forældede cachede data.

Vigtigt!

Agentsynkronisering bruger ikke Copilot-kreditter. Credits bruges kun, når AI-genererede beskrivelser er aktiveret, og en kvalificeret GitHub Copilot-agent detailside besøges.

Styringshandlinger

Agent Inventory understøtter Reassign,Quarantæne og Unkarantæne-handlinger . Handlinger vises kun, når alle valgte agenter er berettigede.

Skærmbillede af massestyringshandlinger på Agent Inventory-agentens grid.

Handlingstilgængelighed

Statuskolonnen i gitteret udfyldes under den sidste inventar-synkronisering og afspejler værdien fra Power Platform-administrationscentret (One Inventory-data). Hvilke handlinger der vises, afhænger af, hvor mange poster du vælger og deres status.

Handling Udvælgelsesregel Skjult når
Tildel igen En eller flere rekorder (op til maksimalt 50) kan vælges. Enhver udvalgt agent er ikke berettiget til omplacering.
Karantæne En eller flere poster i Draft- eller Available-status (op til maksimalt 50) kan vælges. Enhver valgt agent er blokeret eller ikke berettiget til karantæne.
Fjern fra karantæne En eller flere poster i blokeret status (op til maksimalt 50) kan vælges. Alle valgte agenter er Kladde, Tilgængelig, eller er ikke kvalificeret til at blive taget ud af karantæne.

Hvis en valgt post er inkompatibel med en operation, skjules den operation i kommandolinjen. Poster, hvis Power Platform admincenter-kontekst ikke matcher inventarmiljøet, tilbydes ikke uunderstøttede styringshandlinger.

På siden med agentdetaljer er tilgængeligheden af karantæne og afkarantæne baseret på agentens live-status, snarere end den synkroniserede status, der vises i gitteret.

Tildel på ny

Nogle organisationer kræver, at agenter har en ejer for at overholde reglerne. Ejeren kan redigere agenten, offentliggøre opdateringer, slette den eller dele den med holdkammerater i henhold til deres tilladelser.

Vælg Omfordeling og vælg en bruger, der har en Microsoft 365 Copilot-licens. Ved masse-omfordeling viser dialogen de valgte miljøer, agenter, nuværende ejere og driftsstatus. Efter omplaceringen er fuldført, vises omfordelingsstatus som fuldført for hver vellykket behandlet agent.

Skærmbillede af den samlede omfordelingsdialog, der viser udvalgte miljøer, agenter, nuværende ejere og status.

Karantæne og op-karantæne

Karantæne blokerer en berettiget agent. Fjern fra karantæne gendanner en blokeret agent, der kan gendannes. Bekræftelsesdialogen identificerer de berørte agenter, miljøer og statusser, før en operation indsendes.

Skærmbillede af den samlede karantænebekræftelsesdialog, der viser berørte agenter, miljøer og aktuelle statusser.

Masseaktioner understøtter op til 50 agenter pr. operation og er kun tilgængelige, når alle valgte poster er berettigede.

Konfigurer agentlager

Vælg Indstillinger fra dashboard-headeren for at åbne Agent sync-konfigurationen. Brug den til at styre, hvilke miljøer og agenttyper der indsamles, juster lagerindstillinger og sæt synkroniseringsplanen og indsamlingstilstanden.

Skærmbillede af siden for Agent-synkroniseringskonfiguration.

Bemærkning

Disse indstillinger i appen antager, at de nødvendige løsningsforbindelser allerede er sat op. Lær mere om at forbinde forbindelsesreferencerne i Configure Agent Inventory.

Miljøtyper

Vælg hvilke miljøtyper der scannes:

  • Developer
  • Standardindstilling
  • Sandkasse
  • Produktion
  • Prøveversion
  • Teams

Hvis du ikke vælger en miljøtype, inkluderer systemet alle miljøtyper.

Agenttyper

Vælg om inventaret inkluderer:

  • Brugerdefinerede agenter
  • Deklarative agenter

Hvis du ikke vælger en agenttype, inkluderer inventaret alle agenttyper.

Miljøgrupper

Miljøgrupper leverer genanvendelige synkroniseringsscopes. Som administrator kan du:

  • Opret og rediger en gruppe.
  • Vælg medlemsmiljøer ved at bruge miljøtype- og regionsfiltre.
  • Tænd eller deaktiver gruppen.
  • Slet en gruppe, du ikke længere har brug for.

Hvis du ikke aktiverer en gruppe, er alle miljøer, der er tilladt af de andre indstillinger, inkluderet.

Skærmbillede af miljøgruppernes konfiguration på siden for Agent-synkroniseringskonfiguration.

Lagermuligheder

Indsæt følgende indstillinger for at styre, hvad systemet indsamler under synkroniseringen:

  • Udeluk systemagenter: Springer Microsoft-leverede systemagenter over under synkronisering.
  • Aktivér AI-genereret beskrivelse for GitHub Copilot-agenter: Tillader beskrivelsesgenerering, når en side med oplysninger om kvalificerede agenter besøges.
  • Inkluder brugsmålinger: Indsamler det tilbageholdte 180-dages brugsvindue under synkronisering.

Skærmbillede af inventarindstillingerne og synkroniseringsplankonfigurationen på siden for Agent-synkroniseringskonfiguration.

Synkroniseringsplan og indsamlingstilstand

Vælg hvordan synkroniseringen kører, og hvilken dataindsamlingstilstand du vil bruge:

  • One Inventory (Power Platform admin center): Kombinerer administrationscenter-inventar med miljødata for bredere opdagelse og rigere metadata.
  • Standard (kun miljøer): Henter inventar direkte fra tilgængelige miljøer.
  • Aktiver daglig automatisk synkronisering: Kører Agent Inventory på den konfigurerede daglige tidsplan.

Vælg Gem for at anvende ændringer. Gem er deaktiveret, når ingen indstilling ændres, når en gemning er i gang, eller når indstillinger ikke er tilgængelige under en aktiv synkronisering.

Tip

Brug opdatering af dashboarddata efter en gennemført synkronisering, når dashboardet skal genindlæse eksisterende tabeldata. Brug kun Sync-agenter , når inventarindsamling skal køre igen. Hold miljø- og agentfiltre så snævre som praktisk i meget store lejere, og deaktiver forbrugsindsamling, når 180-dages brugsanalyse ikke er nødvendig.

Dataindsamlingsmetoder

Dataindsamlingstilstanden bestemmer, hvordan systemet opdager og indsamler agentposter.

Når du sætter indsamlingstilstanden til Ét Inventar, bruger Agent Inventory Én Inventar-data:

  1. Den henter agentdata fra One Inventory via Power Platform administrationscenter.
  2. Den lister miljøer ved hjælp af forbindelsesreferencen Copilot Agent Kit - Power Platform for Admins V2.
  3. Den kombinerer One Inventory-agentdata med miljølisten for at konstruere miljødetaljer.
  4. For hvert miljø indlæser den agentdetaljer i Agent Inventory ved at sammenflette agenter hentet fra miljøet med de tilsvarende One Inventory-data.

Brug denne tilstand, når du har brug for bredere lejeropdagelse og rigere Power Platform admincenter-metadata. Agenter, der opdages gennem administrationscentret, men som ikke er tilgængelige i deres miljø, tilføjes stadig med begrænsede detaljer.

Standardtilstand

Når du sætter indsamlingstilstanden til Standard, bruger Agent Inventory standarddataindsamlingsmetoden:

  1. Den lister alle miljøer ved hjælp af forbindelsesreferencen Copilot Agent Kit - Power Platform for Admins (V1).
  2. Den henter agenter til hvert miljø.
  3. Den indlæser agentdata i Agent Inventory.

Brug denne tilstand, når du ønsker, at indsamlingen kun skal baseres på tilgængelige miljøer.

I begge tilstande bruger Agent Inventory Copilot Agent Kit - Dataverse-forbindelsesreferencen til at forbinde til hvert miljø og indsamle detaljerede agentoplysninger, herunder metadata, funktionsanvendelse og konfiguration. Systemet henter kun detaljerede oplysninger for miljøer, hvor den konfigurerede konto har adgang til systemadministrator.

Lær mere om den fulde liste over stik, der bruges på tværs af sættet, i Connector-krav.

Forbrugsdata

Agent Inventory kan gemme og vise op til 180 dages agentens brugsdata. For at muliggøre brugsanalyse:

  1. Sørg for, at de nødvendige løsningsforbindelser er konfigureret og tilladt af datapolitikker.
  2. Åbn Agent sync-konfiguration.
  3. Slå Inkluder brugsmålinger til.
  4. Vælg Gem.
  5. Vælg Sync agents, eller vent på den daglige automatiske synkronisering.

Brugsdata gemmes i tabellerne Agent Details og Agent Usage History . Fanen Brug for en agent vises kun, når der findes tilsvarende poster i brugshistorikken.

Konfigurer HTTP med Microsoft Entra ID-forbindelsen

Brugsmålinger er afhængige af HTTP med Microsoft Entra ID (forhåndsautoriseret) connector. Forbindelsesværdierne afhænger af den cloud, din lejer kører i. Brug Base Resource URL og Microsoft Entra ID Resource URI, der matcher din cloud, når du opretter forbindelsen.

Cloud Basisressource-URL Microsoft Entra ID Resource URI
Kommercielle 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/

Tilladelser og stikkrav

Forbindelsesreferencerne i løsningsgrænsen og kontrolsynligheden for agenterne. For fuld lejeroversigt skal du konfigurere forbindelsesreferencerne med en konto, der har Power Platform-administratorrollen . For at hente alle funktionsdetaljer skal den konto også have systemadministratoradgang til de relevante miljøer. Du kan bruge andre konti, men synligheden af agentlageret er begrænset til de miljøer, hvor brugeren har systemadministratoradgang.

Agent Inventory er afhængig af følgende forbindelser, som de datapolitikker, der er anvendt på miljøet, skal tillade:

  • Microsoft Dataverse
  • Power Platform til administratorer
  • Power Platform til administratorer V2
  • HTTP med Microsoft Entra-id (forhåndsgodkendt)

Lær mere om den fulde liste over stik, der bruges på tværs af sættet, i Connector-krav.

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

Tabel Formål
cat_agentdetails Opdagede agenter, metadata, kapabiliteter, ejerskab og synkroniseret status
cat_agentusagehistory Bevarede brugsdimensioner og Copilot-kreditværdier
cat_agentinventorysettings Inventarfiltre, tilstand og funktionsindstillinger
cat_environmentgroups Genanvendelige miljøområder
cat_agentinventoryactionaudit Sporing af styringshandlinger
cat_copilotstudiokitlogs Funktions- og driftslogning

Næste trin

Få indsigt med Agent Insights Hub

  • Last updated on