Πώς λειτουργεί
Το nebo-link τρέχει δίπλα στους πράκτορές σας και ανοίγει δύο εξερχόμενες συνδέσεις προς το NeboAI: μία που αναφέρει ότι το bot είναι σε σύνδεση και ένα τούνελ που μεταφέρει τα αιτήματα από την εφαρμογή στους πράκτορες. Δεν ανοίγει θύρες και δεν χρειάζεται 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
Έτσι ο υπολογιστής συνδέεται με τον λογαριασμό σας ως ένα bot και το nebo-link εγκαθίσταται ως υπηρεσία παρασκηνίου: ως launchd agent στο macOS, ως μονάδα χρήστη systemd στο Linux και ως εργασία σύνδεσης στα Windows. Το --name ορίζει το όνομα του bot και το --label το όνομα του πρώτου πράκτορα.
Προσθήκη πρακτόρων
Κάθε άλλος πράκτορας στον υπολογιστή εντάσσεται στο ίδιο bot. Οι πράκτορες που μιλούν το Agent Client Protocol (ACP) μπορούν να προστεθούν με την εντολή που τους εκκινεί σε λειτουργία ACP. Το --dir είναι ο φάκελος στον οποίο δουλεύουν οι συνομιλίες του πράκτορα.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Ένας πράκτορας προγραμματισμού λειτουργεί με τη δική του σύνδεση. Τα αιτήματα αδειών του εμφανίζονται ως κάρτες στη συνομιλία και ως στοιχεία στα εισερχόμενα του κατόχου, και η λειτουργία αδειών του υπαλλήλου στο NeboAI ορίζει τη λειτουργία του ίδιου του πράκτορα για κάθε συνομιλία.
Εντολές
| Εντολή | Τι κάνει |
|---|---|
nebo-link <code> | Συνδέει αυτόν τον υπολογιστή ως bot, με τον πρώτο του πράκτορα. |
nebo-link status | Δείχνει τι είναι συνδεδεμένο, τους πράκτορες που φιλοξενεί και αν είναι σε σύνδεση. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Προσθέτει έναν πράκτορα στο bot. Το --acp-command προσθέτει οποιονδήποτε πράκτορα ACP. |
nebo-link remove <agent id> | Αφαιρεί έναν πράκτορα. |
nebo-link models on|off | Δρομολογεί τα μοντέλα ενός πράκτορα μέσω του NeboAI ή επαναφέρει τον δικό του πάροχο. |
nebo-link logs [--lines N] | Εμφανίζει το πρόσφατο αρχείο καταγραφής της υπηρεσίας. |
nebo-link unlink | Επαναφέρει κάθε ρύθμιση που άλλαξε, αφαιρεί την υπηρεσία και ξεχνά το bot. |
nebo-link update | Εγκαθιστά την πιο πρόσφατη υπογεγραμμένη έκδοση. Η υπηρεσία ενημερώνεται επίσης μόνη της καθημερινά. |
Κάθε αλλαγή που κάνει το Nebo Link στη διαμόρφωση ενός πράκτορα καταγράφεται μαζί με την τιμή που αντικατέστησε, ώστε τα models off και unlink να την επαναφέρουν ακριβώς. Τα αρχεία κάθε bot βρίσκονται στο ~/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· η επιτυχία στη σουίτα συμμόρφωσης είναι αυτό που κάνει έναν κεντρικό υπολογιστή ή πελάτη συμβατό.