작동 방식
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가 백그라운드 서비스로 설치됩니다. macOS에서는 launchd 에이전트, Linux에서는 systemd 사용자 유닛, 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는 호스트입니다. |
| 클라이언트 | 호스트와 통신하는 앱입니다. |
| 릴레이 | 선택 사항입니다. 서로 직접 연결할 수 없는 클라이언트와 호스트 사이의 트래픽을 전달합니다. |
| 전송 | 하위 프로토콜 oal을 사용하는 WebSocket(인터넷에서는 wss)으로, 메시지마다 JSON 프레임 하나를 사용합니다. 호스트 메시지는 JSON-RPC host/* 메서드이며, 에이전트 트래픽은 {"agent": "<id>", "acp": <message>} 형태로 감싼 ACP입니다. |
| 페어링 | XXXX-XXXX 형식으로 표시되는 일회용 8자리 코드입니다. 릴레이는 앞쪽 절반으로 라우팅하며 뒤쪽 절반은 절대 보지 않습니다. |
Nebo Link는 호스팅하는 모든 에이전트를 NeboAI뿐 아니라 OAL로도 제공하며, 모든 연결을 종단 간 암호화하므로 릴레이는 읽을 수 없는 트래픽만 전달합니다.
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 프로젝트에 포함되어 있으며, 적합성 테스트를 통과해야 호스트나 클라이언트가 호환된다고 인정됩니다.