الانتقال إلى المحتوى الرئيسي

​
نظرة عامة

تم تصميم CLI الخاص بـ Nudgen بنهج يدعم الذكاء الاصطناعي أولاً. فبينما توفر واجهة TUI جميلة للبشر، فإن كل أمر مُحسَّن للتواصل بين الآلات.

​
النمط الوكيلي (Agentic Pattern)

عندما يستخدم وكيل ذكاء اصطناعي (مثل Claude أو GPT أو وكيل أتمتة متخصص) الـ CLI، يجب عليه اتباع الأنماط التالية:
  1. إخراج JSON: أضف --json لكل أمر للحصول على بيانات قابلة للمعالجة آلياً.
  2. إدراك السياق: تحقق دائماً من سياق الفريق قبل تنفيذ العمليات.
  3. غير تفاعلي: استخدم الأعلام (Flags) لتجاوز مطالبات واجهة المستخدم التفاعلية.

​
أتمتة JSON

يدعم كل أمر قائمة وحالة علم --json. يؤدي هذا إلى إرجاع هيكل JSON نظيف بدلاً من جدول منسق. 
# الحصول على جميع الحملات بتنسيق JSON
nudgen campaigns list --json

# الحصول على جهات الاتصال للفريق الحالي
nudgen contacts list --json

​
سير عمل الفرق المتعددة للوكلاء

بما أن Nudgen يدعم فرقاً متعددة، يجب على الوكيل التأكد من أنه يعمل ضمن الفريق الصحيح قبل إجراء أي عمليات. سير العمل الموصى به:
  1. التحقق من الفريق الحالي: 
    nudgen teams current --json
  2. تبديل الفريق (إذا لزم الأمر) : إذا كان المعرف (id) لا يطابق الفريق المستهدف: 
    nudgen teams switch <target-team-id>
  3. تنفيذ أمر البيانات: المتابعة بأوامر campaigns أو contacts أو brand.

​
أفضل الممارسات لمطوري الوكلاء

  • معالجة الأخطاء: راقب رمز الخروج (Exit Code). يشير رمز الخروج غير الصفري إلى حدوث خطأ (تحقق، شبكة، أو مصادقة).
  • تحديد معدل الطلبات (Rate Limiting): يتواصل الـ CLI مع خادم Nudgen. تأكد من أن برامج الوكلاء تعالج حدود المعدل بشكل لائق.
  • الوضع الصامت: إذا لم يوفر أمر معين علماً لتجاوز مطالبة تفاعلية، فتأكد من أن وكيلك يمكنه التعامل مع تدفقات stdout/stderr دون أن يعلق في حلقة تفاعلية.