Użyj śledzenia aktywności do debugowania agenta

Śledzenie aktywności w agentach zasilanych przez GitHub Copilot w Microsoft Copilot Studio pokazuje dokładnie, jak agent przetwarza każdą wiadomość. Użyj go, aby zrozumieć schemat rozumowania swojego agenta, zweryfikować przypisanie źródła wiedzy, potwierdzić wykonanie narzędzia oraz diagnozować błędy.

Note

Funkcje opisane w tym artykule są zasilane przez szelkę GitHub Copilot, która wykorzystuje Copilot Credits do rozliczeń opartych na użytkowaniu. Dowiedz się więcej o kredytach Copilot w Przeglądzie rozliczeń dla agentów zasilanych przez GitHub Copilot harness.

Rozliczanie oparte na użytkowaniu dotyczy korzystania, budowania, testowania i oceny agentów. Te działania mogą pochłaniać kredyty Copilot.

Wymagania wstępne

  • Agent stworzony za pomocą ukotry GitHub Copilot
  • Przynajmniej jedna testowa konwersacja na karcie Podgląd

Otwórz ślad aktywności

  1. Otwórz agenta w Copilot Studio i wybierz kartę Podgląd.

  2. Upewnij się, że przełącznik wersji zapoznawczej użytkownika końcowego jest wyłączony (domyślny widok twórcy). Śledzenie aktywności pojawia się obok panelu czatu, pokazując szczegóły przetwarzania każdej wiadomości.

  3. Wyślij wiadomość do swojego agenta. Śledzenie aktywności aktualizuje się w czasie rzeczywistym, gdy agent przetwarza wiadomość.

Omówienie śledzenia

Śledzenie aktywności wyświetla widok łańcucha rozumowania (CoT) przetwarzania Twojego agenta. Każdy etap w śladzie aktywności pojawia się jako węzeł, który pokazuje, co zrobił agent i dlaczego.

Typy węzłów

Ślad może obejmować następujące typy węzłów:

Typ węzła Co pokazuje
Komunikat użytkownika Wiadomość, którą wysłałeś do agenta
Odpowiedź agenta Odpowiedź wygenerowana przez agenta
Wiedza Źródło wiedzy, które agent wykorzystał do osadzenia odpowiedzi. Wyświetlana jako składana karta „Wiedza wyszukana”, pokazująca źródła dla każdego wykorzystanego źródła wiedzy oraz linki do cytowań, gdy są dostępne.
Wykonano akcję Wywołanie konektora lub narzędzia wyświetlane jako składana karta pokazująca konektor, wypełnione parametry wejściowe oraz czas wykonania
Narzędzie Narzędzie, które agent wywołał, aby wykonać akcję lub pobrać dane
Łącznik Złącze, którego agent używał do dostępu do danych zewnętrznych
Przepływ Przepływ agenta, który został wywołany
Zręczność Umiejętność wykonana
Error Błąd, który wystąpił podczas przetwarzania
Zakończony „Zielony znak wyboru” wyświetlany na dole śladu, gdy wszystkie wywołania narzędzi zostały zakończone

Wyświetlanie szczegółów węzła

  1. Wybierz dowolny węzeł w śladzie, aby rozwinąć jego szczegóły.

  2. Przejrzyj wyświetlane informacje, które mogą obejmować:

    • Dane wejściowe wysłane przez agenta do kroku
    • Wyjście lub zwrócony wynik
    • Czas przetwarzania i metryki
    • Szczegóły błędu, jeśli krok zakończył się niepowodzeniem

Problemy ze źródłem wiedzy debugowania

Gdy agent korzysta z wiedzy do udzielenia odpowiedzi na pytanie, śledzenie pokazuje, które źródła zostały użyte:

  1. Znajdź w śledzeniu węzeł Wiedza.

  2. Przejrzyj źródło, aby zobaczyć, do których źródeł wiedzy się udało.

  3. Wybierz źródło, aby wyświetlić pobraną treść.

  4. Zweryfikuj, czy agent użył właściwego źródła i czy uzyskana treść jest istotna.

Jeśli agent użył niewłaściwego źródła lub zwrócił niedokładne informacje, sprawdź konfigurację wiedzy w zakładce Tworzenie.

Debugowanie procesu wykonywania narzędzi

Gdy agent wywołuje narzędzie, ślad pokazuje szczegóły wykonania.

  1. Znajdź węzeł narzędzia, łącznika, przepływu, lub umiejętności w śledzeniu.

  2. Przejrzyj szczegóły wykonania, w tym parametry wejściowe i dane wyjściowe.

  3. Sprawdź, czy właściwe narzędzie zostało wywołane i czy wyniki są zgodne z oczekiwaniami.

  4. Jeśli wykonanie narzędzia nie powiodło się, przejrzyj szczegóły błędu w węźle.

Aby przekonfigurować narzędzie, otwórz zakładkę Tworzyć i znajdź narzędzie w konfiguracji swojego agenta.

Rozwiązywanie błędów

Gdy podczas przetwarzania występują błędy, ślad aktywności je podkreśla:

  1. Znajdź węzły oznaczone oznaczeniem błędu w śladzie aktywności.

  2. Wybierz węzeł błędu, aby wyświetlić szczegóły błędu, w tym komunikat o błędzie i kontekst.

  3. Typowe problemy są następujące:

    • Niepowodzenia uwierzytelniania narzędzi lub konektorów
    • Błędy dostępu do źródeł wiedzy
    • Błędy przekroczenia czasu dla długotrwałych wywołań narzędzi
    • Flagi moderowania zawartości

  4. Usuń główną przyczynę w zakładce Tworzenie lub w zakładce Ustawienia, a następnie ponownie przetestuj.

Ślad aktywności integruje się z zakładką Tworzenie, umożliwiając szybką edycję.

  1. Wybierz dowolne źródło, narzędzie lub komponent w śladzie aktywności.

  2. Copilot Studio przechodzi do odpowiedniego komponentu w zakładce Tworzenie.

  3. Wprowadź zmiany i wróć do zakładki Podgląd, aby ponownie przetestować.

  • Last updated on