تشغيل وكيل الذكاء الاصطناعي في وضع «headless» وفي بيئة التكامل المستمر (CI)
يعمل الوضع غير التفاعلي على تشغيل موجه واحد حتى اكتماله، ثم يطبع الإجابة، ويخرج. وهو لا يعرض موجهًا أبدًا، لذا يجب تحديد كل ما قد يقوم به مسبقًا.
champrep ai -p "list the Go files here and count them"قراءة المطالبة من المدخلات القياسية باستخدام -p -:
git diff | champrep ai -p -
للقراءة فقط بشكل افتراضي
Section titled “للقراءة فقط بشكل افتراضي”بدون علامات إضافية، تكون عملية التشغيل بدون واجهة مستخدم للقراءة فقط: يمكن للوكيل قراءة مساحة العمل والبحث فيها ولكن لا يمكنه تحرير الملفات أو تشغيل الأوامر. يتم رفض أي شيء يتطلب مطالبة بالحصول على إذن، ويتم إعلام النموذج بالسبب.
اسمح بالمزيد باستخدام أي من العلامتين:
| العلامة | التأثير |
|---|---|
--allowed-tools RULES | الموافقة المسبقة على قواعد محددة لهذا التشغيل فقط. يتم رفض المكالمات التي لا تشملها أي قاعدة. |
--permission-mode accept-edits | السماح بتعديل الملفات داخل مساحة العمل. لا تزال الأوامر تحتاج إلى قاعدة «السماح». |
champrep ai -p "fix the failing test" \ --allowed-tools "local_edit_file(src/**),local_bash(go test*)"تستخدم القواعد الصيغة الموضحة في
قواعد السماح والرفض. افصل القواعد بفواصل أو مسافات، أو كرر العلامة. عند استخدام أي من العلامتين، تنطبق القواعد الموجودة في ملف إعدادات المستخدم الخاص بك أيضًا، كما تنطبق قواعد الحظر من ملفات إعدادات المشروع دائمًا. قواعد السماح من ملفات إعدادات المشروع، و defaultMode من أي ملف إعدادات، لا تُستخدم في عمليات التشغيل بدون واجهة مستخدم.
لا تتم الموافقة أبدًا على الإجراءات التي تغير البيانات في CHAMPREPخدماتك في الوضع غير التفاعلي. تظل هذه الإجراءات معلقة، ويقوم التشغيل بطباعة معرّف الإجراء حتى تتمكن من الموافقة عليه أو رفضه في التطبيق الويبCHAMPREP.
خيارات أخرى
Section titled “خيارات أخرى”| العلامة | التأثير |
|---|---|
--output text | الافتراضي. يتم إرسال النتيجة إلى المخرج القياسي؛ بينما يتم إرسال أنشطة الأداة إلى مخرج الخطأ القياسي. |
--output json | بث أحداث NDJSON إلى المخرج القياسي. --json له نفس التأثير عندما --output غير محدد. |
--max-turns N | التوقف بعد N دورات للنموذج. يؤدي الوصول إلى الحد إلى إنهاء التشغيل مع ظهور خطأ. |
--model NAME | auto (افتراضي)، أو معرّف نموذج المنصة، أو اسم النموذج الذي قمت بتسجيله. |
--add-dir PATH | إضافة دليل آخر إلى مساحة العمل. قابل للتكرار. |
--verbose | اطبع أيضًا أسطر الحالة في الإخراج النصي. |
إخراج JSON
Section titled “إخراج JSON”مع --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"}تحليل السطر الأخير للحصول على النتيجة، والتعامل مع أنواع الأحداث الأخرى التي لا تتعرف عليها على أنها معلوماتية.
رموز الخروج
Section titled “رموز الخروج”ينتهي التشغيل الناجح بـ 0. تستخدم حالات الفشل المعيار
CLI رموز الخروج، على سبيل المثال 3 عندما يكون تسجيل الدخول مفقودًا أو غير صالح و 5 عند بلوغ الحد الأقصى. تُظهر حالات الرفض تلميحًا في الخطأ القياسي، مثل خطة لا تشمل الوكيل أو حدًا لكل دقيقة مع عدد الثواني المطلوب الانتظار. الضغط على Ctrl+C يوقف التشغيل.
استخدام مفتاحAPI في CI
Section titled “استخدام مفتاحAPI في CI”-
إنشاء مفتاح يتضمن
ai:agentالنطاق، بالإضافة إلى نطاقات أي أخرىchamprepالأوامر التي تُنفذها المهمة.ai:agentيجب تحديده حسب الاسم؛ فالنطاقات الأوسع وحدها لا تسمح باستخدام الأدوات المحلية.Terminal window champrep keys create --name "ci-review" --scope ai:agent -
تخزينه كسرّ CI مخفي ومحمي باسم
CHAMPREP_TOKEN. CLI يستخدمها مباشرةً ولا يحتاج إلى سلسلة مفاتيح. -
قم بتشغيل الوكيل بالأذونات التي تحتاجها المهمة فقط.
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 ضمن حدودك.