تكامل ACP
وصّل أي محرر متوافق مع ACP بـ Bob Shell بوصفه مساعد ذكاء اصطناعي من الدرجة الأولى.
يمكن تشغيل Bob Shell كخادم Agent Client Protocol (ACP). عند الاتصال، يتولى المحرر إدارة واجهة المحادثات، ونوافذ الأذونات، وعرض الفروقات، بينما يتولى Bob إدارة بيئة التشغيل: الوصول إلى النموذج، والأدوات، وخوادم MCP، وتنفيذ الأوامر في الـ shell.
يؤدي ACP للوكلاء البرمجيين الدور ذاته الذي يؤديه Language Server Protocol لأدوات اللغة: عقد JSON-RPC واحد، وعدة محررات، وعدة وكلاء. تتواصل الوكلاء المحلية مع المحرر عبر stdin وstdout.
المحررات المدعومة
تدعم المحررات التالية اتصالات ACP بـ Bob Shell:
- Zed
- IntelliJ IDEA
- Neovim
البدء
شغّل Bob Shell كخادم ACP:
bob acpتنتظر العملية JSON-RPC على stdin. شغّلها عبر إعداد ACP في محررك؛ تشغيلها مباشرةً في المحطة الطرفية يبدو وكأنها معلّقة.
اتبع تعليمات إعداد ACP في محررك للاتصال بعملية bob acp. لمزيد من المعلومات حول البروتوكول، راجع مواصفة ACP.
المصادقة
يُجري Bob المصادقة أثناء تهيئة ACP. إذا كان BOBSHELL_API_KEY مضبوطًا في البيئة التي تشغّل bob acp، فسيستخدم Bob المفتاح ولن تحتاج إلى أي إجراء إضافي.
بدون مفتاح API أو رمز مخزّن، يطلب منك محررك المصادقة عبر SSO. أتمم تدفق المتصفح مرة واحدة؛ يخزّن Bob الرمز لتعيد جلسات ACP اللاحقة على الجهاز ذاته استخدامه.
ثقة مساحة العمل
يتحقق Bob من ثقة مساحة العمل قبل إنشاء الجلسة. يؤدي وجود مساحة عمل غير موثوقة إلى فشل إنشاء الجلسة. لإضافة مساحة عمل إلى قائمة الثقة، افتح محطة طرفية في ذلك الدليل وشغّل Bob Shell بصورة تفاعلية:
cd /path/to/project
bobبعد تسجيل الثقة، أغلق الجلسة وأعد الاتصال عبر المحرر.
في البيئات المؤقتة أو التي تُستخدم مرة واحدة، مرّر --trust في وسيطات ACP. للاطلاع على المقايضات، راجع خيارات الأوامر.
خوادم MCP
يمكن لكل من المحرر وBob توفير خوادم MCP لجلسة ما. تُهيَّأ مجموعتا الخوادم داخل حزمة جلسة Bob ذاتها، مما يجعل التكوينات المكررة سهلة الإغفال.
فضّل مالكًا واحدًا لكل خادم MCP. إذا كانت أداة MCP مفقودة بصورة غير متوقعة، تحقق من إعدادات MCP في محررك ومن تكوين MCP الأصلي في Bob.
تُنشئ كل جلسة ACP حزمتها الخاصة مع خوادم MCP المُكوَّنة. قد يبدأ خادم MCP محلي مرة واحدة لكل thread نشط في Bob. راقب استخدام الموارد قبل فتح خيوط متوازية كثيرة، خاصةً عندما يشغّل خادم ما JVM أو حاوية أو نموذجًا محليًا.
Bob Shell مقارنةً بمحطة المحرر الطرفية
ينفّذ Bob Shell الأوامر في عمليته الفرعية الخاصة، لا في محطة محررك الطرفية. قد يفشل أمر يعمل في محطة محررك الطرفية مع Bob Shell إذا ورث مسار bob acp مسار PATH أو دليل عمل أو بيئة مختلفة.
التغييرات التي تُجريها في محطة محرر جارية، كـ cd أو export، لا تصل إلى Bob Shell. إذا حدّثت بيئة التشغيل، فأعد تشغيل thread الـ ACP.
خيارات الأوامر
ابدأ بـ bob acp وأضف خيارات فقط لسبب محدد:
| الخيار | الوصف |
|---|---|
--log-level <level> | يضبط مستوى تفصيل السجل: debug أو info أو warn أو error أو silent. قابل للضبط أيضًا عبر متغير البيئة BOB_LOG_LEVEL. |
--trust | يثق بكل مساحة عمل يفتحها خادم ACP هذا. يزيل هذا الخيار حدًا على مستوى المشروع؛ لا تضمّنه في تكوين محرر دائم. |
--auto-approve | يوافق على كل استدعاء أداة دون عرض نوافذ الأذونات. هذا الخيار أشمل من اختيار السماح دائمًا لأداة واحدة. |
--disable-mcp | يتخطى تهيئة خوادم MCP. استخدم هذا الخيار لعزل أعطال بدء الجلسة. |
--disable-subagents | يُغفل تسجيل أدوات الوكلاء الفرعيين في Bob عندما لا تتطلب المهمة التفويض. |
--accept-license | يسجّل قبول الترخيص قبل بدء تشغيل الخادم. راجع أولًا ملفات الترخيص بتشغيل bob --show-license acp. |
استخدام --trust و--auto-approve معًا يزيل كلًا من بوابة مساحة العمل والموافقة على كل أداة. يمكن لموجّه الأوامر التصرف في أي مساحة عمل يفتحها الخادم دون تأكيد إضافي. لا تضمّن الخيارين في تكوين محررك الافتراضي.