Hoppa till innehåll
Clevera Help Center

Åtgärda fel i AI-agenter och API

Varje meddelande som en AI-agent, ett skript eller en person kan se med Clevera-API:et, MCP-servern och sidan för AI-agenter och API, grupperat efter orsak: tokens, abonnemang, behörigheter, betalt arbete, hastighetsbegränsningar, konflikter och anslutna appar, tillsammans med åtgärden.

Uppdaterad 9 min läsning

När Clevera nekar ett anrop från en agent får agenten en kod och ett meddelande som anger vad som behöver göras. Den här artikeln listar alla meddelanden som en agent, ett skript eller en person kan se med AI-agenter och API, vad som orsakar dem och hur du åtgärdar dem. Via REST-API:et finns koden i error.code; via MCP kommer samma meddelande tillbaka som ett verktygsfel.

Token accepteras inte

Meddelande Kod Orsak Åtgärd
"Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." unauthenticated Ingen token skickades. Skicka Authorization: Bearer <token>. Kontrollera att CLEVERA_TOKEN är inställd där agenten körs.
"That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." unauthenticated Värdet är felstavat, avklippt eller inte en Clevera-token. Klistra in hela token igen.
"Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." unauthenticated Clevera känner inte igen denna token. Skapa en ny token.
"OAuth connector tokens work on the MCP server only. Use a static token for the REST API." unauthenticated En ansluten apps inloggning användes på REST-API:et. Använd en API-token för REST.
"This token has expired. Create a new one in Integrations → AI agents & API." token_expired Dess livslängd har gått ut. Skapa en ny token.
"This token was revoked." token_revoked Någon återkallade den, den återskapades, dess ägare lämnade eller Clevera återkallade den. Se varför en token slutade fungera.
"The account that owns this token is suspended." token_revoked Ägarens konto är avstängt. Kontakta supporten.
"This token can't be used from this IP address." ip_not_allowed Anropet kom utanför tokenens IP-tillåtelselista. Kör agenten från en tillåten adress eller skapa en token med den nya adressen.

Abonnemanget inkluderar det inte

AI-agenter och API (tokens, anslutna appar och webhooks) ingår i abonnemangen Pro, Business och Custom. På Free och Starter visar sidan "AI agents & API are included in Pro" med Uppgradera till Pro. När du uppgraderar fungerar befintliga tokens, appar och webhooks igen; ingenting raderas.

Meddelande Kod Orsak Åtgärd
"The agent API is not on this workspace's plan. It is on Pro and up." plan_locked (HTTP 403) Arbetsytan har Free eller Starter, eller har flyttats till ett sådant. Varje token och anrop från ansluten app nekas. Uppgradera till Pro. Tokens som inte har gått ut fungerar igen.
Claude eller ChatGPT säger bara att anslutningen misslyckades, eller dess Clevera-verktyg misslyckas plan_locked i bakgrunden Samma nekande av abonnemang, visas av appen som ett generiskt anslutningsfel. Uppgradera arbetsytan till Pro och försök igen i appen.
"The API and agent access are not on your plan." — Skapa en token eller klicka på Godkänn på en agentförfrågan utanför Pro. Uppgradera till Pro. Neka fungerar fortfarande.
"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." — En låst kontroll på Free eller Starter. Uppgradera till Pro.
workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." — Ansluta Claude eller ChatGPT till en arbetsyta utanför Pro. Uppgradera eller välj en annan arbetsyta på anslutningsskärmen.
Återskapa hemlighet öppnar uppgraderingsdialogen — Hemligheter kan inte återskapas utanför Pro. Uppgradera till Pro eller återkalla token.
"Webhooks are not on your plan." — Skicka test-händelse eller Leverera igen utanför Pro. Ingenting skickas; väntande försök misslyckas med plan_locked. Uppgradera till Pro.
"Your plan does not include paid agent work. Upgrade to let agents start it." plan_locked Betalt arbete på ett abonnemang utan det. Uppgradera till Pro.

Token har inte tillåtelse att

Meddelande Kod Orsak Åtgärd
"This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." forbidden_ability Token saknar behörigheten som detta anrop kräver. Skapa en token med den behörigheten. Se Agentbehörigheter.
"The token owner's current role in this workspace does not allow ability." forbidden_role Ägarens roll ändrades sedan token skapades. Token visar Överskrider roll. Någon med rätt roll skapar token.
"Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." — Skapa en token med behörigheter utöver din roll. Avmarkera dem eller fråga en ägare eller administratör.
"You can't do this in this workspace." forbidden Ägarens roll eller åtkomst tillåter inte denna åtgärd på detta objekt. Kontrollera ägarens roll och samlingsåtkomst.
"The token owner can view this article but not edit it (collection access)." forbidden_item Objektet finns i en samling som ägaren bara kan visa. Ge ägaren redigeringsåtkomst till samlingen.
"No item with that id in this token's scope. List or search first and use a returned id." not_found Fel id, eller objektet är utanför tokenens webbplatser eller ägarens åtkomst. Lista eller sök, använd sedan ett returnerat id.
"This content is live on a published site, so changing it needs the site:publish ability." live_content_needs_publish Redigera (eller översätta) en publicerad artikel utan publiceringsrättigheter. Ge token site:publish eller låt den skicka in för granskning.
"This article is also shown on a site this token cannot change. …" shared_outside_scope Artikeln visas på en webbplats utanför tokenens webbplatser. Använd en token som täcker varje webbplats där den visas, eller lämna en granskningsnotering.
"This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." site_paused Webbplatsen är pausad. Återaktivera webbplatsen.
Meddelande Kod Orsak Åtgärd
"This would pass the token's spend cap. A workspace admin can raise it." cap_exceeded Offerten passar inte tokenens gräns Per jobb, Per dag eller Per månad. Vänta till nästa dag eller månad, eller skapa en token med högre gränser.
Ett meddelande om att krediter tar slut insufficient_credits Arbetsytan har inte tillräckligt med krediter. Köp krediter eller vänta på tilldelningen.
"Your workspace cannot spend credits right now." plan_locked Fakturering blockerar utgifter, till exempel en obetald faktura. Kontrollera Fakturering.
"This quote has expired. Ask for a new quote." quote_expired Offerter gäller i 15 minuter. Be om en ny offert.
"This quote was already used. Ask for a new quote." quote_used En offert startar ett jobb. Be om en ny offert.
"This quote is for another kind of job." quote_mismatch En video-offert användes för att starta ett klipp, till exempel. Använd det matchande start-anropet.
"Another start is being checked. Try again in a moment." busy Två starter vid samma tillfälle. Försök igen om en stund.
Jobbet väntar med needs_input — Det väntar på godkännande under Agentförfrågningar. En ägare eller administratör godkänner eller nekar det inom 24 timmar.
Jobbet avslutas expired — Ingen fattade beslut inom 24 timmar. Starta igen och godkänn det.
"This job can no longer be canceled." not_cancelable Jobbet är redan klart eller har passerat punkten för avbokning. —

Vanliga indatameddelanden vid begäran av videor: "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."

För många förfrågningar

Meddelande Kod Gräns
"This token is over its request rate. Wait and retry." rate_limited 300 förfrågningar per minut per token
"This workspace is over its agent request rate. Wait and retry." rate_limited 1 200 per minut per arbetsyta
"Too many writes from this token. Wait and retry." rate_limited 60 skrivningar per minut per token
"This token reached its daily write limit. Try again tomorrow." rate_limited 2 000 skrivningar per dag per token
"This token reached its hourly publish limit. Try again later." rate_limited 10 publiceringar per timme per token
"Too many uploads from this token. Wait and retry." rate_limited 30 uppladdningar per minut
"This token reached its daily upload volume. Try again tomorrow." rate_limited 500 MB per dag per token
"Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." rate_limited Ovanlig aktivitet: skrivningar pausas i 10 minuter
"Too many requests. Wait and retry." rate_limited 60 per minut per IP-adress utan en giltig token

Betalda starter är också begränsade till 20 per timme per token och 100 per dag per arbetsyta. Varje 429 har en Retry-After-rubrik; vänta så länge.

Innehåll och nya försök

Meddelande Kod Lösning
"The content changed since you read it. Re-read it …, merge your change and retry with that id." revision_conflict Agenten läser sidan igen och tillämpar sin ändring på nytt.
"This idempotency key was used for a different request." idempotency_conflict / idempotency_key_reused Använd en ny Idempotency-Key för en ny begäran.
— idempotency_in_progress Den första begäran med denna nyckel körs fortfarande. Vänta och försök sedan igen med samma nyckel.

Tokens och sidan

Situation Orsak Lösning
Ny token är inaktiverad "Your workspace has reached its limit of 50 active tokens. Revoke one first." Återkalla en token du inte använder.
Ingen Återskapa hemlighet-alternativ Endast den som skapade token kan återskapa den, och endast en gång. "Only the person who created this token can regenerate it. You can revoke it." Återskapa den nyare token, eller skapa en ny.
"This token was already regenerated, revoked or has expired; use its replacement or create a new one." Hemligheten har återskapats tidigare. Använd ersättningstoken.
Du ser inte en kollegas token Endast ägare och administratörer ser alla tokens. Fråga en ägare eller administratör.
Du kan inte godkänna en begäran: "An owner or admin decides" Endast ägare och administratörer godkänner utgifter. Fråga en ägare eller administratör.
"Only owners and admins manage webhooks" Din roll kan inte hantera webhooks. Fråga en ägare eller administratör.

Ansluta Claude eller ChatGPT

På skärmen Lösning
"This request expired" "Too much time passed since the app asked. Start connecting again from the app."
"This app isn’t registered" Ta bort anslutningen i appen och lägg till den igen.
"This request can’t be trusted" "Nothing was shared. Start connecting again from the app." Anslut inte om det fortsätter hända.
"Choose a workspace you are a member of." Välj en av dina arbetsytor.
"Revoked: token reuse detected" på en ansluten app Appens inloggning återanvändes, så Clevera återkallade den. Anslut appen igen.

Fortfarande problem

Kontakta supporten med request_id från felet, namnet på din token (aldrig själva token) och tidpunkten för anropet.

Hantera API-tokensVarför en token slutade fungera.AgentbehörigheterVilken behörighet ett anrop behöver.Kontrollera agentutgifter och godkännandenGränser, kvoter och godkännanden.Använd REST APIFelformat och hastighetsbegränsningar.