Rozwiązywanie problemów z agentami AI
Kto może korzystać z tej funkcji
- funkcja jest dostępna na platformie monday AI. Wkrótce będzie dostępna we wszystkich produktach.
W tym artykule dowiesz się, jak diagnozować i rozwiązywać problemy z agentem AI. Agenci działają w sposób ciągły na podstawie określonych przez Ciebie instrukcji, uprawnień i wyzwalaczy. Wykonują działania na Twoich tablicach i w połączonych narzędziach. Jeśli agent zachowuje się nieoczekiwanie, nie uruchamia się wtedy, kiedy powinien, lub generuje wyniki, które wymagają dopracowania, skorzystaj z poniższych wskazówek, aby ustalić przyczynę i rozwiązać problem.
Pełny opis agentów AI znajdziesz w artykule Agenci AI w monday.com.
Jak rozwiązywać problemy z agentem
Agenci stale analizują sytuację i wykonują działania na podstawie podanych instrukcji. Działają więc w ciągłej pętli.
Jeśli agent wykonuje działania niezgodne z określonym zakresem lub wygląda na to, że utknął w pętli:
- Użyj przycisku przerwania / zatrzymania, aby zatrzymać działanie.
- Wróć do instrukcji na karcie „Mózg” (Brain) i dopracuj je tak, aby dokładnie określały, co ma robić agent.
- Jeśli wszystko zostało poprawnie skonfigurowane, a problem nadal występuje, skontaktuj się z pomocą techniczną.
Pamiętaj, że zmiany wprowadzone podczas działania agenta nie wpłyną na bieżące uruchomienie. Zostaną uwzględnione dopiero przy kolejnych uruchomieniach.
Zanim zgłosisz problem, zazwyczaj możesz sprawdzić działanie agenta bezpośrednio w produkcie. Konfiguracja agenta jest przedstawiona w czytelny sposób, więc możesz przejrzeć jego instrukcje, uprawnienia, narzędzia i połączone zasoby bez specjalistycznej wiedzy technicznej.
Możesz też otworzyć kartę „Aktywność” (Activity), aby przejrzeć każde uruchomienie: sprawdzić, co agent zrobił, kiedy się uruchomił i dlaczego wykonał dane działanie.
Jak rozwiązywać problemy z agentem AI?
- Przejrzyj konfigurację agenta w interfejsie, aby sprawdzić jego uprawnienia, narzędzia i prompty.
- Przejdź do karty Aktywność i otwórz dziennik uruchomienia.
- Przejrzyj tok rozumowania agenta, jego plan i wykonane działania.
- Sprawdź, czy wyzwalacze, warunki i dane wejściowe są poprawnie skonfigurowane.
- Upewnij się, że odpowiednie tablice, dokumenty i integracje są połączone i dostępne.
Dlaczego agent nie ma dostępu do tablicy ani danych?
- Sprawdź, czy agent ma dostęp do odpowiednich tablic lub dokumentów.
- Upewnij się, że osoba, która utworzyła agenta, ma dostęp do tych zasobów.
- Sprawdź, czy ostatnio zmieniono uprawnienia.
- W razie potrzeby połącz zasób ponownie lub skonfiguruj go ponownie w ustawieniach agenta.
Dlaczego agent wykonał działanie, którego nie powinien wykonać?
- Przejrzyj skonfigurowane działania i logikę agenta.
- Sprawdź, czy uprawnienia nie pozwalają na szerszy zakres działań, niż zamierzono.
- Zweryfikuj wyzwalacze i warunki, które doprowadziły do wykonania działania.
- Zmień konfigurację, aby ograniczyć niepożądane działania.
- Uruchom agenta w trybie podglądu (Preview Mode), aby sprawdzić jego działanie (ta opcja będzie przydatna po przywróceniu karty podglądu).
Dlaczego agent nie wykonał działania, które powinien wykonać?
- Przejrzyj wyzwalacze i sprawdź, czy warunki są poprawnie skonfigurowane.
- Upewnij się, że zdarzenie wyzwalające rzeczywiście wystąpiło.
- Sprawdź, czy nie brakuje danych wejściowych lub wymaganych pól.
- Zweryfikuj konfigurację.
Dlaczego wyniki agenta są niekompletne lub nieprawidłowe?
- Przejrzyj instrukcje lub prompt przekazany agentowi.
- Upewnij się, że odpowiednie źródła danych są połączone.
- Sprawdź, czy instrukcje nie są niejednoznaczne ani sprzeczne.
- Przetestuj agenta z prostszymi danymi wejściowymi, aby ustalić przyczynę problemu.
Dlaczego agent się nie uruchamia?
- Sprawdź, czy warunki wyzwalacza są poprawnie skonfigurowane.
- Upewnij się, że zdarzenie wyzwalające rzeczywiście wystąpiło.
- Sprawdź, czy agent nie jest wstrzymany.
- Przejrzyj kartę Aktywność w poszukiwaniu prób uruchomienia.
Dlaczego nie możesz uzyskać dostępu do agenta ani go uruchomić?
- Sprawdź, czy masz uprawnienia do dostępu do agenta jako osoba przeglądająca (Viewer) lub edytująca.
- Upewnij się, że agent został Ci udostępniony.
- Sprawdź ograniczenia dotyczące obszaru roboczego lub konta.
- W razie potrzeby udostępnij agenta ponownie.
Dlaczego działania agenta są niejasne lub nieoczekiwane?
- Przejdź do karty Aktywność.
- Sprawdź, co agent zrobił, kiedy i dlaczego.
- Porównaj jego działania ze skonfigurowaną logiką.
- Zmień konfigurację, jeśli działania agenta są niezgodne z oczekiwaniami.
Co zrobić, jeśli masz wątpliwości dotyczące bezpieczeństwa danych lub dostępu?
- Zadaj pytania, które pomogą ustalić przyczynę wątpliwości, na przykład dotyczących ujawnienia danych, uprawnień lub integracji.
- Sprawdź, które tablice, dokumenty i integracje są połączone.
- Upewnij się, że agent działa w ramach istniejących i określonych uprawnień.
- W razie potrzeby ogranicz dostęp do poufnych zasobów.
Dlaczego agent działa w podglądzie, ale nie działa w środowisku produkcyjnym?
- Porównaj warunki w trybie podglądu i w środowisku produkcyjnym, w tym dane i wyzwalacze.
- Sprawdź, czy dane w środowisku produkcyjnym spełniają warunki wyzwalacza.
- Zweryfikuj uprawnienia w środowisku produkcyjnym.
- Ponownie przeprowadź testy na podstawie rzeczywistych scenariuszy.
Dlaczego za uruchomienie agenta naliczono kredyty?
- Sprawdź, jakie działania agent wykonał podczas uruchomienia.
- Sprawdź, które funkcje lub narzędzia zostały użyte.
- Porównaj wykorzystanie funkcji z zasadami naliczania kredytów.
- Określ, jak podobne uruchomienia mogą być rozliczane w przyszłości.
Dlaczego nie można edytować agenta ani nim zarządzać?
- Sprawdź, czy masz uprawnienia do edycji.
- Ustal, kto jest obecnym właścicielem agenta.
- Pamiętaj, że nie można przenieść własności agenta.
Dlaczego agent sam wyzwala się w pętli?
Agenci nie mogą wyzwalać samych siebie. Zapobiega to niezamierzonemu zużyciu kredytów. Przykładem takiej reguły jest: „Za każdym razem, gdy zostanie utworzony element, utwórz element”. Gdy takie samoczynne wyzwolenie zostanie zablokowane, na karcie Aktywność pojawi się wyjaśnienie oraz powiadomienie z instrukcjami rozwiązania problemu. Przejrzyj i zaktualizuj konfigurację wyzwalacza, aby przerwać pętlę.
Wskazówka: W wielu przypadkach najszybciej rozwiążesz problem z agentem AI, porównując instrukcje i uprawnienia na karcie „Mózg” z danymi uruchomienia na karcie „Aktywność”.