إصلاح أخطاء وكيل AI وAPI
كل رسالة قد يراها وكيل AI أو برنامج نصي أو شخص ما باستخدام API الخاص بـ Clevera، وخادم MCP، وصفحة وكلاء AI وAPI، مجمعة حسب السبب: الرموز، والخطة، والأذونات، والعمل المدفوع، وحدود المعدل، والتعارضات، وتوصيل التطبيقات، مع طريقة الإصلاح.
تم التحديث وقت القراءة 9 دقائق
عندما يرفض Clevera طلب وكيل، يحصل الوكيل على رمز ورسالة توضح ما يجب القيام به. تسرد هذه المقالة كل رسالة قد يراها وكيل أو برنامج نصي أو شخص ما مع وكلاء AI وAPI، وما يسببها وكيفية إصلاحها. عبر REST API، يوجد الرمز في error.code؛ وعبر MCP، تعود نفس الرسالة كخطأ في الأداة.
الرمز غير مقبول
| الرسالة | الرمز | السبب | الإصلاح |
|---|---|---|---|
| "أرسل رمز وكيل Clevera (Authorization: Bearer clv_agent_…) أو اتصل عبر OAuth. أنشئ رمزاً في عمليات التكامل → وكلاء AI وAPI." | unauthenticated |
لم يتم إرسال أي رمز. | أرسل Authorization: Bearer <token>. تحقق من ضبط CLEVERA_TOKEN حيث يعمل الوكيل. |
| "هذا ليس رمز وكيل Clevera صالحاً. أنشئ واحداً في عمليات التكامل → وكلاء AI وAPI." | unauthenticated |
القيمة مكتوبة بشكل خاطئ، أو مقطوعة، أو ليست رمزاً لـ Clevera. | الصق الرمز بالكامل مرة أخرى. |
| "رمز غير معروف. ربما تم حذفه؛ أنشئ رمزاً جديداً في عمليات التكامل → وكلاء AI وAPI." | unauthenticated |
Clevera لا يتعرف على هذا الرمز. | أنشئ رمزاً جديداً. |
| "رموز موصل OAuth تعمل على خادم MCP فقط. استخدم رمزاً ثابتاً لـ REST API." | unauthenticated |
تم استخدام تسجيل دخول تطبيق متصل على REST API. | استخدم رمز API لـ REST. |
| "انتهت صلاحية هذا الرمز. أنشئ رمزاً جديداً في عمليات التكامل → وكلاء AI وAPI." | token_expired |
انتهت فترة صلاحيته. | أنشئ رمزاً جديداً. |
| "تم إلغاء هذا الرمز." | token_revoked |
قام شخص ما بإلغائه، أو تمت إعادة إنشائه، أو غادر مالكه، أو قام Clevera بإلغائه. | انظر لماذا توقف الرمز عن العمل. |
| "الحساب الذي يملك هذا الرمز معلق." | token_revoked |
حساب المالك معلق. | اتصل بالدعم. |
| "لا يمكن استخدام هذا الرمز من عنوان IP هذا." | ip_not_allowed |
جاء الطلب من خارج قائمة عناوين IP المسموح بها للرمز. | قم بتشغيل الوكيل من عنوان مسموح به، أو أنشئ رمزاً بالعنوان الجديد. |
الخطة لا تتضمن ذلك
وكلاء AI وAPI (الرموز، والتطبيقات المتصلة، وخطافات الويب) متاحة في خطط Pro وBusiness وCustom. في خطتي Free وStarter، تعرض الصفحة "وكلاء AI وAPI مشمولون في Pro" مع الترقية إلى Pro. تؤدي الترقية إلى جعل الرموز والتطبيقات وخطافات الويب الموجودة تعمل مرة أخرى؛ لا يتم حذف أي شيء.
| الرسالة | الرمز | السبب | الإصلاح |
|---|---|---|---|
| "API الوكيل غير موجود في خطة مساحة العمل هذه. إنه موجود في Pro وما فوق." | plan_locked (HTTP 403) |
مساحة العمل في خطة Free أو Starter، أو تم نقلها إليها. يتم رفض كل طلب رمز وتطبيق متصل. | الترقية إلى Pro. الرموز التي لم تنتهِ صلاحيتها تعمل مرة أخرى. |
| Claude أو ChatGPT يقول فقط إنه لم يتمكن من الاتصال، أو تفشل أدوات Clevera الخاصة به | plan_locked في الخلفية |
نفس رفض الخطة، يظهر بواسطة التطبيق كخطأ اتصال عام. | قم بترقية مساحة العمل إلى Pro، ثم أعد المحاولة في التطبيق. |
| "الوصول إلى API والوكيل غير موجود في خطتك." | — | إنشاء رمز، أو النقر على موافقة على طلب وكيل، خارج Pro. | الترقية إلى Pro. لا يزال رفض يعمل. |
| "الوصول إلى API والوكيل موجود في Pro وما فوق." / "موصلات Claude.ai وChatGPT موجودة في Pro وما فوق." / "خطافات الويب موجودة في Pro وما فوق." | — | عنصر تحكم مقفل في Free أو Starter. | الترقية إلى Pro. |
| مساحة العمل "(الخطة لا تتضمن تطبيقات متصلة)" / "خطة مساحة العمل هذه لا تتضمن تطبيقات متصلة." | — | توصيل Claude أو ChatGPT بمساحة عمل خارج Pro. | الترقية، أو اختر مساحة عمل أخرى على شاشة الاتصال. |
| إعادة إنشاء الرمز السري تفتح مربع حوار الترقية | — | لا يمكن إعادة إنشاء الأسرار خارج Pro. | الترقية إلى Pro، أو إلغاء الرمز. |
| "خطافات الويب غير موجودة في خطتك." | — | إرسال حدث تجريبي أو إعادة التسليم خارج Pro. لا يتم إرسال أي شيء؛ تنتهي عمليات إعادة المحاولة المنتظرة كفشل مع plan_locked. |
الترقية إلى Pro. |
| "خطتك لا تتضمن عمل وكيل مدفوع. قم بالترقية للسماح للوكلاء ببدئه." | plan_locked |
عمل مدفوع في خطة لا تتضمنه. | الترقية إلى Pro. |
الرمز غير مسموح له بـ
| الرسالة | الرمز | السبب | الإصلاح |
|---|---|---|---|
| "يفتقر هذا الرمز إلى القدرة ability. اطلب من عضو مساحة العمل الذي يملكه الحصول على رمز يحتوي عليها." | forbidden_ability |
الرمز لا يملك الإذن الذي يحتاجه هذا الطلب. | أنشئ رمزاً بهذا الإذن. انظر أذونات الوكيل. |
| "دور مالك الرمز الحالي في مساحة العمل هذه لا يسمح بـ ability." | forbidden_role |
تغير دور المالك منذ إنشاء الرمز. يظهر الرمز يتجاوز الدور. | يقوم شخص لديه الدور الصحيح بإنشاء الرمز. |
| "دورك لا يمكنه منح بعض هذه القدرات." / "دورك لا يمكنه منح: abilities." | — | إنشاء رمز بأذونات تتجاوز دورك. | قم بإلغاء تحديدها، أو اطلب من مالك أو مسؤول. |
| "لا يمكنك القيام بذلك في مساحة العمل هذه." | forbidden |
دور المالك أو وصوله لا يسمح بهذا الإجراء على هذا العنصر. | تحقق من دور المالك ووصول المجموعة. |
| "يمكن لمالك الرمز عرض هذه المقالة ولكن ليس تحريرها (وصول المجموعة)." | forbidden_item |
العنصر موجود في مجموعة يمكن للمالك عرضها فقط. | امنح المالك حق التحرير للمجموعة. |
| "لا يوجد item بهذا المعرف في نطاق هذا الرمز. قم بالإدراج أو البحث أولاً واستخدم معرفاً تم إرجاعه." | not_found |
معرف خاطئ، أو العنصر خارج مواقع الرمز أو وصول المالك. | قم بالإدراج أو البحث، ثم استخدم معرفاً تم إرجاعه. |
| "هذا المحتوى مباشر على موقع منشور، لذا فإن تغييره يحتاج إلى قدرة site:publish." | live_content_needs_publish |
تحرير (أو ترجمة) مقالة موقع مستندات مباشر بدون حقوق نشر. | امنح الرمز site:publish، أو دعه يرسل للمراجعة. |
| "تظهر هذه المقالة أيضاً على موقع لا يمكن لهذا الرمز تغييره. …" | shared_outside_scope |
تظهر المقالة على موقع خارج مواقع الرمز. | استخدم رمزاً يغطي كل موقع يعرضها، أو اترك ملاحظة مراجعة. |
| "هذا الموقع متوقف مؤقتاً أو غير متصل وهو للقراءة فقط. يمكن لمالك مساحة العمل إعادة تنشيطه في المستندات." | site_paused |
موقع المستندات متوقف مؤقتاً. | أعد تنشيط الموقع. |
العمل المدفوع مرفوض
| الرسالة | الرمز | السبب | الإصلاح |
|---|---|---|---|
| "سيؤدي هذا إلى تجاوز حد إنفاق الرمز. يمكن لمسؤول مساحة العمل رفعه." | cap_exceeded |
عرض السعر لا يتناسب مع حد لكل مهمة أو يومياً أو شهرياً للرمز. | انتظر لليوم أو الشهر التالي، أو أنشئ رمزاً بحدود أعلى. |
| رسالة حول نفاد الرصيد | insufficient_credits |
مساحة العمل لا تملك رصيداً كافياً. | اشترِ رصيداً أو انتظر المخصص. |
| "لا يمكن لمساحة عملك إنفاق رصيد الآن." | plan_locked |
تمنع الفوترة الإنفاق، على سبيل المثال استحقاق دفعة. | تحقق من الفوترة. |
| "انتهت صلاحية عرض السعر هذا. اطلب عرض سعر جديد." | quote_expired |
تستمر عروض الأسعار لمدة 15 دقيقة. | اطلب عرض سعر جديد. |
| "تم استخدام عرض السعر هذا بالفعل. اطلب عرض سعر جديد." | quote_used |
يبدأ عرض السعر مهمة واحدة. | اطلب عرض سعر جديد. |
| "عرض السعر هذا لنوع آخر من المهام." | quote_mismatch |
تم استخدام عرض سعر فيديو لبدء مقطع، على سبيل المثال. | استخدم طلب البدء المطابق. |
| "يتم التحقق من بدء آخر. حاول مرة أخرى بعد لحظة." | busy |
بدءان في نفس اللحظة. | أعد المحاولة بعد ثانية. |
تنتظر المهمة مع needs_input |
— | إنها تنتظر الموافقة على طلبات الوكيل. | يوافق مالك أو مسؤول أو يرفضها خلال 24 ساعة. |
تنتهي المهمة expired |
— | لم يقرر أحد خلال 24 ساعة. | ابدأ مرة أخرى ووافق عليها. |
| "لا يمكن إلغاء هذه المهمة بعد الآن." | not_cancelable |
انتهت المهمة بالفعل أو تجاوزت نقطة الإلغاء. | — |
رسائل الإدخال الشائعة عند طلب مقاطع الفيديو: "لا يزال هذا التسجيل قيد المعالجة. يرجى الانتظار حتى يصبح جاهزاً."، "اختر how_to، أو product_demo، أو cleanup، أو styled_video."، "اختر 1080p، أو 2k، أو 4k."، "الصادرات دائماً 60 إطاراً في الثانية."، "هذا العنصر مقالة؛ يمكن تصدير مقاطع الفيديو فقط."، "لا يمكن للوكلاء ترجمة المقاطع الاجتماعية بعد."، "هذه اللغة مترجمة بالفعل."، "لم يتم العثور على تلك المادة في مساحة العمل هذه. قم بتحميلها أولاً."
الكثير من الطلبات
| الرسالة | الرمز | الحد |
|---|---|---|
| "هذا الرمز تجاوز معدل طلبه. انتظر وأعد المحاولة." | rate_limited |
300 طلب في الدقيقة لكل رمز |
| "مساحة العمل هذه تجاوزت معدل طلب الوكيل الخاص بها. انتظر وأعد المحاولة." | rate_limited |
1,200 في الدقيقة لكل مساحة عمل |
| "الكثير من عمليات الكتابة من هذا الرمز. انتظر وأعد المحاولة." | rate_limited |
60 عملية كتابة في الدقيقة لكل رمز |
| "وصل هذا الرمز إلى حد الكتابة اليومي الخاص به. حاول مرة أخرى غداً." | rate_limited |
2,000 عملية كتابة في اليوم لكل رمز |
| "وصل هذا الرمز إلى حد النشر بالساعة الخاص به. حاول مرة أخرى لاحقاً." | rate_limited |
10 عمليات نشر في الساعة لكل رمز |
| "الكثير من عمليات التحميل من هذا الرمز. انتظر وأعد المحاولة." | rate_limited |
30 عملية تحميل في الدقيقة |
| "وصل هذا الرمز إلى حجم التحميل اليومي الخاص به. حاول مرة أخرى غداً." | rate_limited |
500 ميجابايت في اليوم لكل رمز |
| "تم إيقاف عمليات الكتابة من هذا الرمز مؤقتاً بعد تدفق غير عادي للتغييرات. تم إخطار مالك مساحة العمل." | rate_limited |
نشاط غير عادي: تتوقف عمليات الكتابة مؤقتاً لمدة 10 دقائق |
| "الكثير من الطلبات. انتظر وأعد المحاولة." | rate_limited |
60 في الدقيقة لكل عنوان IP بدون رمز صالح |
تقتصر عمليات البدء المدفوعة أيضًا على 20 عملية في الساعة لكل رمز، و100 عملية في اليوم لكل مساحة عمل. يحتوي كل 429 على ترويسة Retry-After؛ انتظر تلك المدة.
المحتوى وإعادة المحاولة
| الرسالة | الرمز | الحل |
|---|---|---|
| "تغير المحتوى منذ أن قرأته. أعد قراءته...، وادمج تغييرك وأعد المحاولة باستخدام ذلك المعرف." | revision_conflict |
يقرأ الوكيل الصفحة مرة أخرى ويطبق تغييره مجددًا. |
| "تم استخدام مفتاح التماثل هذا لطلب مختلف." | idempotency_conflict / idempotency_key_reused |
استخدم Idempotency-Key جديدًا لطلب جديد. |
| — | idempotency_in_progress |
الطلب الأول باستخدام هذا المفتاح لا يزال قيد التشغيل. انتظر، ثم أعد المحاولة باستخدام نفس المفتاح. |
الرموز والصفحة
| الحالة | السبب | الحل |
|---|---|---|
| رمز جديد معطل | "وصلت مساحة عملك إلى حدها الأقصى البالغ 50 رمزًا نشطًا. قم بإلغاء أحدها أولاً." | قم بإلغاء رمز لا تستخدمه. |
| لا يوجد خيار إعادة إنشاء الرمز السري | يمكن لمنشئ الرمز فقط إعادة إنشائه، ومرة واحدة فقط. "الشخص الذي أنشأ هذا الرمز هو الوحيد الذي يمكنه إعادة إنشائه. يمكنك إلغاؤه." | أعد إنشاء الرمز الأحدث، أو أنشئ رمزًا جديدًا. |
| "تمت إعادة إنشاء هذا الرمز أو إلغاؤه أو انتهت صلاحيته بالفعل؛ استخدم بديله أو أنشئ رمزًا جديدًا." | تمت إعادة إنشاء الرمز السري من قبل. | استخدم الرمز البديل. |
| لا ترى رمز زميلك | المالكون والمسؤولون فقط هم من يرون كل رمز. | اطلب ذلك من مالك أو مسؤول. |
| لا يمكنك الموافقة على طلب: "مالك أو مسؤول هو من يقرر" | المالكون والمسؤولون فقط هم من يوافقون على الإنفاق. | اطلب ذلك من مالك أو مسؤول. |
| "المالكون والمسؤولون فقط هم من يديرون خطافات الويب (webhooks)" | دورك لا يسمح لك بإدارة خطافات الويب. | اطلب ذلك من مالك أو مسؤول. |
توصيل Claude أو ChatGPT
| على الشاشة | الحل |
|---|---|
| "انتهت صلاحية هذا الطلب" | "مر وقت طويل منذ أن طلب التطبيق ذلك. ابدأ الاتصال مجددًا من التطبيق." |
| "هذا التطبيق غير مسجل" | أزل الموصل في التطبيق وأضفه مرة أخرى. |
| "لا يمكن الوثوق بهذا الطلب" | "لم تتم مشاركة أي شيء. ابدأ الاتصال مجددًا من التطبيق." لا تقم بالاتصال إذا استمر حدوث ذلك. |
| "اختر مساحة عمل أنت عضو فيها." | اختر واحدة من مساحات عملك. |
| "تم الإلغاء: تم اكتشاف إعادة استخدام الرمز" في تطبيق متصل | تم إعادة استخدام تسجيل دخول التطبيق، لذا قامت Clevera بإلغائه. قم بتوصيل التطبيق مرة أخرى. |
لا تزال تواجه مشكلة
اتصل بالدعم مع ذكر request_id من الخطأ، واسم الرمز (وليس الرمز نفسه أبدًا) ووقت الطلب.