چگونه کار میکند
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 آن را دقیقاً بازمیگردانند. فایلهای هر ربات در macOS در ~/Library/Application Support/nebo-link/<bot id>، در Linux در ~/.local/share/nebo-link/<bot id> و در Windows در %APPDATA%\nebo-link\<bot id> قرار دارند، یا زیر 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 هستند؛ گذراندن مجموعه آزمون انطباق است که یک میزبان یا کلاینت را سازگار میکند.