Überwachen Sie Agenten, indem Sie das Agenteninventar im Copilot Agent Kit verwenden

Die Funktion „Agent Inventory“ bietet Administratoren mandantenweite Transparenz über alle benutzerdefinierten Agents und deklarativen Agents in Copilot Studio in der gesamten Organisation, umgebungsübergreifend. Agenteninventardaten umfassen Lebenszyklus- und Eigentumsmetadaten, Signale zur Konfiguration und Akzeptanz von Fähigkeiten, Governance-Indikatoren und Nutzungskennzahlen.

Note

Dieser Artikel beschreibt die aktuelle Erfahrung im Agenteninventar. Die bisherige Erfahrung ist im Copilot Agent Kit Repository auf GitHub in der AGENT_INVENTORY_V1.md-Datei dokumentiert.

Dashboard

Das Dashboard „Agent Inventory“ bietet Ihnen eine mandantenweite Übersicht und eine Detailnavigation zum Inventar. Wählen Sie eine Kachel, eine Grafik oder einen Listeneintrag, um eine gefilterte Ansicht im Agentenraster zu öffnen.

Inventarkontext

Die Statuszeile oben im Dashboard zeigt den aktuellen Zustand des Inventars:

Egal, ob das Inventar aktuell, leer oder eine Synchronisation im Gange ist.
Der Prozentsatz der Datensätze, die mit detaillierter Konfiguration bereichert wurden.
Die Anzahl der Agenten mit begrenzten Angaben.
Die Anzahl der synchronisierten Umgebungen.
Die letzte erfolgreiche Synchronisationszeit, wenn verfügbar.

Portfolio-Kennzahlen

Die metrischen Kacheln helfen Ihnen, direkt in wichtige Segmente des Inventars einzusteigen:

Anzahl der Agenten
Angetrieben von
Autonome Agenten
Entwurfs-Agenten
Agenten mit Wissen

Wählen Sie eine Kachel aus, um das Agenten-Raster zu öffnen, das auf dieses Segment gefiltert ist. Der Powered by Tile gruppiert Agenten in Kategorien wie Standard, GitHub Copilot und Copilot Chat.

Analysen und Governance

Das Dashboard enthält außerdem Diagramme und Listen, die Ihnen helfen, Muster und Risiken zu erkennen:

Portfoliowachstum mit Zeiträumen von sechs und zwölf Monaten.
Authentifizierungsverteilung .
Governance-Prioritäten , die eine Überprüfung durch Administratoren erfordern.
Verteilung nach Portfoliostatus.
Fähigkeitsübernahme über angereicherte Agenten hinweg.
Top-Umgebungen , bewertet nach Agentenanzahl.
Zu beobachtende Agents für Datensätze, die besonderer Aufmerksamkeit bedürfen.

Die Prozentsätze hängen von den Umgebungen ab, für die konfigurierte Verbindungsidentitäten Agentendaten abrufen können, sowie von detaillierter Konfiguration. Erfahren Sie mehr in Datenerfassungsmodi.

Durchsuchen Sie alle Agenten

Wählen Sie im Dashboard das vollständige Inventar anzeigen , um das Agentenraster zu öffnen. Nutzen Sie das Raster, um Inventardaten zu finden, zu gruppieren und zu exportieren.

Sie können filtern, sortieren und nach beliebigen Spalten gruppieren, Spalten hinzufügen oder entfernen, um das Raster an Ihre Bedürfnisse anzupassen, und die aktuelle Ansicht nach Excel exportieren.

Agentendetails

Wählen Sie einen Agentennamen aus dem Raster aus, um Agentendetails zu öffnen. Der Header zeigt die Identität des Agenten, den Umgebungskontext, den Lebenszyklusstatus, die Eigentümerschaft und verfügbare Aktionen. Ein Informationsbanner zeigt an, ob der Datensatz vollständige Dataverse-Anreicherung oder nur begrenzte Konfigurationsdetails enthält.

Registerkarte Übersicht

Die Registerkarte Übersicht zeigt die Zusammenfassung des Agents und Informationen zur Umgebung, den Governance-Stand und Signale sowie eine Nutzungsübersicht, wenn eine Nutzungshistorie vorhanden ist. Wenn KI-generierte Beschreibungen aktiviert sind und der Agent ein berechtigter GitHub-Copilot-Agent ist, wird auch eine KI-generierte Beschreibung angezeigt.

Komponenten-Registerkarte

Die Registerkarte Komponenten wird nur angezeigt, wenn Komponentendaten für den Agenten verfügbar sind. Nutzen Sie diesen Tab, um die Agentenarchitektur in der Komponentenkartenansicht zu erkunden, kategorisierte Inhalte in der Komponentengruppenansicht zu durchsuchen, jeweils eine befüllte Komponentengruppe zu erweitern, den Raw-Modus zur Inspektion des JSON zu aktivieren oder Komponenten-JSON zur Untersuchung oder Unterstützung zu kopieren.

Registerkarte „Nutzung“

Die Registerkarte Nutzung wird nur angezeigt, wenn Nutzungsdatensätze für den Agenten vorhanden sind. Sie hat folgenden Inhalt:

Seit Monatsbeginn, in den beiden vorangegangenen Kalendermonaten, in den letzten drei Monaten und in den letzten sechs Monaten. Die letzten sechs Monate werden standardmäßig ausgewählt.
Gesamtzahl der Copilot-Credits und durchschnittliche Credits pro aktive Woche.
Gemeldete Benutzer und Hauptnutzungsfunktion.
Wöchentliche Kredittrends.
Nutzungs-Highlights, Credits nach Funktion und Kanal sowie aktuelle Nutzungsaufzeichnungen.
Ein agentenspezifischer Excel-Export.

Metadaten-Reiter

Der Metadaten-Tab ist immer verfügbar. Nutzen Sie es, um technische Werte wie Agenten-ID und Schemaname, Umgebungs-ID und URL, Standort- und Quellkennungen sowie die für Diagnostik und Integration verwendeten Rohinventarfelder zu überprüfen.

Inventardaten synchronisieren oder aktualisieren

Agent Inventory trennt Synchronisation vom Dashboard-Refresh.

Synchronisierungs-Agenten

Wähle Sync-Agenten , wenn du das Mieterinventar erneut sammeln musst. Die Synchronisation folgt den Filtern, Umgebungsgruppen, dem Datenerfassungsmodus, den Nutzungseinstellungen und dem Zeitplan, die in Configure Agent Inventory gespeichert sind.

Während eine Synchronisation läuft:

Der Inventarstatus ändert sich auf Synchronisieren im Gange.
Sync Agents ist deaktiviert, um doppelte Operationen zu verhindern.
Einstellungen, die die aktive Synchronisationskonfiguration ändern könnten, sind nicht verfügbar.
Das Dashboard lädt nach Abschluss der Synchronisation erneut Agentendetails, Nutzungsverlauf, Synchronisationsstatus und zuletzt synchronisierte Informationen.

Aktualisieren Sie die Dashboard-Daten

Wählen Sie Dashboarddaten aktualisieren aus, um bereits in den Tabellen Agent Details und Agent Usage History gespeicherte Daten erneut zu laden. Refresh startet keine Agent Sync und entdeckt keine Umgebungen oder Agenten wieder. Verwende es nach einer abgeschlossenen Synchronisation oder wenn das Dashboard veraltete zwischengespeicherte Daten anzeigt.

Important

Die Agentensynchronisation verwendet keine Copilot-Credits. Credits werden nur verwendet, wenn KI-generierte Beschreibungen aktiviert sind und die Detailseite eines berechtigten GitHub Copilot-Agenten aufgerufen wird.

Governanceaktionen

Die Agentenübersicht unterstützt die Aktionen Neu zuweisen, In Quarantäne verschieben und Aus Quarantäne entfernen. Aktionen erscheinen nur, wenn jeder ausgewählte Agent berechtigt ist.

Verfügbarkeit von Aktionen

Die Status-Spalte im Raster wird während der letzten Inventar-Synchronisation angezeigt und spiegelt den Wert aus dem Power Platform Admin Center (One Inventory Data) wider. Welche Aktionen angezeigt werden, hängt davon ab, wie viele Datensätze du auswählst und deren Status.

Action	Auswahlregel	Versteckt, wenn
Erneut zuweisen	Ein oder mehrere Platten (bis zu maximal 50) können ausgewählt werden.	Kein ausgewählter Agent ist für eine Versetzung berechtigt.
Quarantäne	Ein oder mehrere Datensätze im Status Draft oder Available (bis zu maximal 50) können ausgewählt werden.	Jeder ausgewählte Agent ist gesperrt oder nicht für Quarantäne berechtigt.
Aus Quarantäne entfernen	Ein oder mehrere Datensätze im Status Blocked (bis zu maximal 50) können ausgewählt werden.	Alle ausgewählten Agenten haben den Status Draft, Available oder sind nicht für die Entlassung aus der Quarantäne geeignet.

Wenn ein ausgewählter Datensatz mit einer Operation nicht kompatibel ist, wird diese Operation in der Kommandoleiste ausgeblendet. Datensätze, deren Power Platform Admin-Center-Kontext nicht mit der Inventarumgebung übereinstimmt, erhalten keine nicht unterstützten Governance-Aktionen.

Auf der Agenten-Details-Seite basiert die Verfügbarkeit von Quarantäne und Entquarantäne auf dem Live-Status des Agenten und nicht auf dem synchronisierten Status, der im Raster angezeigt wird.

Zuweisen

Einige Organisationen verlangen von Agenten, dass sie Eigentümer haben, um Compliance-Zwecke zu gewährleisten. Der Besitzer kann den Agenten bearbeiten, Updates veröffentlichen, löschen oder mit Teammitgliedern gemäß seinen Berechtigungen teilen.

Wählen Sie Neuzuweisung und wählen Sie einen Benutzer aus, der eine Microsoft 365 Copilot-Lizenz besitzt. Für die Massenzuweisung zeigt der Dialog die ausgewählten Umgebungen, Agenten, aktuellen Besitzer und den Betriebsstatus an. Nach Abschluss der Neuzuweisung wird der Status der Überweisung für jeden erfolgreich bearbeiteten Agenten als abgeschlossen angezeigt.

Quarantäne und Entquarantäne

Quarantäne blockiert einen berechtigten Agenten. Aus Quarantäne wiederherstellen stellt einen geeigneten blockierten Agent wieder her. Der Bestätigungsdialog identifiziert die betroffenen Agenten, Umgebungen und Status, bevor eine Operation eingereicht wird.

Massenaktionen unterstützen bis zu 50 Agenten pro Vorgang und sind nur verfügbar, wenn alle ausgewählten Datensätze dafür infrage kommen.

Konfigurieren des Agentinventars

Wähle Einstellungen im Dashboard-Header aus, um die Agent-Sync-Konfiguration zu öffnen. Nutzen Sie es, um zu steuern, welche Umgebungen und Agententypen gesammelt werden, passen Sie Inventaroptionen an und legen Sie den Synchronisationsplan sowie den Sammelmodus ein.

Note

Diese In-App-Einstellungen gehen davon aus, dass die erforderlichen Lösungsverbindungsreferenzen bereits eingerichtet sind. Erfahren Sie mehr über das Verdrahten der Verbindungsreferenzen in Configure Agent Inventory.

Umgebungstypen

Wählen Sie aus, welche Umgebungstypen gescannt werden:

Developer
Standard
Sandkasten
Produktion
Testphase
Teams

Wenn du keinen Umgebungstyp auswählst, umfasst das System alle Umgebungstypen.

Agenttypen

Wählen Sie aus, ob das Inventar Folgendes enthält:

Benutzerdefinierte Agents
Deklarative Agenten

Wenn du keinen Agententyp auswählst, enthält das Inventar alle Agententypen.

Umweltgruppen

Umgebungsgruppen stellen wiederverwendbare Synchronisierungsbereiche bereit. Administrator\*innen können Folgendes:

Erstelle und bearbeite eine Gruppe.
Wählen Sie Mitgliedsumgebungen mithilfe von Umgebungstyp- und Regionsfiltern aus.
Aktiviere oder deaktiviere die Gruppe.
Lösche eine Gruppe, die du nicht mehr brauchst.

Wenn du eine Gruppe nicht aktivierst, sind alle von den anderen Einstellungen erlaubten Umgebungen enthalten.

Bestandsoptionen

Setzen Sie folgende Optionen ein, um zu steuern, was das System während der Synchronisation sammelt:

Systemagenten ausschließen: Überspringt Microsoft-bereitgestellte Systemagenten während der Synchronisation.
Aktivieren Sie KI-generierte Beschreibung für GitHub Copilot-Agenten: Ermöglicht die Erstellung von Beschreibungen, wenn eine Seite mit den Details des berechtigten Agenten besucht wird.
Nutzungsmetriken einbeziehen: Sammelt das während der Synchronisation erhaltene 180-Tage-Nutzungsfenster.

Synchronisationsplan und Erfassungsmodus

Wählen Sie, wie die Synchronisation ausgeführt wird und welchen Datenerfassungsmodus Sie verwenden:

One Inventory (Power Platform Verwaltungszentrum): Kombiniert Verwaltungszentrum-Inventar mit Umweltdaten für eine breitere Entdeckung und reichhaltigere Metadaten.
Standard (nur Umgebungen): Holt das Inventar direkt aus zugänglichen Umgebungen ab.
Automatische tägliche Synchronisation aktivieren: Führt das Agenteninventar im konfigurierten Tagesplan aus.

Wählen Sie Speichern aus, um die Änderungen zu übernehmen. Speicherstand ist deaktiviert, wenn sich keine Einstellung geändert hat, ein Speicherstand läuft oder wenn Einstellungen während einer aktiven Synchronisation nicht verfügbar sind.

Tip

Verwenden Sie Dashboard-Daten aktualisieren nach Abschluss der Synchronisation, wenn das Dashboard bestehende Tabellendaten neu laden muss. Verwenden Sie Sync-Agenten nur, wenn die Inventarsammlung erneut ausgeführt werden muss. Halte die Umgebungs- und Agentenfilter so eng wie praktisch bei sehr großen Mietern und deaktiviere die Nutzungserfassung, wenn keine 180-Tage-Nutzungsanalysen erforderlich sind.

Datenerfassungsmodi

Die Einstellung für den Datenerfassungsmodus bestimmt, wie das System Agentendatensätze entdeckt und sammelt.

Ein Inventarmodus (empfohlen)

Wenn du den Sammelmodus auf One Inventory stellst, verwendet Agent Inventory One Inventory-Daten:

Es holt Agentendaten aus One Inventory über das Power Platform Admin Center ab.
Es listet Umgebungen anhand der Copilot Agent Kit - Power Platform for Admins V2-Verbindungsreferenz auf.
Es kombiniert die Daten des One Inventory-Agenten mit der Umgebungsliste, um Umweltdetails zu erstellen.
Für jede Umgebung lädt es Agentendetails ins Agenteninventar, indem Agenten, die aus der Umgebung bezogen wurden, mit den entsprechenden One Inventory-Daten zusammengeführt werden.

Nutzen Sie diesen Modus, wenn Sie eine breitere Tenant-Discovery und umfangreichere Power Platform Admin-Center-Metadaten benötigen. Agenten, die über das Verwaltungszentrum erkannt werden, aber in ihrer Umgebung nicht zugänglich sind, werden dennoch mit eingeschränkten Details hinzugefügt.

Standardmodus

Wenn Sie den Sammelmodus auf Standard setzen, verwendet Agent Inventory den Standard-Datenerfassungsansatz:

Es listet alle Umgebungen anhand der Copilot Agent Kit - Power Platform for Admins Connection Reference (V1) auf.
Es ruft Agenten für jede Umgebung ab.
Es lädt Agentendaten in das Agenteninventar.

Nutzen Sie diesen Modus, wenn Sie möchten, dass die Sammlung nur auf zugängliche Umgebungen basiert.

In beiden Modi verwendet Agent Inventory die Copilot Agent Kit - Dataverse-Verbindungsreferenz, um sich mit jeder Umgebung zu verbinden und detaillierte Agenteninformationen zu sammeln, einschließlich Metadaten, Feature-Nutzung und Konfiguration. Das System ruft detaillierte Informationen nur für Umgebungen ab, in denen das konfigurierte Konto Systemadministratorzugriff hat.

Erfahren Sie mehr über die vollständige Liste der im gesamten Kit verwendeten Steckverbinder unter Steckverbinder-Anforderungen.

Nutzungsmetriken

Agent Inventory kann Daten zur Nutzung von Agenten bis zu 180 Tage speichern und anzeigen. Um Nutzungsanalysen zu ermöglichen:

Stellen Sie sicher, dass die erforderlichen Lösungsverbindungen durch Datenrichtlinien konfiguriert und erlaubt sind.
Öffnen Sie Agent-Synchronisierungskonfiguration.
Aktivieren Sie Nutzungsmetriken einbauen.
Wählen Sie Speichern aus.
Wählen Sie Sync-Agents aus, oder warten Sie auf die tägliche automatische Synchronisierung.

Nutzungsdaten werden in den Tabellen Agent Details und Agent Usage History gespeichert. Der Reiter "Nutzung" eines Agenten erscheint nur, wenn übereinstimmende Nutzungshistorie-Datensätze verfügbar sind.

Konfigurieren Sie das HTTP mit der Microsoft Entra ID-Verbindung

Nutzungsmetriken basieren auf dem HTTP-Connector mit Microsoft Entra ID (vorautorisiert). Die Verbindungswerte hängen von der Cloud ab, in der dein Tenant läuft. Verwenden Sie die Basisressourcen-URL und die Microsoft Entra ID Resource URI, die zu Ihrer Cloud passen, wenn Sie die Verbindung herstellen.

Wolke	Basis-URL der Ressource	Microsoft Entra ID Ressourcen-URI
Kommerziell	`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/`

Berechtigungen und Konnektoranforderungen

Die Verbindungsreferenzen im Lösungsgrenzwert und steuern die Sichtbarkeit der Agents. Für vollständige tenantweite Transparenz konfigurieren Sie die Verbindungsreferenzen mit einem Konto, das die Power Platform Administrator-Rolle trägt. Um alle Funktionen abzurufen, benötigt dieses Konto außerdem Systemadministrator-Zugriff auf die entsprechenden Umgebungen. Sie können andere Konten verwenden, aber die Sichtbarkeit des Agentbestands ist auf die Umgebungen beschränkt, in denen der Benutzer über Systemadministratorzugriff verfügt.

Agent Inventory verwendet die folgenden Konnektoren, die von den auf die Umgebung angewendeten Datenrichtlinien zugelassen werden müssen:

Microsoft Dataverse
Power Platform für Administratoren
Power Platform für Administratoren V2
HTTP mit Microsoft Entra-ID (vorautorisiert)