איך זה עובד
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; מארח או לקוח נחשבים תואמים כשהם עוברים את חבילת בדיקות התאימות.