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

تشغيل وكيل الذكاء الاصطناعي في وضع «headless» وفي بيئة التكامل المستمر (CI)

يعمل الوضع غير التفاعلي على تشغيل موجه واحد حتى اكتماله، ثم يطبع الإجابة، ويخرج. وهو لا يعرض موجهًا أبدًا، لذا يجب تحديد كل ما قد يقوم به مسبقًا.

Terminal window
champrep ai -p "list the Go files here and count them"

قراءة المطالبة من المدخلات القياسية باستخدام -p -:

Terminal window
git diff | champrep ai -p -

للقراءة فقط بشكل افتراضي

Section titled “للقراءة فقط بشكل افتراضي”

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

اسمح بالمزيد باستخدام أي من العلامتين:

العلامةالتأثير
--allowed-tools RULESالموافقة المسبقة على قواعد محددة لهذا التشغيل فقط. يتم رفض المكالمات التي لا تشملها أي قاعدة.
--permission-mode accept-editsالسماح بتعديل الملفات داخل مساحة العمل. لا تزال الأوامر تحتاج إلى قاعدة «السماح».
Terminal window
champrep ai -p "fix the failing test" \
--allowed-tools "local_edit_file(src/**),local_bash(go test*)"

تستخدم القواعد الصيغة الموضحة في قواعد السماح والرفض. افصل القواعد بفواصل أو مسافات، أو كرر العلامة. عند استخدام أي من العلامتين، تنطبق القواعد الموجودة في ملف إعدادات المستخدم الخاص بك أيضًا، كما تنطبق قواعد الحظر من ملفات إعدادات المشروع دائمًا. قواعد السماح من ملفات إعدادات المشروع، و defaultMode من أي ملف إعدادات، لا تُستخدم في عمليات التشغيل بدون واجهة مستخدم.

لا تتم الموافقة أبدًا على الإجراءات التي تغير البيانات في CHAMPREPخدماتك في الوضع غير التفاعلي. تظل هذه الإجراءات معلقة، ويقوم التشغيل بطباعة معرّف الإجراء حتى تتمكن من الموافقة عليه أو رفضه في التطبيق الويبCHAMPREP.

العلامةالتأثير
--output textالافتراضي. يتم إرسال النتيجة إلى المخرج القياسي؛ بينما يتم إرسال أنشطة الأداة إلى مخرج الخطأ القياسي.
--output jsonبث أحداث NDJSON إلى المخرج القياسي. --json له نفس التأثير عندما --output غير محدد.
--max-turns Nالتوقف بعد N دورات للنموذج. يؤدي الوصول إلى الحد إلى إنهاء التشغيل مع ظهور خطأ.
--model NAMEauto (افتراضي)، أو معرّف نموذج المنصة، أو اسم النموذج الذي قمت بتسجيله.
--add-dir PATHإضافة دليل آخر إلى مساحة العمل. قابل للتكرار.
--verboseاطبع أيضًا أسطر الحالة في الإخراج النصي.

مع --output json، كل حدث يمثل كائن JSON واحد في كل سطر. تشمل الأحداث نص الإجابة الذي يتم بثه، و استدعاءات الأدواتCHAMPREP ونتائجها، وأحداث الأدوات المحلية (local_tool_start, local_tool_result, local_resume)، والموافقات. يكون السطر الأخير دائمًا أحد الخيارات التالية:

{"type":"local_result","text":"There are 42 Go files.","conversation_id":"CONVERSATION_ID","suspensions":1,"model":"MODEL_ID","input_tokens":1234,"output_tokens":56}
{"type":"local_error","code":"ERROR_CODE","message":"Explanation of the failure"}

تحليل السطر الأخير للحصول على النتيجة، والتعامل مع أنواع الأحداث الأخرى التي لا تتعرف عليها على أنها معلوماتية.

ينتهي التشغيل الناجح بـ 0. تستخدم حالات الفشل المعيار CLI رموز الخروج، على سبيل المثال 3 عندما يكون تسجيل الدخول مفقودًا أو غير صالح و 5 عند بلوغ الحد الأقصى. تُظهر حالات الرفض تلميحًا في الخطأ القياسي، مثل خطة لا تشمل الوكيل أو حدًا لكل دقيقة مع عدد الثواني المطلوب الانتظار. الضغط على Ctrl+C يوقف التشغيل.

  1. إنشاء مفتاح يتضمن ai:agent النطاق، بالإضافة إلى نطاقات أي أخرى champrep الأوامر التي تُنفذها المهمة. ai:agent يجب تحديده حسب الاسم؛ فالنطاقات الأوسع وحدها لا تسمح باستخدام الأدوات المحلية.

    Terminal window
    champrep keys create --name "ci-review" --scope ai:agent
  2. تخزينه كسرّ CI مخفي ومحمي باسم CHAMPREP_TOKEN. CLI يستخدمها مباشرةً ولا يحتاج إلى سلسلة مفاتيح.

  3. قم بتشغيل الوكيل بالأذونات التي تحتاجها المهمة فقط.

ai-review:
script:
- champrep ai -p "review the changes in this merge request and list problems by severity" --output json --max-turns 20 > review.ndjson
- tail -n 1 review.ndjson

الأوامر التي ينفذها الوكيل لا تتلقى أبدًا CHAMPREP_TOKEN أو أي شيء آخر CHAMPREP_* متغير. لإبقاء حالة المهمة بعيدًا عن الدليل الرئيسي لبرنامج التشغيل الخاص بك ، قم بتعيين CHAMPREP_CONFIG_DIR إلى دليل مؤقت.

انظر API مفاتيح للأتمتةCLI بشأن التناوب والمراجعة، و الخطط والحدود حول كيفية احتساب عمليات تشغيل CI ضمن حدودك.