Przejdź do treści
Centrum pomocy Clevera

Naprawianie błędów agentów AI i API

Każdy komunikat, który agent AI, skrypt lub użytkownik może zobaczyć w API Clevera, serwerze MCP oraz na stronie AI agents & API, pogrupowany według przyczyny: tokeny, plan, uprawnienia, płatne zadania, limity zapytań, konflikty i łączenie aplikacji, wraz z rozwiązaniem.

Zaktualizowano 9 min czytania

Gdy Clevera odrzuca wywołanie agenta, agent otrzymuje kod oraz komunikat informujący o tym, co należy zrobić. Ten artykuł zawiera listę wszystkich komunikatów, które agent, skrypt lub użytkownik może zobaczyć w AI agents & API, ich przyczyny oraz sposoby naprawy. W przypadku REST API kod znajduje się w error.code; w przypadku MCP ten sam komunikat wraca jako błąd narzędzia.

Token nie został zaakceptowany

Komunikat Kod Przyczyna Rozwiązanie
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Nie wysłano tokena. Wyślij Authorization: Bearer <token>. Sprawdź, czy CLEVERA_TOKEN jest ustawione tam, gdzie działa agent.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated Wartość jest błędna, ucięta lub nie jest tokenem Clevera. Wklej ponownie cały token.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera nie rozpoznaje tego tokena. Utwórz nowy token.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated Użyto logowania połączonej aplikacji w REST API. Użyj tokena API dla REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Jego czas ważności minął. Utwórz nowy token.
"This token was revoked." token_revoked Ktoś go unieważnił, został wygenerowany ponownie, jego właściciel odszedł lub Clevera go unieważniła. Zobacz dlaczego token przestał działać.
"The account that owns this token is suspended." token_revoked Konto właściciela jest zawieszone. Skontaktuj się z pomocą techniczną.
"This token can't be used from this IP address." ip_not_allowed Wywołanie pochodzi spoza listy dozwolonych adresów IP tokena. Uruchom agenta z dozwolonego adresu lub utwórz token z nowym adresem.

Plan nie obejmuje tej funkcji

AI agents & API (tokeny, połączone aplikacje i webhooki) są dostępne w planach Pro, Business i Custom. W planach Free i Starter strona wyświetla komunikat "AI agents & API are included in Pro" wraz z przyciskiem Przejdź na Pro. Przejście na wyższy plan sprawia, że istniejące tokeny, aplikacje i webhooki znów działają; nic nie jest usuwane.

Komunikat Kod Przyczyna Rozwiązanie
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) Obszar roboczy jest w planie Free lub Starter, lub został do niego przeniesiony. Każde wywołanie tokena i połączonej aplikacji jest odrzucane. Przejdź na Pro. Tokeny, które nie wygasły, znów działają.
Claude lub ChatGPT informuje tylko, że nie może się połączyć, lub jego narzędzia Clevera zawodzą plan_locked w tle Ta sama odmowa planu, wyświetlana przez aplikację jako ogólny błąd połączenia. Przejdź na Pro dla obszaru roboczego, a następnie ponów próbę w aplikacji.
"The API and agent access are not on your plan." — Tworzenie tokena lub kliknięcie Zatwierdź przy żądaniu agenta poza planem Pro. Przejdź na Pro. Odrzuć nadal działa.
"The API and agent access are on Pro and up." / "Claude.ai and ChatGPT connectors are on Pro and up." / "Webhooks are on Pro and up." — Zablokowana kontrolka w planie Free lub Starter. Przejdź na Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Łączenie Claude lub ChatGPT z obszarem roboczym poza planem Pro. Przejdź na wyższy plan lub wybierz inny obszar roboczy na ekranie łączenia.
Wygeneruj ponownie klucz otwiera okno dialogowe aktualizacji — Kluczy nie można regenerować poza planem Pro. Przejdź na Pro lub unieważnij token.
"Webhooks are not on your plan." — Wyślij zdarzenie testowe lub Dostarcz ponownie poza planem Pro. Nic nie jest wysyłane; oczekujące ponowne próby kończą się niepowodzeniem z plan_locked. Przejdź na Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Płatna praca w planie, który jej nie obejmuje. Przejdź na Pro.

Token nie ma uprawnień do

Komunikat Kod Przyczyna Rozwiązanie
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Token nie ma uprawnienia wymaganego przez to wywołanie. Utwórz token z tym uprawnieniem. Zobacz Uprawnienia agenta.
"The token owner's current role in this workspace does not allow ability." forbidden_role Rola właściciela zmieniła się od czasu utworzenia tokena. Token pokazuje Przekracza uprawnienia roli. Ktoś z odpowiednią rolą tworzy token.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Tworzenie tokena z uprawnieniami wykraczającymi poza Twoją rolę. Odznacz je lub poproś właściciela albo administratora.
"You can't do this in this workspace." forbidden Rola lub dostęp właściciela nie pozwalają na tę akcję na tym elemencie. Sprawdź rolę właściciela i dostęp do kolekcji.
"The token owner can view this article but not edit it (collection access)." forbidden_item Element znajduje się w kolekcji, którą właściciel może tylko przeglądać. Nadaj właścicielowi dostęp do edycji kolekcji.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Błędne id lub element jest poza witrynami tokena albo dostępem właściciela. Wyświetl listę lub wyszukaj, a następnie użyj zwróconego id.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Edycja (lub tłumaczenie) artykułu na opublikowanej witrynie bez uprawnień do publikowania. Nadaj tokenowi site:publish lub pozwól mu przesłać do recenzji.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Artykuł pojawia się na witrynie spoza witryn tokena. Użyj tokena obejmującego każdą witrynę, na której się wyświetla, lub zostaw notatkę recenzji.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Witryna dokumentacji jest wstrzymana. Aktywuj ponownie witrynę.
Komunikat Kod Przyczyna Rozwiązanie
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Wycena przekracza limit tokena Na zadanie, Dziennie lub Miesięcznie. Poczekaj do następnego dnia lub miesiąca albo utwórz token z wyższymi limitami.
Komunikat o wyczerpaniu kredytów insufficient_credits Obszar roboczy nie ma wystarczającej liczby kredytów. Kup kredyty lub poczekaj na przydział.
"Your workspace cannot spend credits right now." plan_locked Rozliczenia blokują wydatki, np. z powodu zaległej płatności. Sprawdź Rozliczenia.
"This quote has expired. Ask for a new quote." quote_expired Wyceny są ważne przez 15 minut. Poproś o nową wycenę.
"This quote was already used. Ask for a new quote." quote_used Wycena rozpoczyna jedno zadanie. Poproś o nową wycenę.
"This quote is for another kind of job." quote_mismatch Wycena wideo została użyta np. do rozpoczęcia klipu. Użyj pasującego wywołania startowego.
"Another start is being checked. Try again in a moment." busy Dwa uruchomienia w tym samym momencie. Ponów próbę za chwilę.
Zadanie czeka z needs_input — Czeka na zatwierdzenie w Żądania agenta. Właściciel lub administrator zatwierdza lub odrzuca je w ciągu 24 godzin.
Zadanie kończy się expired — Nikt nie podjął decyzji w ciągu 24 godzin. Zacznij od nowa i zatwierdź.
"This job can no longer be canceled." not_cancelable Zadanie już się zakończyło lub minął moment, w którym można je anulować. —

Typowe komunikaty wejściowe przy żądaniu wideo: "This recording is still processing. Please wait until it is ready.", "Choose how_to, product_demo, cleanup or styled_video.", "Choose 1080p, 2k or 4k.", "Exports are always 60 fps.", "This item is an article; only videos can be exported.", "Social clips cannot be translated by agents yet.", "This language is already translated.", "That material was not found in this workspace. Upload it first."

Zbyt wiele żądań

Komunikat Kod Limit
"This token is over its request rate. Wait and retry." rate_limited 300 żądań na minutę na token
"This workspace is over its agent request rate. Wait and retry." rate_limited 1200 na minutę na obszar roboczy
"Too many writes from this token. Wait and retry." rate_limited 60 zapisów na minutę na token
"This token reached its daily write limit. Try again tomorrow." rate_limited 2000 zapisów dziennie na token
"This token reached its hourly publish limit. Try again later." rate_limited 10 publikacji na godzinę na token
"Too many uploads from this token. Wait and retry." rate_limited 30 przesłań na minutę
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB dziennie na token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Nietypowa aktywność: zapisy wstrzymane na 10 minut
"Too many requests. Wait and retry." rate_limited 60 na minutę na adres IP bez ważnego tokena

Płatne uruchomienia są również ograniczone do 20 na godzinę na token i 100 dziennie na obszar roboczy. Każdy 429 posiada nagłówek Retry-After; odczekaj tyle czasu.

Zawartość i ponowne próby

Komunikat Kod Rozwiązanie
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict Agent ponownie odczytuje stronę i nanosi swoje zmiany.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Użyj nowego Idempotency-Key dla nowego żądania.
— idempotency_in_progress Pierwsze żądanie z tym kluczem jest nadal w toku. Odczekaj, a następnie ponów próbę z tym samym kluczem.

Tokeny i strona

Sytuacja Przyczyna Rozwiązanie
Nowy token jest wyłączony "Your workspace has reached its limit of 50 active tokens. Revoke one first." Unieważnij nieużywany token.
Brak opcji Wygeneruj ponownie klucz Tylko twórca tokena może go wygenerować ponownie i tylko raz. "Only the person who created this token can regenerate it. You can revoke it." Wygeneruj ponownie nowszy token lub utwórz nowy.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Klucz został już wcześniej wygenerowany ponownie. Użyj tokena zastępczego.
Nie widzisz tokena współpracownika Tylko właściciele i administratorzy widzą wszystkie tokeny. Poproś właściciela lub administratora.
Nie możesz zatwierdzić żądania: "An owner or admin decides" Tylko właściciele i administratorzy zatwierdzają wydatki. Poproś właściciela lub administratora.
"Only owners and admins manage webhooks" Twoja rola nie pozwala na zarządzanie webhookami. Poproś właściciela lub administratora.

Łączenie Claude lub ChatGPT

Na ekranie Rozwiązanie
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Usuń konektor w aplikacji i dodaj go ponownie.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Nie łącz się, jeśli problem nadal występuje.
"Choose a workspace you are a member of." Wybierz jeden ze swoich obszarów roboczych.
"Revoked: token reuse detected" w połączonej aplikacji Logowanie do aplikacji zostało użyte ponownie, więc Clevera je unieważniła. Połącz aplikację ponownie.

Nadal masz problem

Skontaktuj się z pomocą techniczną, podając request_id z błędu, nazwę tokena (nigdy samego tokena) oraz czas wywołania.

Zarządzanie tokenami APIDlaczego token przestał działać.Uprawnienia agentaJakich uprawnień wymaga wywołanie.Kontrola wydatków i zatwierdzeń agentaLimity, kwoty i zatwierdzenia.Korzystanie z REST APIFormat błędów i limity zapytań.