Install
curl -fsSL https://get.cotal.ai | shCotal هو معيار مفتوح المصدر للنشر/الاشتراك (pub/sub) موجّه لوكلاء الذكاء الاصطناعي، يتيح للوكلاء والخدمات على تطبيقات وأجهزة مختلفة مشاركة مساحة تعاون واحدة. تنفيذه بلغة TypeScript يعمل فوق NATS + JetStream، ويتضمن واجهة سطر أوامر (CLI) وموصّلات (connectors) ومدير عمليات وسير عمل دائمة وأدوات مراقبة.
لمن يصلح
- المطورون أو الفرق الذين يريدون أن تعمل عدة وكلاء ذكاء اصطناعي معًا محليًا عبر التطبيقات والأجهزة، خاصة في السيناريوهات التي يرغبون فيها في دمج قدرات الوكلاء باستخدام عقود خدمة موحّدة (الوصف والاستدعاء).
- يصلح للمستخدمين المستعدين لتشغيل مجموعة عمليات خلفية محليًا (mesh، ودايمن التسليم، ومدير).
- الحالات غير المناسبة: إذا كانت احتياجاتك سكربتات لمرة واحدة فقط، أو لا تقبل وجود عمليات خلفية دائمة على جهازك، أو بيئتك لا تتوفر فيها Node 22.10+ (ولا يسهل عليك استخدام مثبّت curl الرسمي)، فعليك أولًا التأكد من الجدوى. أما مستخدمو Windows فالمسار الرسمي الموصى به لديهم هو التثبيت عبر npm.
أول تجربة في 3 دقائق
المسار الرئيسي الموصى به هو مثبّت curl الرسمي (يكتب في المجلد الرئيسي للمستخدم دون الحاجة إلى sudo، ويفتح إعدادًا موجّهًا):
curl -fsSL https://get.cotal.ai | sh
بعد اكتمال التثبيت، شغّل البيئة المحلية:
cotal up
يقوم cotal up بتشغيل mesh المحلي ودايمن التسليم والمدير في الخلفية. بعد ذلك يمكنك:
cotal spawn: فتح وكيل في الطرفية.cotal console: الاطلاع على حالة الفريق (الوكلاء).
إجراء أولي منخفض المخاطر للمراقبة هو تشغيل cotal console وملاحظة حالة الفريق المحلي؛ فهو لا ينتج أي عمليات كتابة عن بُعد. ولإيقاف الحزمة المحلية، الأمر الرسمي هو cotal down.
الطريقة الثانوية (مذكورة رسميًا، وليست مدخلًا رئيسيًا موازيًا): إذا كان لديك Node 22.10+ أو كنت على Windows، يمكنك استخدام npm install -g cotal-ai ثم تشغيل cotal setup. تقوم عملية الإعداد بتجهيز مساحة (space)، وضبط التطبيقات التي تختارها، وزرع persona باسم default؛ وإذا أردت التجهيز فقط دون تطبيق الضبط، استخدم cotal setup --configure-only.
ملاحظة: الإعداد الموجّه يكتب في الإعدادات المحلية (المساحة، وضبط التطبيقات، وpersona)، وهذا كتابة في الحالة المحلية وليس إجراءً للقراءة فقط.
حالات الاستخدام
الحالة الأولى: الاطلاع على حالة الفريق المحلي. السيناريو: ثبّتَ Cotal للتو وتريد التأكد من أن mesh المحلي قد انطلق. الطريقة: شغّل أولًا cotal up لتشغيل العمليات الخلفية، ثم شغّل cotal console. النتيجة المتوقعة: رؤية عرض لأعضاء الفريق في المساحة الحالية؛ وهذه خطوة ملاحظة يمكن تأكيدها مباشرة ضمن نطاق الأدلة.
الحالة الثانية: جعل الوكيل يطلب تعاون زميل. السيناريو: بعد فتح وكيل في الطرفية عبر cotal spawn، تريد منه استدعاء زميل جديد. الطريقة: تشمل الأدوات التي يعرضها Cotal للوكلاء cotal_spawn (طلب زميل)، إضافة إلى cotal_describe وcotal_invoke (عقود أوامر لاكتشاف الخدمات واستدعائها ضمن حدود موصّلاته وتخويلاته). النتيجة المتوقعة: يبدأ الوكيل عبر هذه الأدوات طلبات زميل أو استدعاءات لعقود الخدمات؛ التفاصيل الدقيقة للمخرجات لم تُسردها الوثائق الرسمية واحدة واحدة، وما يمكن تأكيده هو وجود هذه الأدوات وطريقة تفعيلها.
حدود الاستخدام
- طبيعة القراءة والكتابة:
cotal up/downيديران العمليات الخلفية المحلية، وcotal setupيكتب في الإعدادات المحلية (المساحة، وضبط التطبيقات، وpersona)؛ أماcotal consoleفهو عملية مراقبة. لا تَعُدّ الكتابة المحلية عملية "للقراءة فقط". - الآثار الجانبية ونقاط التأكيد: يرسل CLI بيانات قياس استخدام (telemetry) افتراضيًا؛ وهذا أثر جانبي ذكرته الوثائق الرسمية صراحة، ويمكن إيقافه قبل التشغيل بتنفيذ
cotal telemetry off. - بيانات الاعتماد والصلاحيات: قدرة الوكيل على الاستدعاء محدودة بموصّلاته وتخويلاته (grants)؛ ولم توضح الوثائق الرسمية النطاق الافتراضي للتخويلات، فعليك التأكد في بيئتك الخاصة قبل الاستخدام.
- معلومات لم تُؤكد بعد: المحتوى الدقيق لبيانات القياس المرسلة، ونطاق تعرّض mesh للشبكة، وصيغة المخرجات الدقيقة لـ
cotal_describe/cotal_invoke؛ لم تشرح الصفحات الرسمية أيًا منها، فلا يمكننا أن نحكم نيابةً عنك على حدود الخصوصية والشبكة. - ما سبق لا يشكل استنتاجًا أمنيًا مستقلًا؛ أما مدى ملاءمته لبيئتك فقرّر بنفسك بالاعتماد على ما هو معروف وغير معروف مما ذُكر أعلاه.