تخطَّ إلى المحتوى
Documentation

استكشاف أخطاء وكيل الذكاء الاصطناعي وإصلاحها

ابدأ بالفحوصات المدمجة. داخل الوكيل:

/doctor
/status

من شل:

Terminal window
champrep version
champrep auth status
champrep ai paths

/doctor يتحقق من الإصدار المثبت، وتسجيل الدخول، والاتصال بـ CHAMPREP، وما إذا كانت خطتك تشمل الوكيل، وما إذا كان rg (ripgrep) و git متاحان، وصدفة الأوامر الخاصة بك، ولون وحجم المحطة الطرفية. /status يعرض ملف التعريف الخاص بك، والبيئة، والنموذج، ووضع الأذونات، ومواقع الملفات المحلية.

لا تقم بلصق APIالمفاتيح أو الرموز أو السجلات غير المحجوبة في طلب الدعم.

“غير متصل: قم بتشغيل /login” أو “لم يتم تسجيل الدخول”

Section titled ““غير متصل: قم بتشغيل /login” أو “لم يتم تسجيل الدخول””

لا يوجدCLI تسجيل دخول صالح للبيئة النشطة.

  • تفاعليًّا، قم بتشغيل /login أو champrep auth login.
  • في CI، تحقق من أن CHAMPREP_TOKEN تم تعيينه للمهمة.

تنتهي عمليات التشغيل بدون واجهة مستخدم برمز 3 في هذه الحالة.

الأدوات المحلية غير مسموح بها

Section titled “الأدوات المحلية غير مسموح بها”

تشير الرسالة إلى أن الأدوات المحلية تحتاج إلى ai:agent النطاق. يمكن لبيانات الاعتماد استخدام CHAMPREP AIولكن لا يمكنها استخدام الأدوات المحلية للوكيل.

  • قم بتسجيل الدخول مرة أخرى باستخدام champrep auth login.
  • بالنسبة لمفتاحAPI ، قم بإنشاء مفتاح يتضمن ai:agent بالاسم. لا يكفي وجود مفتاح يحتوي فقط على نطاقات أوسع. انظر تسجيل الدخول.

“الوكيلCHAMPREPCLI غير مضمن في خطتك”

Section titled ““الوكيلCHAMPREPCLI غير مضمن في خطتك””

لا تتضمن خطتك خدمةCHAMPREPCLI . أخرى champrep تستمر الأوامر في العمل. قم بالترقية باستخدام الرابط الموجود على البطاقة، أو راجع الخطط والحدود.

إذا كانت الرسالة تشير إلى أن إحدى الميزات معطلة، أو أن سياسة مؤسستك لا تسمح بها، فإن مسؤول المؤسسة هو من يتحكم في ذلك.

تقييد معدل الاستخدام أو نفاد الدورات

Section titled “تقييد معدل الاستخدام أو نفاد الدورات”
  • “أنت ترسل الطلبات بسرعة كبيرة جدًا”: حد أقصى لكل دقيقة. يقوم الوكيل بإعادة المحاولة تلقائيًا عندما تكون مدة الانتظار قصيرة. في البرامج النصية، انتظر المدة المحددة في التلميح قبل إعادة المحاولة.
  • “لقد استخدمت كل ما تتضمنه خطتك لهذه الفترة”: قم بشراء ملحق أو انتظر فترة الفوترة التالية. تستخدم الحلقات والوكلاء الفرعيون وعمليات CI جميعًا الدورات، لذا تحقق من /tasks للتحقق من أي شيء لا يزال قيد التشغيل.

لا يمكن للنموذج استخدام الأدوات

Section titled “لا يمكن للنموذج استخدام الأدوات”

إذا اخترت نموذجًا مميزًا بعلامة no tools، يمكن للوكيل الدردشة ولكنه لا يستطيع قراءة الملفات أو تشغيل الأوامر أو استخدام CHAMPREPالخدمات. قم بالعودة باستخدام /model auto أو اختر نموذجًا مميزًا بعلامة tools في /models. إذا تم رفض دور ما لأن النموذج يفتقر إلى إحدى القدرات، مثل إدخال الصورة، فاختر «تلقائي» أو نموذجًا آخر من الخيارات المعروضة. انظر النماذج.

يتم تجاهل أوامر المشروع أو قواعده أو خوادم MCP الخاصة به

Section titled “يتم تجاهل أوامر المشروع أو قواعده أو خوادم MCP الخاصة به”

المحتوى في .champrep/ تظل غير نشطة حتى تثق في المستودع. إن تحذيرًا مثل «يتم تجاهل قواعد السماح وdefaultMode حتى تثق في هذا المشروع» يعني أنه تم العثور على إعدادات المشروع ولكن لم يتم تطبيقها.

/trust
/trust approve

تُطبق قواعد الحظر دائمًا. انظر ثقة المستودع.

“لا يوجد مضيف بهذا الاسم” بعد الترقية من إصدار سابق

Section titled ““لا يوجد مضيف بهذا الاسم” بعد الترقية من إصدار سابق”

قد تقوم الإصدارات القديمة بكتابة عنوان بوابة لم يعد قيد الاستخدام في config.toml. تقوم الإصدارات الحالية باستبداله تلقائيًا عند تحميل التكوين. إذا استمر الخطأ:

Terminal window
champrep config env
champrep config path

تأكد من أن عنوان URLAPI الخاص بالبيئة النشطة هو وCHAMPREPAPI Gateway ليس عنوانًا مخصصًا أو قديمًا. للعودة إلى الإعداد الافتراضي المدمج، قم بإزالة قسم تلك البيئة من config.toml؛ حيث CLIيعيد الوكيل البيئة المدمجة عند تشغيله في المرة التالية، وعند تسجيل دخولك إليه مرة أخرى.

الملف «محظور بموجب سياسة سرية»

Section titled “الملف «محظور بموجب سياسة سرية»”

يتطابق الملف مع قائمة الأسرار المدمجة أو إحدى deny_read ، بحيث لا يستطيع الوكيل قراءتها. وهذا أمر مقصود. انسخ الأجزاء غير السرية إلى ملف آخر، أو استخدم ملفًا نموذجيًّا مثل .env.example. انظر حماية الأسرار.

local_grep يستخدم rg (ripgrep) عند تثبيته، وإلا فسيتم اللجوء إلى بحث مدمج أبطأ. قم بتثبيت ripgrep وأعد التشغيل /doctor.

لا يبدأ الوكيل التفاعلي في البرنامج النصي

Section titled “لا يبدأ الوكيل التفاعلي في البرنامج النصي”

يحتاج الوضع التفاعلي إلى محطة طرفية. في البرامج النصية وCI، استخدم champrep ai -p. انظر الاستخدام بدون واجهة مستخدم وCI.

أين توجد إعداداتي وسجلاتي؟

Section titled “أين توجد إعداداتي وسجلاتي؟”
Terminal window
champrep ai paths

يؤدي هذا إلى طباعة كل الملفات والمجلدات المحلية التي يستخدمها الوكيل، بما في ذلك الإعدادات، وسجلات التصحيح المحجوبة، ونقاط الفحص. قم بتشغيل الأمر معCLI --debug للحصول على سجلات أكثر تفصيلاً. بالنسبة CLIللمشاكل التي لا تخص الوكيل تحديدًا، راجع CLI استكشاف الأخطاء وإصلاحها.