Użyj śledzenia aktywności do debugowania agenta

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

Wymagania wstępne

• Agent utworzony przy użyciu harness 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. Ślad jest aktualizowany w czasie rzeczywistym, gdy agent przetwarza wiadomość.

Zrozum śledzenie aktywności

Ś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:

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
   • Dane wyjściowe lub zwrócony wynik
   • Czas przetwarzania i metryki
   • Szczegóły błędu, jeśli krok zakończył się niepowodzeniem

Debuguj problemy ze źródłem wiedzy

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 Twój agent wywołuje narzędzie, ślad pokazuje szczegóły wykonania:

1. Znajdź węzeł Narzędzie, Łącznik, Przepływ, lub Umiejętność 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ąpią błędy, śledzenie je wyróżnia:

1. Znajdź w śladzie węzły oznaczone wskaźnikiem błędu.

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 limitu 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.

Nawiguj ze śladu aktywności do zakładki „Tworzenie”

Ś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.

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

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

Informacje pokrewne

• Podejrzyj i przetestuj agenta
• Przetestuj agenta
• Podziel się swoim agentem z innymi
• Zarządzaj rozmowami podglądowymi
• Monitoruj agenta