Cách hoạt động
nebo-link chạy cạnh các tác nhân của bạn và mở hai kết nối ra ngoài tới NeboAI: một kết nối báo rằng bot đang trực tuyến, và một đường hầm chuyển các yêu cầu từ ứng dụng tới các tác nhân. Nó không mở cổng nào và không cần VPN. Mỗi tác nhân giữ thông tin đăng nhập riêng trên máy tính; NeboAI không bao giờ thấy các thông tin đăng nhập đó.
Liên kết một máy tính
Lấy mã từ ứng dụng NeboAI, rồi chạy trình cài đặt trên máy tính nơi các tác nhân của bạn chạy. Trình cài đặt kiểm tra chữ ký của tệp tải xuống trước khi chạy và dừng lại nếu kiểm tra thất bại.
# 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
Thao tác này ghép nối máy tính với tài khoản của bạn thành một bot và cài nebo-link dưới dạng dịch vụ chạy nền: một launchd agent trên macOS, một systemd user unit trên Linux và một tác vụ khi đăng nhập trên Windows. --name đặt tên cho bot và --label đặt tên cho tác nhân đầu tiên.
Thêm tác nhân
Mọi tác nhân khác trên máy tính đều tham gia cùng một bot. Các tác nhân hỗ trợ Agent Client Protocol (ACP) có thể được thêm bằng lệnh khởi động chúng ở chế độ ACP. --dir là thư mục mà các cuộc trò chuyện của tác nhân làm việc trong đó.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Một tác nhân lập trình chạy bằng thông tin đăng nhập riêng của nó. Các yêu cầu cấp quyền của nó hiện thành thẻ trong cuộc trò chuyện và mục trong hộp thư đến của chủ sở hữu, còn chế độ quyền của nhân viên trong NeboAI sẽ đặt chế độ riêng của tác nhân cho từng cuộc trò chuyện.
Lệnh
| Lệnh | Chức năng |
|---|---|
nebo-link <code> | Liên kết máy tính này thành một bot, cùng với tác nhân đầu tiên của nó. |
nebo-link status | Hiển thị những gì đã được liên kết, các tác nhân mà nó lưu trữ và trạng thái trực tuyến. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Thêm một tác nhân vào bot. --acp-command thêm bất kỳ tác nhân ACP nào. |
nebo-link remove <agent id> | Gỡ một tác nhân. |
nebo-link models on|off | Định tuyến các mô hình của một tác nhân qua NeboAI, hoặc khôi phục nhà cung cấp riêng của nó. |
nebo-link logs [--lines N] | In nhật ký gần đây của dịch vụ. |
nebo-link unlink | Khôi phục mọi cài đặt đã thay đổi, gỡ dịch vụ và quên bot. |
nebo-link update | Cài bản phát hành mới nhất đã được ký. Dịch vụ cũng tự cập nhật hằng ngày. |
Mọi thay đổi mà Nebo Link thực hiện với cấu hình của một tác nhân đều được ghi lại cùng giá trị bị thay thế, nên models off và unlink khôi phục chính xác. Các tệp của mỗi bot nằm trong ~/Library/Application Support/nebo-link/<bot id> trên macOS, ~/.local/share/nebo-link/<bot id> trên Linux và %APPDATA%\nebo-link\<bot id> trên Windows, hoặc trong NEBO_LINK_HOME.
Open Agent Link
Open Agent Link (OAL) là một giao thức mở để kết nối tới các tác nhân trên bất kỳ máy tính nào: Agent Client Protocol, được làm cho có thể truy cập từ xa, cộng thêm một lớp máy chủ mỏng. Đặc tả được công bố tại openagent.link theo giấy phép CC-BY-4.0.
| Thành phần | Định nghĩa |
|---|---|
| Tác nhân | Giao tiếp bằng ACP qua đầu vào và đầu ra chuẩn. |
| Máy chủ | Mỗi máy tính và người dùng có một máy chủ; nó chạy và phục vụ các tác nhân. Nebo Link và Nebo đều là máy chủ. |
| Máy khách | Một ứng dụng giao tiếp với máy chủ. |
| Relay | Không bắt buộc. Chuyển tiếp lưu lượng giữa các máy khách và máy chủ không thể kết nối trực tiếp với nhau. |
| Truyền tải | WebSocket (wss qua internet) với subprotocol oal, mỗi tin nhắn là một khung JSON. Tin nhắn của máy chủ là các phương thức JSON-RPC host/*; lưu lượng của tác nhân là ACP được bọc dưới dạng {"agent": "<id>", "acp": <message>}. |
| Ghép nối | Mã dùng một lần gồm tám ký tự, hiển thị dạng XXXX-XXXX. Relay định tuyến theo nửa đầu và không bao giờ thấy nửa sau. |
Nebo Link phục vụ mọi tác nhân mà nó lưu trữ qua OAL cũng như cho NeboAI, và mã hóa đầu cuối mọi kết nối, nên relay chỉ chuyển tiếp lưu lượng mà nó không đọc được.
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 máy khách có sẵn cho TypeScript (@openagentlink/client) và Python (openagentlink). Một relay có thể tự lưu trữ và một bộ kiểm thử tương thích là một phần của dự án Open Agent Link; vượt qua bộ kiểm thử tương thích là điều khiến một máy chủ hoặc máy khách được coi là tương thích.