כאשר Clevera מסרבת לקריאה של סוכן, הסוכן מקבל קוד והודעה שמציינת מה לעשות. מאמר זה מפרט כל הודעה שסוכן, סקריפט או אדם עשויים לראות ב-AI agents & API, מה גורם לה וכיצד לתקן אותה. ב-REST API הקוד נמצא ב-error.code; ב-MCP אותה הודעה חוזרת כשגיאת כלי.
האסימון אינו מתקבל#
| הודעה |
קוד |
סיבה |
פתרון |
| "Send a Clevera agent token (Authorization: Bearer clv_agent_…) or connect through OAuth. Create a token in Integrations → AI agents & API." |
unauthenticated |
לא נשלח אסימון. |
שלח Authorization: Bearer <token>. בדוק ש-CLEVERA_TOKEN מוגדר היכן שהסוכן רץ. |
| "That is not a valid Clevera agent token. Create one in Integrations → AI agents & API." |
unauthenticated |
הערך שגוי, קטוע או אינו אסימון של Clevera. |
הדבק את האסימון המלא שוב. |
| "Unknown token. It may have been deleted; create a new one in Integrations → AI agents & API." |
unauthenticated |
Clevera לא מזהה את האסימון הזה. |
צור אסימון חדש. |
| "OAuth connector tokens work on the MCP server only. Use a static token for the REST API." |
unauthenticated |
נעשה שימוש בהתחברות של אפליקציה מחוברת ב-REST API. |
השתמש באסימון API עבור REST. |
| "This token has expired. Create a new one in Integrations → AI agents & API." |
token_expired |
תוקפו פג. |
צור אסימון חדש. |
| "This token was revoked." |
token_revoked |
מישהו ביטל אותו, הוא נוצר מחדש, הבעלים שלו עזב, או ש-Clevera ביטלה אותו. |
ראה מדוע אסימון הפסיק לעבוד. |
| "The account that owns this token is suspended." |
token_revoked |
החשבון של הבעלים מושעה. |
צור קשר עם התמיכה. |
| "This token can't be used from this IP address." |
ip_not_allowed |
הקריאה הגיעה מחוץ לרשימת היתרי ה-IP של האסימון. |
הרץ את הסוכן מכתובת מורשית, או צור אסימון עם הכתובת החדשה. |
התוכנית אינה כוללת זאת#
סוכני AI ו-API (אסימונים, אפליקציות מחוברות ו-webhooks) כלולים בתוכניות Pro, Business ו-Custom. בתוכניות Free ו-Starter הדף מציג "AI agents & API are included in Pro" עם שדרוג ל-Pro. שדרוג מחזיר את הפעילות של אסימונים, אפליקציות ו-webhooks קיימים; שום דבר לא נמחק.
| הודעה |
קוד |
סיבה |
פתרון |
| "The agent API is not on this workspace's plan. It is on Pro and up." |
plan_locked (HTTP 403) |
סביבת העבודה בתוכנית Free או Starter, או עברה לאחת כזו. כל קריאה של אסימון ואפליקציה מחוברת מסורבת. |
שדרוג ל-Pro. אסימונים שלא פג תוקפם יעבדו שוב. |
| Claude או ChatGPT רק אומרים שלא ניתן להתחבר, או שכלי ה-Clevera שלהם נכשלים |
plan_locked מאחורי הקלעים |
אותה סירוב תוכנית, מוצג על ידי האפליקציה כשגיאת חיבור כללית. |
שדרג את סביבת העבודה ל-Pro, ואז נסה שוב באפליקציה. |
| "The API and agent access are not on your plan." |
— |
יצירת אסימון, או לחיצה על אשר בבקשת סוכן, מחוץ ל-Pro. |
שדרוג ל-Pro. דחה עדיין עובד. |
| "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." |
— |
פקד נעול ב-Free או Starter. |
שדרוג ל-Pro. |
| workspace "(plan doesn’t include connected apps)" / "This workspace’s plan does not include connected apps." |
— |
חיבור Claude או ChatGPT לסביבת עבודה מחוץ ל-Pro. |
שדרג, או בחר סביבת עבודה אחרת במסך החיבור. |
| צור מחדש מפתח סודי פותח את תיבת השדרוג |
— |
לא ניתן ליצור מחדש מפתחות סודיים מחוץ ל-Pro. |
שדרוג ל-Pro, או ביטול האסימון. |
| "Webhooks are not on your plan." |
— |
שלח אירוע בדיקה או שלח מחדש מחוץ ל-Pro. שום דבר לא נשלח; ניסיונות חוזרים ממתינים מסתיימים כנכשלו עם plan_locked. |
שדרוג ל-Pro. |
| "Your plan does not include paid agent work. Upgrade to let agents start it." |
plan_locked |
עבודה בתשלום בתוכנית ללא אפשרות זו. |
שדרוג ל-Pro. |
לאסימון אין הרשאה ל-#
| הודעה |
קוד |
סיבה |
פתרון |
| "This token lacks the ability ability. Ask the workspace member who owns it for a token that has it." |
forbidden_ability |
לאסימון אין את ההרשאה שהקריאה הזו צריכה. |
צור אסימון עם ההרשאה הזו. ראה הרשאות סוכן. |
| "The token owner's current role in this workspace does not allow ability." |
forbidden_role |
התפקיד של הבעלים השתנה מאז יצירת האסימון. האסימון מציג חורג מהתפקיד. |
מישהו עם התפקיד המתאים יוצר את האסימון. |
| "Your role can’t grant some of these abilities." / "Your role can’t grant: abilities." |
— |
יצירת אסימון עם הרשאות מעבר לתפקיד שלך. |
בטל את הבחירה בהן, או בקש מבעלים או מנהל. |
| "You can't do this in this workspace." |
forbidden |
התפקיד או הגישה של הבעלים לא מאפשרים פעולה זו על פריט זה. |
בדוק את התפקיד של הבעלים ואת הגישה לאוסף. |
| "The token owner can view this article but not edit it (collection access)." |
forbidden_item |
הפריט נמצא באוסף שהבעלים יכול רק לצפות בו. |
תן לבעלים גישת עריכה לאוסף. |
| "No item with that id in this token's scope. List or search first and use a returned id." |
not_found |
מזהה שגוי, או שהפריט מחוץ לאתרים של האסימון או לגישה של הבעלים. |
רשום או חפש, ואז השתמש במזהה שהוחזר. |
| "This content is live on a published site, so changing it needs the site:publish ability." |
live_content_needs_publish |
עריכה (או תרגום) של מאמר באתר תיעוד חי ללא הרשאות פרסום. |
תן לאסימון site:publish, או תן לו להגיש לבדיקה. |
| "This article is also shown on a site this token cannot change. …" |
shared_outside_scope |
המאמר מופיע באתר מחוץ לאתרים של האסימון. |
השתמש באסימון שמכסה כל אתר שמציג אותו, או השאר הערת ביקורת. |
| "This site is paused or offline and read-only. A workspace owner can re-activate it in Docs." |
site_paused |
אתר התיעוד מושהה. |
הפעל מחדש את האתר. |
עבודה בתשלום מסורבת#
| הודעה |
קוד |
סיבה |
פתרון |
| "This would pass the token's spend cap. A workspace admin can raise it." |
cap_exceeded |
הצעת המחיר לא מתאימה למכסה למשימה, ליום או לחודש של האסימון. |
המתן ליום או לחודש הבא, או צור אסימון עם מכסות גבוהות יותר. |
| הודעה על כך שהקרדיטים אוזלים |
insufficient_credits |
בסביבת העבודה אין מספיק קרדיטים. |
קנה קרדיטים או המתן להקצאה. |
| "Your workspace cannot spend credits right now." |
plan_locked |
חיובים חוסמים הוצאות, למשל תשלום ממתין. |
בדוק את חיובים. |
| "This quote has expired. Ask for a new quote." |
quote_expired |
הצעות מחיר תקפות ל-15 דקות. |
בקש הצעת מחיר חדשה. |
| "This quote was already used. Ask for a new quote." |
quote_used |
הצעת מחיר מתחילה משימה אחת. |
בקש הצעת מחיר חדשה. |
| "This quote is for another kind of job." |
quote_mismatch |
הצעת מחיר לווידאו שימשה להתחלת קליפ, למשל. |
השתמש בקריאת ההתחלה התואמת. |
| "Another start is being checked. Try again in a moment." |
busy |
שתי התחלות באותו רגע. |
נסה שוב לאחר שנייה. |
המשימה ממתינה עם needs_input |
— |
היא ממתינה לאישור בבקשות סוכן. |
בעלים או מנהל מאשרים או דוחים אותה תוך 24 שעות. |
המשימה מסתיימת expired |
— |
אף אחד לא החליט תוך 24 שעות. |
התחל שוב ואשר אותה. |
| "This job can no longer be canceled." |
not_cancelable |
המשימה כבר הסתיימה או עברה את נקודת הביטול. |
— |
הודעות קלט נפוצות בעת בקשת סרטונים: "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."
יותר מדי בקשות#
| הודעה |
קוד |
מגבלה |
| "This token is over its request rate. Wait and retry." |
rate_limited |
300 בקשות לדקה לכל אסימון |
| "This workspace is over its agent request rate. Wait and retry." |
rate_limited |
1,200 לדקה לכל סביבת עבודה |
| "Too many writes from this token. Wait and retry." |
rate_limited |
60 כתיבות לדקה לכל אסימון |
| "This token reached its daily write limit. Try again tomorrow." |
rate_limited |
2,000 כתיבות ביום לכל אסימון |
| "This token reached its hourly publish limit. Try again later." |
rate_limited |
10 פרסומים בשעה לכל אסימון |
| "Too many uploads from this token. Wait and retry." |
rate_limited |
30 העלאות לדקה |
| "This token reached its daily upload volume. Try again tomorrow." |
rate_limited |
500 MB ביום לכל אסימון |
| "Writes from this token are paused after an unusual burst of changes. The workspace owner was notified." |
rate_limited |
פעילות חריגה: כתיבות מושהות ל-10 דקות |
| "Too many requests. Wait and retry." |
rate_limited |
60 לדקה לכל כתובת IP ללא אסימון תקף |
התחלות בתשלום מוגבלות גם הן ל-20 בשעה לכל אסימון ו-100 ביום לכל סביבת עבודה. לכל 429 יש כותרת Retry-After; המתן זמן זה.
תוכן וניסיונות חוזרים#
| הודעה |
קוד |
פתרון |
| "The content changed since you read it. Re-read it …, merge your change and retry with that id." |
revision_conflict |
הסוכן קורא את הדף שוב ומחיל מחדש את השינוי שלו. |
| "This idempotency key was used for a different request." |
idempotency_conflict / idempotency_key_reused |
השתמש ב-Idempotency-Key חדש עבור בקשה חדשה. |
| — |
idempotency_in_progress |
הבקשה הראשונה עם מפתח זה עדיין פועלת. המתן, ולאחר מכן נסה שוב עם אותו מפתח. |
אסימונים והדף#
| מצב |
סיבה |
פתרון |
| אסימון חדש מושבת |
"Your workspace has reached its limit of 50 active tokens. Revoke one first." |
בטל אסימון שאינך משתמש בו. |
| אין אפשרות צור מחדש מפתח סודי |
רק יוצר האסימון יכול ליצור אותו מחדש, ורק פעם אחת. "Only the person who created this token can regenerate it. You can revoke it." |
צור מחדש את האסימון החדש יותר, או צור אסימון חדש. |
| "This token was already regenerated, revoked or has expired; use its replacement or create a new one." |
המפתח הסודי נוצר מחדש בעבר. |
השתמש באסימון החלופי. |
| אינך רואה אסימון של עמית |
רק בעלים ומנהלים רואים כל אסימון. |
פנה לבעלים או למנהל. |
| אינך יכול לאשר בקשה: "An owner or admin decides" |
רק בעלים ומנהלים מאשרים הוצאות. |
פנה לבעלים או למנהל. |
| "Only owners and admins manage webhooks" |
התפקיד שלך אינו יכול לנהל webhooks. |
פנה לבעלים או למנהל. |
חיבור Claude או ChatGPT#
| על המסך |
פתרון |
| "This request expired" |
"Too much time passed since the app asked. Start connecting again from the app." |
| "This app isn’t registered" |
הסר את המחבר באפליקציה והוסף אותו שוב. |
| "This request can’t be trusted" |
"Nothing was shared. Start connecting again from the app." אל תתחבר אם זה ממשיך לקרות. |
| "Choose a workspace you are a member of." |
בחר אחת מסביבות העבודה שלך. |
| "Revoked: token reuse detected" באפליקציה מחוברת |
הכניסה לאפליקציה שומשה שוב, לכן Clevera ביטלה אותה. חבר את האפליקציה שוב. |
עדיין תקוע#
צור קשר עם התמיכה עם ה-request_id מהשגיאה, שם האסימון (לעולם לא את האסימון עצמו) וזמן הקריאה.
