Monitoruj agentów, korzystając z Agent Inventory w zestawie Copilot Agent Kit

Funkcja Inventarz Agentów zapewnia administratorom dostęp do wszystkich agentów niestandardowych Copilot Studio oraz agentów deklaratywnych w organizacji, w różnych środowiskach. Dane Agent Inventory obejmują metadane dotyczące cyklu życia i właściciela, sygnały dotyczące konfiguracji i wdrożenia możliwości, wskaźniki nadzoru oraz metryki użycia.

Note

Ten artykuł opisuje obecne doświadczenia z Agent Inventary. Poprzednie doświadczenia są udokumentowane w repozytorium Copilot Agent Kit na GitHub w pliku AGENT_INVENTORY_V1.md.

Dashboard

Pulpit Agent Inventory daje podsumowanie dla całego najemcy oraz przegląd inwentaryzacji. Wybierz kafelek, wykres lub element listy, aby otworzyć filtrowany widok w siatce agentów.

Kontekst zapasów

Wiersz statusu na górze panelu pokazuje aktualny stan zapasów:

Czy stan magazynowy jest aktualny, pusty, czy trwa synchronizacja.
Procent rekordów wzbogaconych o szczegółową konfigurację.
Liczba agentów z ograniczonymi informacjami.
Liczba zsynchronizowanych środowisk.
Czas ostatniej pomyślnej synchronizacji, jeśli jest dostępny.

Metryki portfela

Kafelki metryczne pomagają od razu wskoczyć do ważnych segmentów ekwipunku:

Liczba agentów
Zasilane przez
Agenci autonomiczni
Agenci draftowi
Agenci z wiedzą

Wybierz kafelek, aby otworzyć siatkę agentów przefiltrowaną według tego segmentu. Powered by tile grupuje agentów na takie kategorie jak Standard, GitHub Copilot i Copilot Chat.

Analityka i zarządzanie

Pulpit zawiera także wykresy i listy, które pomagają dostrzec wzorce i ryzyka:

Wzrost portfela w zakresie sześcio- i dwunastomiesięcznym.
Dystrybucja uwierzytelniania .
Priorytety zarządzania wymagające przeglądu przez administratora.
Rozkład statusu portfela .
Wdrażanie funkcji wśród agentów z dodatkowymi funkcjami.
Najlepsze środowiska uszeregowane według liczby agentów.
Agenty do monitorowania rekordów wymagających uwagi.

Procenty zależą od środowisk, dla których skonfigurowane tożsamości połączeń mogą pobierać dane agentów oraz szczegółową konfigurację. Dowiedz się więcej w trybach zbierania danych.

Przeglądaj wszystkich agentów

Na pulpicie wybierz Wyświetl pełny spis, aby otworzyć tabelę agentów. Użyj siatki do wyszukiwania, grupowania i eksportu danych inwentarzacyjnych.

Możesz filtrować, sortować i grupować według dowolnej kolumny, dodawać lub usuwać kolumny, aby dostosować siatkę do swoich potrzeb, oraz eksportować aktualny widok do Excela.

Szczegóły agenta

Wybierz nazwę agenta z siatki, aby otworzyć szczegóły agenta. Nagłówek pokazuje tożsamość agenta, kontekst środowiska, status cyklu życia, własność oraz dostępne akcje. Baner informacyjny informuje, czy rekord zawiera pełne wzbogacenie Dataverse, czy tylko ograniczone szczegóły konfiguracyjne.

Karta Przegląd

Zakładka Przegląd pokazuje podsumowanie agenta i informacje o środowisku, postawę zarządzania i sygnały oraz migawkę użytkowania, gdy istnieje historia użytkowania. Jeśli opisy generowane przez AI są włączone, a agent jest uprawnionym agentem GitHub agent funkcji Copilot, wyświetlany jest również opis generowany przez AI.

Karta Składników

Zakładka Komponenty pojawia się tylko wtedy, gdy dane komponentów są dostępne dla agenta. Użyj tej karty, aby przeglądać architekturę agenta w widoku Mapa komponentów, przeglądać treści podzielone na kategorie w widoku Grupa komponentów, rozwijać naraz tylko jedną wypełnioną grupę komponentów, włączyć tryb Raw, aby przejrzeć kod JSON, lub skopiować kod JSON komponentu do analizy lub przekazania zespołowi pomocy technicznej.

Karta „Użycie”

Zakładka Usage pojawia się tylko wtedy, gdy istnieją rekordy użytkowania dla agenta. Zawartość:

Zakres od początku bieżącego miesiąca, dwóch poprzednich miesięcy kalendarzowych, ostatnich trzech miesięcy i ostatnich sześciu miesięcy. Ostatnie sześć miesięcy jest domyślnie wybierane.
Łączna liczba punktów Copilot oraz średnia liczba punktów na aktywny tydzień.
Zgłaszani użytkownicy i funkcja podstawowego użytkowania.
Cotygodniowe trendy kredytowe.
Najważniejsze momenty użytkowania, poszczególne funkcje i kanały oraz rekordy ostatniego użytkowania.
Eksport do programu Excel dedykowany agentowi.

Zakładka metadanych

Zakładka Metadane jest zawsze dostępna. Użyj go do inspekcji wartości technicznych, takich jak ID agenta i nazwa schematu, identyfikator środowiska i URL, identyfikatory lokalizacji i źródła oraz surowe pola inwentarza używane do diagnostyki i integracji.

Synchronizacja lub odświeżanie danych zapasowych

Agent Inventory oddziela synchronizację od odświeżania dashboardu.

Agenci synchronizujący

Wybierz Sync agents, gdy musisz ponownie zebrać spis zasobów dzierżawy. Synchronizacja podąża za filtrami, grupami środowiskowymi, trybem zbierania danych, ustawieniami użytkowania i harmonogramem zapisanymi w Configure Agent Inventory.

Podczas synchronizacji:

Status ekwipunku zmienia się na Synchronizacja w trakcie.
Synchronizacja agentów jest wyłączona, aby zapobiec duplikatowi operacji.
Ustawienia, które mogłyby zmienić konfigurację aktywnej synchronizacji, są niedostępne.
Dashboard ponownie ładuje dane agenta, historię użycia, status synchronizacji oraz informacje o ostatniej synchronizacji po ustabilizowaniu synchronizacji.

Odśwież dane z panelu

Wybierz Odśwież dane z panelu dashboardu, aby ponownie załadować dane już zapisane w tabelach Szczegóły agenta i Historia użytkowania agenta . Odświeżanie nie uruchamia synchronizacji agentów i nie odkrywa ponownie środowisk ani agentów. Używaj go po zakończeniu synchronizacji lub gdy dashboard pokaże stare, zbuforowane dane.

Ważna

Synchronizacja agentów nie wykorzystuje kredytów Copilot. Kredyty są używane tylko wtedy, gdy włączone są opisy wygenerowane przez AI i zostanie odwiedzona strona szczegółów kwalifikującego się agenta GitHub Copilot.

Działania związane z zarządzaniem

Inwentarz agentów obsługuje działania Ponowne przypisanie, Kwarantanna i Usunięcie z kwarantanny. Akcje pojawiają się tylko wtedy, gdy każdy wybrany agent jest uprawniony.

Dostępność akcji

Kolumna Status w siatce jest wypełniana podczas ostatniej synchronizacji inwentaryzacji i odzwierciedla wartość pochodzącą z centrum administracyjnego Power Platform (dane One Inventar). To, które działania są wyświetlane, zależy od liczby wybranych rekordów i ich statusu.

Action	Zasada wyboru	Ukryte, gdy
Przydziel ponownie	Można wybrać jeden lub wiele rekordów (maksymalnie 50).	Wybrany agent nie kwalifikuje się do przeniesienia.
Kwarantanna	Można wybrać jeden lub wiele rekordów w statusie Draft lub Available (maksymalnie 50).	Każdy wybrany agent jest zablokowany lub nie kwalifikuje się do kwarantanny.
Przywróć z kwarantanny	Można wybrać jeden lub wiele rekordów w statusie Zablokowany (maksymalnie 50).	Każdy wybrany agent ma status Draft, Available lub nie kwalifikuje się do zdjęcia z kwarantanny.

Jeśli wybrany rekord jest niezgodny z operacją, operacja ta jest ukryta na pasku poleceń. Rekordy, których kontekst centrum administracyjnego Power Platform nie odpowiada środowisku inwentaryzacyjnemu, nie otrzymują nieobsługiwanych działań zarządzania.

Na stronie szczegółów agenta dostępność kwarantanny i niekwarantanny opiera się na statusie aktywnym agenta, a nie na statusie synchronizacji wyświetlanym w siatce.

Przypisz ponownie

Niektóre organizacje wymagają, aby agenci mieli właścicieli ze względów zgodności. Właściciel może edytować agenta, publikować aktualizacje, usuwać je lub udostępniać członkom zespołu zgodnie z ich uprawnieniami.

Wybierz Przypisz i wybierz użytkownika posiadającego licencję Microsoft 365 Copilot. W przypadku masowego przypisania dialog wyświetla wybrane środowiska, agentów, obecnych właścicieli oraz status operacji. Po zakończeniu ponownego przypisania status ponownego przypisania jest pokazywany jako zakończony dla każdego pomyślnie przetworzonego agenta.

Kwarantanna i bezkwarantanna

Poddanie kwarantannie blokuje kwalifikującego się agenta. Usuń z kwarantanny przywraca kwalifikującego się zablokowanego agenta. Okno dialogowe potwierdzenia wskazuje agentów, środowiska i statusy, których dotyczy operacja, przed jej przesłaniem.

Operacje zbiorcze obsługują do 50 agentów w ramach jednej operacji i są dostępne tylko wtedy, gdy każdy wybrany rekord kwalifikuje się.

Konfigurowanie spisu agentów

Wybierz Ustawienia z nagłówka dashboardu, aby otworzyć konfigurację synchronizacji agenta. Użyj go do kontrolowania, które środowiska i typy agentów są zbierane, dostosowywania opcji zapasów oraz ustawiania harmonogramu synchronizacji i trybu zbierania.

Note

Te ustawienia w aplikacji zakładają, że wymagane odniesienia do połączeń rozwiązań są już skonfigurowane. Dowiedz się więcej o konfigurowaniu odwołań do połączeń w Configure Agent Inventory.

Typy środowiska

Wybierz, które typy środowisk są skanowane:

Deweloper
Default
Piaskownica
Produkcja
Proces sądowy
Teams

Jeśli nie wybierzesz typu środowiska, system zawiera wszystkie typy środowisk.

Typy agentów

Wybierz, czy w inwentarzu znajdą się:

Agenci dostosowani
Agenci deklaratywni

Jeśli nie wybierzesz typu agenta, inwentaryzacja obejmuje wszystkie typy agentów.

Grupy środowiskowe

Grupy środowisk udostępniają zakresy synchronizacji wielokrotnego użytku. Jako administrator możesz:

Stwórz i edytuj grupę.
Wybieraj środowiska członkowskie za pomocą filtrów typu środowiska i regionu.
Włącz lub wyłącz grupę.
Usuń grupę, której już nie potrzebujesz.

Jeśli nie włączysz grupy, wszystkie środowiska dozwolone przez inne ustawienia są uwzględnione.

Opcje ekwipunku

Ustaw następujące opcje, aby kontrolować, co system zbiera podczas synchronizacji:

Wyklucz agentów systemowych: Pomija agentów systemowych dostarczonych przez Microsoft podczas synchronizacji.
Włączenie opisów generowanych przez AI dla agentów GitHub Copilot: Pozwala generować opisy po odwiedzeniu strony szczegółów kwalifikowanego agenta.
Uwzględnij metryki użytkowania: Zbiera zachowane 180-dniowe okno użytkowania podczas synchronizacji.

Harmonogram synchronizacji i tryb zbierania

Wybierz sposób synchronizacji i wybór trybu zbierania danych:

One Inventory (centrum administracyjne Power Platform): Łączy inwentaryzację centrum administracyjnego z danymi środowiskowymi, aby uzyskać szersze odkrywanie i bogatsze metadane.
Standard (tylko środowiska): Pobiera ekwipunek bezpośrednio z dostępnych środowisk.
Włącz codzienną automatyczną synchronizację: Uruchamia Agent Inventory według skonfigurowanego dziennego harmonogramu.

Wybierz opcję Zapisz, aby zastosować zmiany. Zapis jest wyłączony, gdy nie zmieniono ustawienia, gdy trwa zapis lub gdy ustawienia są niedostępne podczas aktywnej synchronizacji.

Wskazówka

Użyj Odśwież dane pulpitu nawigacyjnego po zakończeniu synchronizacji, gdy pulpit nawigacyjny musi ponownie wczytać istniejące dane tabeli. Używaj agentów Sync tylko wtedy, gdy zbieranie zapasów musi być ponownie przeprowadzone. W bardzo dużych dzierżawach filtry środowisk i agentów należy utrzymywać możliwie jak najbardziej zawężone, a gdy analizy użycia z ostatnich 180 dni nie są wymagane, należy wyłączyć zbieranie danych o użyciu.

Tryby zbierania danych

Ustawienie trybu zbierania danych określa, jak system wykrywa i zbiera rekordy agentów.

Tryb One Inventory (zalecany)

Gdy ustawisz tryb zbierania na One Inventory, Agent Inventory korzysta z danych One Inventory:

Pobiera dane agentów z One Inventory przez centrum administracyjne Power Platform.
Wyświetla listę środowisk przy użyciu odwołania do połączenia Copilot Agent Kit - Power Platform for Admins V2.
Łączy dane agenta One Inventory z listą środowisk, aby skonstruować szczegóły środowiska.
Dla każdego środowiska ładuje szczegóły agentów do Agent Inventory, łącząc agentów pobranych ze środowiska z odpowiadającymi im danymi z One Inventory.

Korzystaj z tego trybu, gdy potrzebujesz szerszego odkrywania tenantów i bogatszych metadanych centrum administracyjnego Power Platform. Agenci wykryti przez centrum administracyjne, ale niedostępni w ich środowisku, są nadal dodawani z ograniczonymi szczegółami.

Tryb standardowy

Gdy ustawiasz tryb zbierania na Standard, Agent Inventory korzysta ze standardowego podejścia do zbierania danych:

Wyświetla listę wszystkich środowisk przy użyciu odwołania do połączenia Copilot Agent Kit - Power Platform for Admins (V1).
Pobiera agentów dla każdego środowiska.
Ładuje dane agenta do Inventarza Agenta.

Używaj tego trybu, gdy chcesz, aby kolekcja opierała się wyłącznie na dostępnych środowiskach.

W obu trybach Inventar Agentów wykorzystuje referencję połączenia Copilot Agent Kit - Dataverse, aby łączyć się z każdym środowiskiem i zbierać szczegółowe informacje o agentach, w tym metadane, wykorzystanie funkcji i konfigurację. System pobiera szczegółowe informacje tylko dla środowisk, w których skonfigurowane konto ma dostęp administratora systemu.

Dowiedz się więcej o pełnej liście złączy używanych w całym zestawie w sekcji Wymagania złącza.

Metryki użycia

Agent Inventory może przechowywać i wyświetlać dane dotyczące użycia agentów przez maksymalnie 180 dni. Aby umożliwić analitykę użytkowania:

Upewnij się, że wymagane połączenia rozwiązań są skonfigurowane i dozwolone przez polityki danych.
Otwórz konfigurację synchronizacji agenta.
Włącz Uwzględnij metryki użytkowania.
Wybierz Zapisz.
Wybierz agentów synchronizacji lub poczekaj na codzienną automatyczną synchronizację.

Dane dotyczące użytkowania są przechowywane w tabelach Szczegóły Agenta oraz Historia Użytkowania Agenta . Zakładka Użycie agenta jest wyświetlana tylko wtedy, gdy są dostępne pasujące rekordy historii użycia.

Skonfiguruj połączenie HTTP z Microsoft Entra ID

Metryki użycia opierają się na złączu HTTP z Microsoft Entra ID (wstępnie autoryzowane). Wartości połączeń zależą od chmury, w której działa Twój tenant. Użyj Base Resource URL i identyfikatora URI zasobu Microsoft Entra ID odpowiadających używanej chmurze podczas tworzenia połączenia.

Cloud	Podstawowy adres URL zasobu	Microsoft Entra ID Resource URI
Komercyjny	`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/`

Uprawnienia i wymagania dotyczące złącza

Odwołania do połączeń w rozwiązaniu ograniczają i kontrolują widoczność do agentów. Aby mieć pełną widoczność dla całego dzierżawcy, skonfiguruj odniesienia do połączeń z kontem pełniącym rolę administratora Power Platform . Aby odzyskać wszystkie szczegóły na poziomie funkcji, to konto wymaga również dostępu administratora systemu do odpowiednich środowisk. Możesz użyć innych kont, ale widoczność spisu agentów jest ograniczona do środowisk, w których użytkownik ma dostęp administratora systemu.

Inventar Agentów opiera się na następujących złączach, które polityki danych stosowane w środowisku muszą umożliwiać:

Microsoft Dataverse
Platforma Power Platform dla administratorów
Power Platform dla Administratorów V2
Protokół HTTP z Microsoft Entra ID (z autoryzacją wstępną)