كيف يعمل
يعمل nebo-link بجوار وكلائك ويُنشئ اتصالين صادرين إلى NeboAI: واحد يُبلغ بأن البوت متصل، ونفق يحمل الطلبات من التطبيق إلى الوكلاء. لا يفتح أي منافذ ولا يحتاج إلى VPN. يحتفظ كل وكيل بتسجيل دخوله الخاص على الحاسوب، ولا ترى NeboAI بيانات الاعتماد تلك أبدًا.
ربط حاسوب
احصل على رمز من تطبيق NeboAI، ثم شغّل أداة التثبيت على الحاسوب الذي يعمل عليه وكلاؤك. تتحقق أداة التثبيت من توقيع الملف المُنزَّل قبل تشغيله وتتوقف إذا فشل التحقق.
# macOS and Linux curl -fsSL https://neboai.com/link.sh | sh -s -- ABCD-1234 # Windows (PowerShell) & ([scriptblock]::Create((irm https://neboai.com/link.ps1))) ABCD-1234
يقرن هذا الحاسوب بحسابك كبوت واحد ويثبّت nebo-link كخدمة تعمل في الخلفية: وكيل launchd على macOS، ووحدة مستخدم systemd على Linux، ومهمة عند تسجيل الدخول على Windows. يحدّد --name اسم البوت و--label اسم الوكيل الأول.
إضافة وكلاء
ينضم كل وكيل آخر على الحاسوب إلى البوت نفسه. والوكلاء الذين يتحدثون بروتوكول Agent Client Protocol (ACP) يمكن إضافتهم بالأمر الذي يشغّلهم في وضع ACP. --dir هو المجلد الذي تعمل فيه محادثات الوكيل.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
يعمل وكيل البرمجة بتسجيل دخوله الخاص. تصل طلبات الإذن الخاصة به كبطاقات في المحادثة وبنود في البريد الوارد للمالك، ويحدّد وضع أذونات الموظف في NeboAI وضع الوكيل نفسه لكل محادثة.
الأوامر
| الأمر | ما يفعله |
|---|---|
nebo-link <code> | يربط هذا الحاسوب كبوت، مع وكيله الأول. |
nebo-link status | يعرض ما هو مرتبط، والوكلاء الذين يستضيفهم، وما إذا كان متصلًا. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | يضيف وكيلًا إلى البوت. يضيف --acp-command أي وكيل ACP. |
nebo-link remove <agent id> | يزيل وكيلًا. |
nebo-link models on|off | يوجّه نماذج الوكيل عبر NeboAI، أو يستعيد مزوّده الخاص. |
nebo-link logs [--lines N] | يطبع السجل الأخير للخدمة. |
nebo-link unlink | يستعيد كل إعداد تغيّر، ويزيل الخدمة، وينسى البوت. |
nebo-link update | يثبّت أحدث إصدار موقَّع. وتحدّث الخدمة نفسها يوميًا أيضًا. |
يُسجَّل كل تغيير يُجريه Nebo Link على تهيئة وكيل مع القيمة التي استبدلها، لذا يستعيدها models off وunlink بالضبط. توجد ملفات كل بوت في ~/Library/Application Support/nebo-link/<bot id> على macOS، و~/.local/share/nebo-link/<bot id> على Linux، و%APPDATA%\nebo-link\<bot id> على Windows، أو تحت NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) بروتوكول مفتوح للوصول إلى الوكلاء على أي حاسوب: بروتوكول Agent Client Protocol وقد أصبح قابلًا للوصول، مع طبقة استضافة رفيعة. المواصفات منشورة على openagent.link بموجب رخصة CC-BY-4.0.
| الجزء | التعريف |
|---|---|
| الوكيل | يتحدث ACP عبر الإدخال والإخراج القياسيين. |
| المضيف | واحد لكل حاسوب ومستخدم، يشغّل الوكلاء ويقدّمهم. Nebo Link وNebo مضيفان. |
| العميل | تطبيق يتحدث إلى مضيف. |
| المُرحِّل | اختياري. يمرّر الحركة بين العملاء والمضيفين الذين لا يستطيعون الوصول بعضهم إلى بعض. |
| النقل | WebSocket (wss عبر الإنترنت) مع البروتوكول الفرعي oal، وإطار JSON واحد لكل رسالة. رسائل المضيف هي أساليب JSON-RPC host/*، وحركة الوكيل هي ACP مغلّفة بالشكل {"agent": "<id>", "acp": <message>}. |
| الإقران | رمز من ثمانية أحرف يُستخدم مرة واحدة ويُعرض بالصيغة XXXX-XXXX. يوجّه المُرحِّل بناءً على النصف الأول ولا يرى النصف الثاني أبدًا. |
يقدّم Nebo Link كل وكيل يستضيفه عبر OAL وإلى NeboAI أيضًا، ويشفّر كل اتصال من طرف إلى طرف، فيمرّر المُرحِّل حركة لا يستطيع قراءتها.
nebo-link relay https://relay.example.com # reach agents through your own relay nebo-link lan on # or directly on this network nebo-link pair # show a one-time code for a device nebo-link unpair "Office tablet" # remove a device
تتوفر حزم SDK للعملاء بلغة TypeScript (@openagentlink/client) وPython (openagentlink). والمُرحِّل القابل للاستضافة الذاتية ومجموعة اختبارات المطابقة جزء من مشروع Open Agent Link، واجتياز مجموعة اختبارات المطابقة هو ما يجعل المضيف أو العميل متوافقًا.