Nasıl çalışır
nebo-link ajanlarınızın yanında çalışır ve NeboAI’ye iki giden bağlantı kurar: biri botun çevrimiçi olduğunu bildirir, diğeri ise istekleri uygulamadan ajanlara taşıyan bir tüneldir. Hiçbir port açmaz ve VPN gerektirmez. Her ajan bilgisayardaki kendi oturumunu korur; NeboAI bu kimlik bilgilerini asla görmez.
Bir bilgisayar bağlayın
NeboAI uygulamasından bir kod alın, ardından yükleyiciyi ajanlarınızın çalıştığı bilgisayarda çalıştırın. Yükleyici, indirilen dosyayı çalıştırmadan önce imzasını denetler ve denetim başarısız olursa durur.
# 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
Bu komut bilgisayarı hesabınızla tek bir bot olarak eşleştirir ve nebo-link’i arka plan hizmeti olarak kurar: macOS’ta bir launchd ajanı, Linux’ta bir systemd kullanıcı birimi, Windows’ta ise bir oturum açma görevi. --name botun adını, --label ise ilk ajanın adını belirler.
Ajan ekleyin
Bilgisayardaki diğer her ajan aynı bota katılır. Agent Client Protocol (ACP) konuşan ajanlar, onları ACP modunda başlatan komutla eklenebilir. --dir, ajanın konuşmalarının çalıştığı klasördür.
nebo-link add --acp-command "example-agent acp" --dir ~/code/site --label "Site agent"
Bir kodlama ajanı kendi oturumuyla çalışır. İzin istekleri sohbette kartlar ve sahibin gelen kutusunda öğeler olarak gelir; çalışanın NeboAI’deki izin modu da her konuşma için ajanın kendi modunu belirler.
Komutlar
| Komut | Ne yapar |
|---|---|
nebo-link <code> | Bu bilgisayarı ilk ajanıyla birlikte bir bot olarak bağlar. |
nebo-link status | Neyin bağlı olduğunu, barındırdığı ajanları ve çevrimiçi olup olmadığını gösterir. |
nebo-link add <agent> [--dir <folder>] [--label <name>] | Bota bir ajan ekler. --acp-command herhangi bir ACP ajanını ekler. |
nebo-link remove <agent id> | Bir ajanı kaldırır. |
nebo-link models on|off | Bir ajanın modellerini NeboAI üzerinden yönlendirir veya ajanın kendi sağlayıcısını geri yükler. |
nebo-link logs [--lines N] | Hizmetin son günlük kayıtlarını yazdırır. |
nebo-link unlink | Değiştirilen her ayarı geri yükler, hizmeti kaldırır ve botu unutur. |
nebo-link update | İmzalı en son sürümü kurar. Hizmet kendini her gün ayrıca günceller. |
Nebo Link’in bir ajanın yapılandırmasında yaptığı her değişiklik, yerine geçtiği değerle birlikte kaydedilir; böylece models off ve unlink onu birebir geri yükler. Her botun dosyaları macOS’ta ~/Library/Application Support/nebo-link/<bot id>, Linux’ta ~/.local/share/nebo-link/<bot id>, Windows’ta %APPDATA%\nebo-link\<bot id> içinde veya NEBO_LINK_HOME altında bulunur.
Open Agent Link
Open Agent Link (OAL), herhangi bir bilgisayardaki ajanlara ulaşmak için açık bir protokoldür: erişilebilir hâle getirilmiş Agent Client Protocol ile ince bir ana bilgisayar katmanı. Belirtim, CC-BY-4.0 lisansıyla openagent.link adresinde yayımlanmıştır.
| Bölüm | Tanım |
|---|---|
| Ajan | Standart giriş ve çıkış üzerinden ACP konuşur. |
| Ana bilgisayar | Bilgisayar ve kullanıcı başına bir tane; ajanları çalıştırır ve onlara hizmet verir. Nebo Link ve Nebo birer ana bilgisayardır. |
| İstemci | Bir ana bilgisayarla konuşan uygulama. |
| Aktarıcı | İsteğe bağlı. Birbirine ulaşamayan istemciler ile ana bilgisayarlar arasında trafiği iletir. |
| Taşıma | oal alt protokollü WebSocket (internet üzerinden wss), her ileti için bir JSON çerçevesi. Ana bilgisayar iletileri JSON-RPC host/* yöntemleridir; ajan trafiği {"agent": "<id>", "acp": <message>} olarak sarılmış ACP’dir. |
| Eşleştirme | XXXX-XXXX biçiminde gösterilen, tek kullanımlık sekiz karakterli bir kod. Aktarıcı, yönlendirmeyi ilk yarıya göre yapar ve ikinci yarıyı asla görmez. |
Nebo Link, barındırdığı her ajanı hem NeboAI’ye hem de OAL üzerinden sunar ve her bağlantıyı uçtan uca şifreler; böylece bir aktarıcı, okuyamadığı trafiği iletir.
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
İstemci SDK’ları TypeScript (@openagentlink/client) ve Python (openagentlink) için mevcuttur. Kendi sunucunuzda barındırabileceğiniz bir aktarıcı ve bir uyumluluk test paketi Open Agent Link projesinin parçasıdır; bir ana bilgisayarı veya istemciyi uyumlu kılan, uyumluluk test paketini geçmesidir.