Rozwiązywanie problemów i odzyskiwanie
Tutaj sprawdzasz, kiedy możesz bezpiecznie kontynuować samodzielnie, a kiedy musisz zatrzymać się i przekazać pracę człowiekowi.
Brak kodu właściciela lub jest nieprawidłowy
Dział zatytułowany „Brak kodu właściciela lub jest nieprawidłowy”Jeśli brakuje wiadomości e-mail właściciela, wygasła, została zablokowana lub kod po nieudanych próbach nie jest już ważny, poproś dokładnie o jeden świeży kod przez POST /owner-otp/resend. Użyj do tego klucza instalacyjnego z /organizations.
Przy owner_otp_delivery.status: "suppressed" zatrzymujesz przepływ agenta i przekazujesz człowiekowi. Powtarzane ponowne wysyłanie bez wyjaśnienia nie jest ścieżką odzyskiwania.
Brak kodu e-mail agenta lub jest nieprawidłowy
Dział zatytułowany „Brak kodu e-mail agenta lub jest nieprawidłowy”Jeśli ustawiono agent_email, a kod e-mail agenta brakuje lub wygasł, poproś o świeży kod przez POST /agent-otp/resend.
Następnie użyj nowego agent_otp_delivery.correlation_id. Szukaj w skrzynce pocztowej agenta fragmentu tematu Ref: <correlation_id> i odczytaj kod z osobnej linii treści Code: <OTP>.
Utrata klucza instalacyjnego
Dział zatytułowany „Utrata klucza instalacyjnego”Klucze instalacyjne w postaci jawnej nie są wyświetlane ponownie. Jeśli klucz instalacyjny z /organizations lub świeżo zrotowany klucz został utracony, zatrzymaj się.
Celowo nie ma ścieżki samoobsługowej, która przywracałaby utracony klucz instalacyjny. Nie uruchamiaj po prostu drugiej organizacji jako zamiennika. Przekaż odpowiedzialnemu właścicielowi i webRichtung, aby organizacja, portfel i łańcuch audytu zostały zachowane.
HTTP 412 w procesie tworzenia
Dział zatytułowany „HTTP 412 w procesie tworzenia”GET /org/current przed pomyślnym roszczeniem właściciela może odpowiedzieć HTTP 412 precondition_failed. Jeśli ustawiono agent_email, to samo dotyczy sytuacji przed pomyślną weryfikacją e-mail agenta. Jest to oczekiwane zachowanie: brakuje jeszcze wymaganej autoryzacji.
Kolejnym krokiem nie jest spam ponownych prób. Poczekaj na brakujący kod, wywołaj POST /owner-otp/claim lub POST /agent-otp/verify i użyj /org/current dopiero potem jako odczytu statusu. /keys/rotate jest również zablokowany przed tymi kodami OTP. Operacyjne wywołania /mcp/dry_run i /mcp/invoke pozostają dodatkowo zablokowane do odblokowania przez webRichtung. Pełna reguła błędów znajduje się w taksonomii błędów.
Odblokowanie pozostaje w statusie oczekiwania
Dział zatytułowany „Odblokowanie pozostaje w statusie oczekiwania”Po roszczeniu właściciela i opcjonalnej weryfikacji e-mail agenta, agent odpytuje GET /org/current:
- pierwsze odpytanie po 30 sekundach
- następnie maksymalnie raz na 60 sekund
- maksymalnie przez 15 minut
Jeśli installation.operator_approval_status pozostaje po tym czasie w statusie pending, zatrzymaj przepływ i przekaż odpowiedzialnej osobie. Przy statusie blocked zatrzymujesz natychmiast.