Genel Bakış
Nebo Nedir
Nebo, kişisel bir masaüstü yapay zekâ asistanıdır — dijital hayatınızı yöneten, sürekli çalışan bir yapay zekâ çalışanı. Nebo'yu bir akıllı telefon gibi düşünün: uygulamalarıyla dönüştürücü hâle gelen güçlü bir platform.
Nebo tek başına da bellek, zamanlama, web'de gezinme, dosya yönetimi ve kabuk erişimi olan yetenekli bir yapay zekâ çalışanıdır. Ama asıl kilidi açan Uygulamalardır. Bir akıllı telefonun gücü uygulama ekosisteminden geldiği gibi, Nebo'nun gücü de yapabileceklerini genişleten uygulamalardan gelir.
Uygulamalar Nedir
Nebo Uygulamaları, olağanüstü işlevsellik sunan, kendi içinde bütün, önceden derlenmiş birimlerdir. Her uygulama Nebo'ya yeni bir süper güç kazandırır — takvim yönetimi, e-posta ayıklama, proje takibi, ev otomasyonu, finansal analiz — bir geliştiricinin hayal edebileceği her şey.
Uygulamalar olağanüstü gücü çok güvenli bir şekilde sunar. Her uygulama, varsayılan olarak her şeyin reddedildiği izinlerle bir korumalı alanda çalışır. Yalnızca manifestosunun bildirdiği ve kullanıcının onayladığı şeylere erişebilir.
Arayüz %100 sohbet tabanlıdır. Kullanıcılar uygulamalarla ayrı ekranlar veya panolar üzerinden etkileşime girmez. Nebo ile konuşurlar, Nebo da işleri halletmek için uygulamanın araçlarını kullanır. "Yarın takvimimde ne var?" — Nebo takvim uygulamasını çağırır. "Sarah ile saat 15:00'te bir toplantı oluştur" — Nebo takvim uygulamasını çağırır. Kullanıcı sohbetten hiç ayrılmaz.
Uygulamalar isteğe bağlı olarak bir ayarlar arayüzü sunabilir — Nebo'nun yerleşik tarayıcı penceresinde açılan bir yapılandırma paneli. Kullanıcılar API anahtarlarını burada girer, özellikleri açıp kapatır ve uygulamayı yapılandırır. Ayarlar arayüzü manifestodaki settings dizisiyle yönetilir (Nebo formu otomatik olarak oluşturur) ya da uygulama ui yeteneğiyle tamamen kendine özgü bir arayüz sunabilir.
Uygulamalar Nebo'nun yerleşik yeteneklerinin yerini alır ve onları genişletir. Nebo temel platform araçlarıyla gelir (yerel takvim erişimi, ekran görüntüleri vb.). Bir takvim uygulaması yüklediğinizde, yerleşik takvim aracının yerini alır ve onun bir üst kümesi olur — yerel + bulut + birleştirme + müsaitlik kontrolü.
Yalnızca Derlenmiş Politikası
Nebo, yalnızca derlenmiş ikili dosyalara izin veren katı bir politika uygular. Tüm uygulamalar yerel olarak derlenmiş yürütülebilir dosyalar olmalıdır.
| Durum | Diller |
|---|---|
| Destekleniyor | Go (önerilen), Rust, C/C++, Zig |
| Reddedildi | Python, Node.js, Ruby, Java, .NET, kabuk betikleri |
Gerekçe:
- Yapay zekânın kendini değiştirmesinin önlenmesi — Kabuk erişimi olan bir yapay zekâ çalışanı, yorumlanan bir betiğin davranışını çalışma anında değiştirebilir. Derlenmiş ikili dosyalar imzalandıktan sonra değiştirilemez.
- İmza bütünlüğü — Ed25519 imzaları ham ikili baytları kapsar. İmzalı bir ikili dosya, imzayı geçersiz kılmadan değiştirilemez.
- Korumalı alan denetimi — İkili biçim doğrulaması (ELF/Mach-O/PE sihirli baytları) hızlı ve güvenilir bir kapıdır.
Hızlı Başlangıç
SDK'yı yükleyin
Resmi SDK'lar tüm gRPC sunucu kurulumunu, sinyal işlemeyi ve protokol köprülemeyi üstlenir. Siz yalnızca işleyici arayüzlerini uygularsınız.
Go (önerilen):
go get github.com/neboloop/nebo-sdk-go Rust (yakında):
# Coming soon
[dependencies]
nebo-sdk = "0.1" C/C++ (yakında):
# Coming soon — Add as a CMake subdirectory or copy headers from sdk/c/include/ Uygulama Dizin Yapısı
Uygulamalar, Nebo veri dizininizin apps/ alt dizininde bulunur:
~/Library/Application Support/Nebo/apps/ # macOS
~/.config/nebo/apps/ # Linux
%AppData%\Nebo\apps\ # Windows
apps/
com.example.myapp/
manifest.json # Required: app metadata
binary # Required: executable (or named "app")
signatures.json # Required for NeboAI distribution, optional in dev
TOOL.md # Required: tool instructions for the agent
data/ # Auto-created: app's sandboxed storage
logs/ # Auto-created: stdout.log, stderr.log
ui/ # Optional: static UI assets (HTML/CSS/JS) Minimal Uygulama Kontrol Listesi
id,name,version,providesalanlarıylamanifest.jsonoluşturun- Yapay zekâ çalışanının aracınızı nasıl kullanması gerektiğini anlatan
TOOL.mddosyasını yazın - SDK'yı yükleyin (
go get github.com/neboloop/nebo-sdk-go) - Yeteneğiniz için işleyici arayüzünü uygulayın (
ToolHandler,ChannelHandlervb.) - İşleyiciyi kaydedin ve
app.Run()çağırın - Yerel bir ikili dosya derleyin (
go build -o binary .) - İkili dosyayı + manifest.json + TOOL.md dosyalarını
apps/<your-app-id>/dizinine koyun - Nebo onu otomatik olarak bulur ve başlatır
Yapılandırma
manifest.json
Her uygulamanın bir manifest.json dosyasına ihtiyacı vardır:
{
"id": "com.example.myapp",
"name": "My App",
"version": "1.0.0",
"description": "What this app does",
"runtime": "local",
"protocol": "grpc",
"provides": ["tool:my_tool"],
"permissions": ["network:outbound"],
"settings": [
{
"key": "api_key",
"title": "API Key",
"type": "password",
"required": true,
"description": "Your API key for the service",
"secret": true
}
]
} Zorunlu alanlar:
| Alan | Açıklama |
|---|---|
id | Ters alan adı biçiminde tanımlayıcı (ör. com.mycompany.myapp) |
name | Okunabilir ad |
version | Semver dizesi |
provides | En az bir yetenek (aşağıya bakın) |
İsteğe bağlı alanlar:
| Alan | Varsayılan | Açıklama |
|---|---|---|
runtime | "local" | "local" veya "remote" |
protocol | "grpc" | Yalnızca "grpc" desteklenir |
permissions | [] | Uygulamanın neye erişmesi gerektiği |
description | "" | Arayüzde gösterilir |
settings | [] | Yapılandırılabilir ayarlar (Ayarlar arayüzünde gösterilir) |
oauth | [] | OAuth sağlayıcı gereksinimleri (aşağıdaki OAuth bölümüne bakın) |
Yetenekler
Uygulamanızın ne sağladığını bildirin:
| Yetenek | gRPC Hizmeti | Açıklama |
|---|---|---|
gateway | GatewayService | LLM model yönlendirme |
tool:<name> | ToolService | Yapay zekâ çalışanı için adlandırılmış bir araç |
channel:<name> | ChannelService | Bir mesajlaşma kanalı |
comm | CommService | Yapay zekâ çalışanları arasında iletişim |
ui | UIService | HTTP proxy'li özel arayüz |
schedule | ScheduleService | Özel zamanlama |
vision | ToolService | Görüntü işleme |
browser | ToolService | Tarayıcı otomasyonu |
Bir uygulama birden fazla yetenek sağlayabilir. Örneğin bir uygulama hem bir araç hem de bir arayüz paneli sağlayabilir.
İzinler
İzinler, uygulamanın neye erişebileceğini denetler. Varsayılan olarak her şey reddedilir — bildirilmemişse uygulama onu kullanamaz.
| Önek | Örnekler | Açıklama |
|---|---|---|
network: | network:outbound, network:* | Ağ erişimi |
filesystem: | filesystem:read, filesystem:write | Dosya sistemi erişimi |
memory: | memory:read, memory:write | Yapay zekâ çalışanı bellek erişimi |
session: | session:read | Sohbet oturumları |
tool: | tool:shell, tool:file | Diğer araçları kullanma |
shell: | shell:exec | Kabuk komutu çalıştırma |
channel: | channel:send, channel:* | Kanal işlemleri |
comm: | comm:send, comm:* | Yapay zekâ çalışanları arasında iletişim |
model: | model:chat | Yapay zekâ modeli erişimi |
user: | user:token | İsteklerde kullanıcı JWT'sini alma |
schedule: | schedule:create | Cron işi yönetimi |
database: | database:query | Veritabanı erişimi |
storage: | storage:read, storage:write | Kalıcı depolama |
context: | context:read | Yapay zekâ çalışanı bağlam erişimi |
subagent: | subagent:spawn | Alt ajan işlemleri |
lane: | lane:enqueue | Şerit işlemleri |
notification: | notification:send | Anlık bildirimler |
embedding: | embedding:search | Vektör gömme erişimi |
skill: | skill:invoke | Beceri çağırma |
advisor: | advisor:consult | Danışman sistemi erişimi |
mcp: | mcp:connect | MCP sunucusu erişimi |
voice: | voice:record | Ses erişimi |
browser: | browser:navigate | Tarayıcı otomasyonu |
oauth: | oauth:google, oauth:* | OAuth belirteci erişimi |
settings: | settings:read | Ayarlara erişim |
capability: | capability:register | Yetenek kaydı |
Joker karakterli izinler desteklenir: network:*, herhangi bir network: izin denetimiyle eşleşir.
Ayarlar
Ayarlar, Nebo arayüzünde uygulamanın ayarlar panelinde görünür. Nebo bunları veritabanında saklar ve değiştiklerinde Configure RPC'si ile uygulamanıza gönderir.
Ayar şemanız NeboAI uygulama mağazası listesine dahil edilir. Zorunlu ayarları yapılandırılmamış uygulamalar arayüzde "Kurulum Gerekli" rozetiyle gösterilir.
| Tür | Açıklama |
|---|---|
text | Tek satırlık metin girişi |
password | Maskelenmiş metin girişi |
toggle | Açık/kapalı anahtarı |
select | Önceden tanımlı seçenekli açılır liste |
number | Sayısal giriş |
url | Doğrulamalı URL girişi |
{
"key": "region",
"title": "Region",
"type": "select",
"required": true,
"default": "us-east-1",
"options": [
{"label": "US East", "value": "us-east-1"},
{"label": "EU West", "value": "eu-west-1"}
]
} OAuth Gereksinimleri
Uygulamalar OAuth sağlayıcı gereksinimlerini bildirebilir. Nebo'nun OAuth aracısı tüm akışı yönetir — uygulamalar belirteçleri Configure RPC'si ile otomatik olarak alır.
{
"oauth": [
{
"provider": "google",
"scopes": ["https://www.googleapis.com/auth/calendar"]
}
]
} | Alan | Açıklama |
|---|---|
provider | OAuth sağlayıcısı: "google", "microsoft", "github" |
scopes | Uygulamanın ihtiyaç duyduğu OAuth kapsamlarının dizisi |
Kullanıcı uygulamayı yüklediğinde Nebo, gerekli OAuth kapsamlarını yetkilendirmesini ister. Uygulama, OAuth akışını kendisi yönetmeden yenilenmiş belirteçleri Configure RPC'si ile alır.
Ortam Değişkenleri
Uygulama süreciniz temizlenmiş bir ortam alır. Tüm gizli bilgiler çıkarılır. Size verilenler:
| Değişken | Değer |
|---|---|
NEBO_APP_DIR | Uygulamanın kurulum dizini |
NEBO_APP_SOCK | Oluşturulacak Unix soketinin yolu |
NEBO_APP_ID | Manifestodaki uygulama kimliği |
NEBO_APP_NAME | Manifestodaki uygulama adı |
NEBO_APP_VERSION | Manifestodaki uygulama sürümü |
NEBO_APP_DATA | Uygulamanın data/ dizininin yolu |
PATH | Sistem PATH değeri (olduğu gibi aktarılır) |
HOME | Kullanıcının ana dizini (olduğu gibi aktarılır) |
TMPDIR | Geçici dizin (olduğu gibi aktarılır) |
Önemli: İkili dosyanız, NEBO_APP_SOCK konumundaki Unix soketini dinleyen bir gRPC sunucusu oluşturmalıdır. Nebo bu soketin görünmesi için en fazla 10 saniye bekler.
Uygulama Başlatma Sırası
- Nebo
manifest.jsondosyasını okur ve doğrular - Uygulama dizininde
binaryveyaappyürütülebilir dosyasını bulur .quarantinedişaretini denetler (karantinaya alınmış uygulamaları başlatmayı reddeder)- İptal denetimi (yalnızca NeboAI üzerinden dağıtılan uygulamalar)
- İmza doğrulama (yalnızca NeboAI üzerinden dağıtılan uygulamalar, geliştirme modunda atlanır)
- İkili dosya doğrulama (sembolik bağlantıları, betikleri, yürütülebilir olmayan ve aşırı büyük dosyaları reddeder)
- Önceki çalıştırmadan kalan eski soketi temizler
- Korumalı depolama için
data/dizinini oluşturur - Uygulamaya özel günlük dosyalarını ayarlar (
logs/stdout.log,logs/stderr.log) - İkili dosyayı temizlenmiş ortam ve süreç grubu yalıtımıyla başlatır
- Unix soketinin görünmesini bekler (üstel geri çekilme, en fazla 10 saniye)
- Unix soketi üzerinden gRPC ile bağlanır
providesalanına göre yeteneğe özel gRPC istemcileri oluşturur- Sağlık denetimi çalıştırır
- Yetenekleri yapay zekâ çalışanına kaydeder (araçlar, ağ geçidi, iletişim vb.)
Araç Uygulamaları
Manifestonuzda "provides": ["tool:my_tool_name"] bildirin.
STRAP Kalıbı
Tüm Nebo araç uygulamaları, şemaları ve yürütme yönlendirmeleri için STRAP (Single Tool Resource Action Pattern) kalıbını kullanmak zorundadır. Bu, Nebo'nun 35'ten fazla ayrı aracı 4 alan aracında birleştirmek için kendi içinde kullandığı kalıbın aynısıdır — LLM bağlam yükünü yaklaşık %80 azaltır.
Temel fikir: Birden fazla araç (get_events, check_availability, suggest_slots) kaydetmek yerine, doğru işleyiciye yönlendiren action (ve isteğe bağlı olarak resource) alanlarına sahip TEK bir araç kaydedin.
Tek kaynaklı örnek (takvim):
calendar(action: "get_events", start: "2025-01-15T09:00:00Z", end: "2025-01-16T00:00:00Z")
calendar(action: "next_event")
calendar(action: "check_availability", start: "...", end: "...")
calendar(action: "suggest_slots", duration_minutes: 30, preferred_time: "morning") Çok kaynaklı örnek (proje yöneticisi):
project(resource: "task", action: "create", title: "Ship v2", assignee: "alice")
project(resource: "task", action: "list", status: "open")
project(resource: "milestone", action: "create", name: "Beta", deadline: "2025-03-01")
project(resource: "milestone", action: "list") Şema kuralları:
- Her zaman zorunlu bir dize enum'u olarak
actionalanını ekleyin resourcealanını (zorunlu dize enum'u) yalnızca aracınız birden fazla farklı kaynak türünü yönetiyorsa ekleyin- Diğer tüm alanlar eyleme özel parametrelerdir
actionenum açıklaması kullanılabilir tüm eylemleri listelemelidir
STRAP neden önemlidir:
- LLM'ler
actionyönlendirme kalıbını bir kez öğrenir ve tüm işlemlere genelleştirir - Araç tanımları bağlamın yaklaşık %6'sını tüketir — STRAP bunu %80 azaltır
- Yeni işlemler yeni araç kayıtları değil, yalnızca enum eklemeleridir
- Barındırılan ve yerel modellerde aynı şekilde çalışır
Go Örneği — Hesap Makinesi Aracı
package main
import (
"context"
"encoding/json"
"fmt"
"log"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Calculator struct{}
func (c *Calculator) Name() string { return "calculator" }
func (c *Calculator) Description() string { return "Performs arithmetic calculations." }
func (c *Calculator) Schema() json.RawMessage {
return nebo.NewSchema("add", "subtract", "multiply", "divide").
Number("a", "First operand", true).
Number("b", "Second operand", true).
Build()
}
func (c *Calculator) Execute(_ context.Context, input json.RawMessage) (string, error) {
var in struct {
Action string `json:"action"`
A float64 `json:"a"`
B float64 `json:"b"`
}
if err := json.Unmarshal(input, &in); err != nil {
return "", fmt.Errorf("invalid input: %w", err)
}
var result float64
switch in.Action {
case "add":
result = in.A + in.B
case "subtract":
result = in.A - in.B
case "multiply":
result = in.A * in.B
case "divide":
if in.B == 0 {
return "", fmt.Errorf("division by zero")
}
result = in.A / in.B
default:
return "", fmt.Errorf("unknown action: %s", in.Action)
}
return fmt.Sprintf("%g %s %g = %g", in.A, in.Action, in.B, result), nil
}
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterTool(&Calculator{})
log.Fatal(app.Run())
} manifest.json:
{
"id": "com.example.calculator",
"name": "Calculator",
"version": "1.0.0",
"description": "Arithmetic calculator tool for the agent",
"runtime": "local",
"protocol": "grpc",
"provides": ["tool:calculator"],
"permissions": []
} Derleme ve kurulum:
go build -o binary .
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.calculator
cp binary manifest.json ~/Library/Application\ Support/Nebo/apps/com.example.calculator/ Rust Örneği
use async_trait::async_trait;
use nebo_sdk::{NeboApp, NeboError, SchemaBuilder};
use nebo_sdk::tool::ToolHandler;
use serde::Deserialize;
use serde_json::Value;
struct Calculator;
#[derive(Deserialize)]
struct Input { action: String, a: f64, b: f64 }
#[async_trait]
impl ToolHandler for Calculator {
fn name(&self) -> &str { "calculator" }
fn description(&self) -> &str { "Performs arithmetic calculations." }
fn schema(&self) -> Value {
SchemaBuilder::new(&["add", "subtract", "multiply", "divide"])
.number("a", "First operand", true)
.number("b", "Second operand", true)
.build()
}
async fn execute(&self, input: Value) -> Result<String, NeboError> {
let i: Input = serde_json::from_value(input)
.map_err(|e| NeboError::Execution(e.to_string()))?;
let r = match i.action.as_str() {
"add" => i.a + i.b,
"subtract" => i.a - i.b,
"multiply" => i.a * i.b,
"divide" => {
if i.b == 0.0 {
return Err(NeboError::Execution("division by zero".into()));
}
i.a / i.b
}
other => return Err(NeboError::Execution(format!("unknown action: {other}"))),
};
Ok(format!("{} {} {} = {}", i.a, i.action, i.b, r))
}
}
#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
NeboApp::new()?.register_tool(Calculator).run().await?;
Ok(())
} C Örneği
#include <nebo/nebo.h>
#include <stdio.h>
#include <stdlib.h>
#include <string.h>
static int calculator_execute(const char *input_json, char **output, int *is_error) {
/* Parse JSON, compute result, set *output */
*output = strdup("2 add 3 = 5");
*is_error = 0;
return 0;
}
int main(void) {
const char *actions[] = {"add", "subtract", "multiply", "divide", NULL};
nebo_schema_builder_t *sb = nebo_schema_new(actions);
nebo_schema_number(sb, "a", "First operand", 1);
nebo_schema_number(sb, "b", "Second operand", 1);
char *schema = nebo_schema_build(sb);
nebo_schema_free(sb);
nebo_tool_handler_t calculator = {
.name = "calculator",
.description = "Performs arithmetic calculations.",
.schema = schema,
.execute = calculator_execute,
};
nebo_app_t *app = nebo_app_new();
nebo_app_register_tool(app, &calculator);
int ret = nebo_app_run(app);
free(schema);
return ret;
} Kanal Uygulamaları
"provides": ["channel:my_channel"] ve "permissions": ["channel:send"] bildirin.
Kanal uygulamaları, harici mesajlaşma platformlarını (Telegram, Discord, Slack vb.) Nebo'nun yapay zekâ çalışanına bağlar. Bir kullanıcı harici platformda mesaj gönderdiğinde, uygulamanız bunu Receive ile Nebo'ya akıtır. Yapay zekâ çalışanı yanıt vermek istediğinde Nebo, uygulamanızın Send yöntemini çağırır.
Nasıl çalışır
- Nebo, kanalınızın benzersiz tanımlayıcısını almak için
ID()çağırır - Nebo, uygulamanızın ayarlarındaki yapılandırmayla
Connect()çağırır - Nebo bir
Receive()akışı açar — bir kullanıcı bota her mesaj gönderdiğinde uygulamanız gelen mesajları iletir - Gelen mesajlar yapay zekâ çalışanının ana sohbet şeridine yönlendirilir
- Yapay zekâ çalışanı mesaj göndermek istediğinde Nebo, v1 mesaj zarfıyla
Send()çağırır - Kapanışta Nebo
Disconnect()çağırır
v1 Mesaj Zarfı
Gelen ve giden tüm kanal mesajları ortak mesaj zarfını kullanır:
{
"message_id": "01953f8a-...",
"channel_id": "telegram:12345",
"sender": { "name": "Alex", "role": "COO", "bot_id": "uuid" },
"text": "Q3 numbers look good...",
"attachments": [{ "type": "image", "url": "https://...", "filename": "chart.png", "size": 45000 }],
"reply_to": "01953f89-...",
"actions": [{ "label": "Approve", "callback_id": "approve_q3" }],
"platform_data": null,
"timestamp": "2026-02-12T15:10:00Z"
} | Alan | Tür | Açıklama |
|---|---|---|
message_id | UUID v7 | Zamana göre sıralı benzersiz kimlik |
channel_id | {type}:{platform_id} | Yönlendirilebilir kanal tanımlayıcısı |
sender | object | Bot kimliği — name, role, botId |
text | string | Mesaj gövdesi |
attachments | array | Dosyalar, görseller, ses |
reply_to | UUID v7 | İleti dizisi için üst mesaj kimliği |
actions | array | Etkileşimli düğmeler/klavyeler |
platform_data | bytes | Platforma özel özellikler için opak aktarım |
timestamp | ISO 8601 | Bunu yayıncı ayarlar |
İki katmanlı tasarım: Ortak alanlar (text, attachments, reply_to, actions), çalışanın başlattığı mesajlaşmanın %90'ını karşılar. Platforma özel özellikler platform_data içine girer — eklentiniz bunları yerel platform biçimine ve bu biçimden dönüştürür.
Sohbet Akışları
Kanal mesajları, yalıtım için kanal başına ayrı sohbet akışları üzerinden yönlendirilir:
neboai/bot/{botID}/channels/{channelType}/inbound # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound # messages from agent → channel Go Örneği — Telegram Kanalı
package main
import (
"context"
"encoding/json"
"fmt"
"log"
"time"
"github.com/google/uuid"
tgbot "github.com/go-telegram/bot"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Telegram struct {
bot *tgbot.Bot
messages chan nebo.ChannelEnvelope
cancel context.CancelFunc
}
func (t *Telegram) ID() string { return "telegram" }
func (t *Telegram) Connect(_ context.Context, config map[string]string) error {
token := config["bot_token"]
if token == "" {
return fmt.Errorf("bot_token is required")
}
botCtx, cancel := context.WithCancel(context.Background())
t.cancel = cancel
bot, err := tgbot.New(token, tgbot.WithDefaultHandler(
func(bCtx context.Context, b *tgbot.Bot, update *tgbot.Update) {
if update.Message == nil {
return
}
env := nebo.ChannelEnvelope{
MessageID: uuid.Must(uuid.NewV7()).String(),
ChannelID: fmt.Sprintf("telegram:%d", update.Message.Chat.ID),
Text: update.Message.Text,
Timestamp: time.Unix(int64(update.Message.Date), 0).UTC(),
}
t.messages <- env
},
))
if err != nil {
return err
}
t.bot = bot
go bot.Start(botCtx)
return nil
}
func (t *Telegram) Send(ctx context.Context, env nebo.ChannelEnvelope) (string, error) {
if t.bot == nil {
return "", fmt.Errorf("not connected")
}
chatID := env.ChannelID[len("telegram:"):]
params := &tgbot.SendMessageParams{
ChatID: chatID,
Text: env.Text,
}
msg, err := t.bot.SendMessage(ctx, params)
if err != nil {
return "", err
}
return fmt.Sprintf("%d", msg.MessageID), nil
}
func (t *Telegram) Receive(_ context.Context) (<-chan nebo.ChannelEnvelope, error) {
return t.messages, nil
}
func (t *Telegram) Disconnect(_ context.Context) error {
if t.cancel != nil {
t.cancel()
}
return nil
}
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterChannel(&Telegram{
messages: make(chan nebo.ChannelEnvelope, 100),
})
log.Fatal(app.Run())
} manifest.json:
{
"id": "com.example.telegram",
"name": "Telegram",
"version": "1.0.0",
"description": "Telegram messaging channel for Nebo",
"runtime": "local",
"protocol": "grpc",
"provides": ["channel:telegram"],
"permissions": ["channel:send", "network:outbound"],
"settings": [
{
"key": "bot_token",
"title": "Bot Token",
"type": "password",
"required": true,
"description": "Telegram bot token from @BotFather",
"secret": true
}
]
} Diğer Yetenekler
İletişim Uygulaması
"provides": ["comm"] ve "permissions": ["comm:*"] bildirin. İletişim uygulamaları, yapay zekâ çalışanları arasında iletişimi sağlar.
| Alan | Açıklama |
|---|---|
from | Gönderen çalışan kimliği |
to | Alıcı çalışan kimliği |
topic | Mesaj konusu/kanalı |
type | "message", "mention", "proposal", "command", "info", "task" |
content | Mesaj gövdesi |
Temel davranışlar:
Register, bu yapay zekâ çalışanını yetenekleriyle birlikte ağda duyururSubscribe/Unsubscribekonu aboneliklerini yönetirReceivegelen mesajları akıtır (sunucu akışı, kanallarla aynı)- Aynı anda yalnızca bir iletişim uygulaması etkin olabilir
Ağ Geçidi Uygulaması
Bir ağ geçidi uygulaması LLM isteklerini modellere yönlendirir. "provides": ["gateway"] ve "permissions": ["network:outbound", "user:token"] bildirin.
GatewayRequest; mesajları, araçları, sistem istemini, en fazla belirteç sayısını, sıcaklığı ve bir UserContext (user:token izni verilmişse JWT belirteci) içerir.
GatewayEvent türleri:
| Tür | İçerik | Açıklama |
|---|---|---|
"text" | Metin parçası | Akış hâlinde metin belirteci |
"tool_call" | JSON | Model bir araç çağırmak istiyor |
"thinking" | Metin parçası | Genişletilmiş düşünme/akıl yürütme |
"error" | Hata mesajı | Bir şeyler ters gitti |
"done" | Boş | Akış tamamlandı |
Arayüz Uygulaması
Bir arayüz uygulaması, Nebo'nun yerleşik tarayıcı penceresinde açılan özel bir yapılandırma arayüzü sağlar. "provides": ["ui"] bildirin. Otomatik ayarlar formundan (Nebo'nun settings manifestonuzdan oluşturduğu) farklı olarak, bir arayüz uygulaması kendi eksiksiz HTML/CSS/JS ön yüzünü sunar.
Uygulamanız statik web varlıkları (HTML, CSS, JS — genellikle index.html içeren bir SPA) barındıran bir ui/ dizini ile gelir. Nebo bu dosyaları doğrudan sunar ve API çağrılarını gRPC üzerinden uygulamanıza iletir.
| Yol | Mekanizma | Amaç |
|---|---|---|
GET /api/v1/apps/{id}/ui/* | Statik dosya sunucusu | Dosyaları ui/ dizininizden sunar (SPA yedeği olarak index.html) |
ANY /api/v1/apps/{id}/api/* | gRPC proxy | HTTP isteklerini uygulamanızın UIService.HandleRequest() yöntemine iletir |
SDK standart bir net/http.ServeMux sarmalar, böylece normal Go HTTP işleyicileri yazarsınız — gRPC köprülemesini SDK otomatik olarak halleder.
Go Örneği — Pano Arayüzü:
package main
import (
"encoding/json"
"log"
"net/http"
nebo "github.com/neboloop/nebo-sdk-go"
)
type Dashboard struct {
mux *http.ServeMux
}
func NewDashboard() *Dashboard {
d := &Dashboard{mux: http.NewServeMux()}
d.mux.HandleFunc("GET /status", func(w http.ResponseWriter, r *http.Request) {
json.NewEncoder(w).Encode(map[string]string{"status": "ok"})
})
d.mux.HandleFunc("POST /action", func(w http.ResponseWriter, r *http.Request) {
var req map[string]string
json.NewDecoder(r.Body).Decode(&req)
json.NewEncoder(w).Encode(map[string]string{"result": "done"})
})
return d
}
func (d *Dashboard) Handler() *http.ServeMux { return d.mux }
func main() {
app, err := nebo.New()
if err != nil {
log.Fatal(err)
}
app.RegisterUI(NewDashboard())
log.Fatal(app.Run())
} ui/index.html dosyanız /api/v1/apps/com.example.dashboard/api/status adresine fetch çağrıları yapar ve bunlar mux işleyicinize iletilir.
Zamanlama Uygulaması
Bir zamanlama uygulaması, Nebo'nun yerleşik cron zamanlayıcısının yerini alır. "provides": ["schedule"] ve "permissions": ["schedule:create"] bildirin.
Zamanlama uygulamanız başladığında Nebo, tüm zamanlamayı varsayılan cron motoru yerine uygulamanız üzerinden yönlendirir. Uygulamanız çökerse Nebo otomatik olarak yerleşik motora geri döner.
- Uygulamanız zamanlama durumunun sahibidir — bir zamanlama uygulaması etkinken Nebo zamanlamaları kendi veritabanında saklamaz
- Standart CRUD:
Create,Get,List,Update,Delete,Enable,Disable Triggerssunucu akışlı bir RPC'dir — bir zamanlama her tetiklendiğinde uygulamanız bir tetikleme mesajı gönderir- Aynı anda yalnızca bir zamanlama uygulaması etkin olabilir
Çok Yetenekli Uygulamalar
Bir uygulama birden fazla yetenek sağlayabilir. Örneğin hem araç hem de arayüz içeren bir pano uygulaması:
{
"id": "com.example.dashboard",
"name": "Dashboard",
"version": "1.0.0",
"provides": ["tool:dashboard_query", "ui"],
"permissions": ["network:outbound"]
} app, _ := nebo.New()
app.RegisterTool(&dashboardTool{})
app.RegisterUI(&dashboardUI{})
log.Fatal(app.Run()) Paketleme
.napp Biçimi
NeboAI üzerinden dağıtım için uygulamanızı bir .napp dosyası (tar.gz arşivi) olarak paketleyin:
cd com.example.myapp/
tar -czf myapp-1.0.0.napp manifest.json binary signatures.json TOOL.md Zorunlu dosyalar:
| Dosya | En Büyük Boyut | Açıklama |
|---|---|---|
manifest.json | 1 MB | Uygulama meta verileri |
binary veya app | 500 MB | Yürütülebilir dosya |
signatures.json | 1 MB | Ed25519 imzaları |
TOOL.md | 1 MB | Yapay zekâ çalışanı için araç talimatları |
Çıkarma sırasındaki güvenlik kuralları:
- Yol geçişi yok (
../reddedilir) - Sembolik bağlantı yok (reddedilir)
- Mutlak yol yok (reddedilir)
- Yalnızca izin listesindeki dosya adları kabul edilir
İmzalar
NeboAI uygulamaları Ed25519 ile imzalar. signatures.json biçimi:
{
"key_id": "a1b2c3d4",
"algorithm": "ed25519",
"manifest_signature": "<base64 signature of raw manifest.json bytes>",
"binary_sha256": "<hex SHA256 of binary>",
"binary_signature": "<base64 signature of raw binary bytes>"
} Geliştirme modunda (NeboAI URL'si yapılandırılmamışken) imza doğrulaması tamamen atlanır. Yerel geliştirme için signatures.json dosyasına ihtiyacınız yoktur.
Yayımlama
Uygulamanız yerel olarak çalıştığında, tüm Nebo kullanıcılarına dağıtılması için NeboAI üzerinden yayımlayın.
Geliştirici Hesabı Kurulumu
POST /api/v1/owners/registeradresinden bir NeboAI hesabı oluşturun- JWT belirteci almak için giriş yapın:
POST /api/v1/owners/login - Bir geliştirici hesabı oluşturun:
POST /api/v1/developer/accounts
Gönderim Akışı
draft → pending_review → [approved] → published
→ [rejected] → draft (fix and resubmit) Adım 1: Uygulamayı oluşturun
curl -X POST https://neboai.com/api/v1/developer/apps \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"name": "My App",
"version": "1.0.0",
"description": "What it does",
"category": "productivity",
"visibility": "public"
}' Adım 2: Platform ikili dosyalarını yükleyin
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/binaries \
-H "Authorization: Bearer $TOKEN" \
-F "binary=@myapp-darwin-arm64" \
-F "platform=darwin-arm64" Her platform için bir ikili dosya yükleyin: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.
Adım 3: İncelemeye gönderin
curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
-H "Authorization: Bearer $TOKEN" İnceleme Süreci
- Otomatik tarama — ikili dosyalar VirusTotal ile taranır
- Yönetici incelemesi — NeboAI ekibi meta verileri, manifestoyu ve tarama sonuçlarını inceler
- Onaylandığında — NeboAI uygulamayı Ed25519 ile imzalar ve yayımlar
- Reddedildiğinde — size bir gerekçe iletilir; düzeltip yeniden gönderebilirsiniz
Hedef inceleme süresi: <24 saat.
Güncelleme Gönderme
- Uygulamanın sürümünü güncelleyin: yeni sürümle
PUT /api/v1/developer/apps/{id} - Her platform için yeni ikili dosyaları yükleyin
- Yeniden incelemeye gönderin
Her güncelleme aynı inceleme sürecinden geçer. Yeni sürüm onaylanana kadar önceki sürümler kullanılabilir kalır.
Mağaza Meta Verileri
| Alan | Açıklama |
|---|---|
category | ör. productivity, communication, developer-tools |
icon | Uygulama simgesi URL'si |
visibility | public veya private |
description | Manifestodaki açıklamadan daha uzun/zengin olabilir |
Geliştirme İş Akışı
Yerel Geliştirme
Yerel geliştirme için paketleme gerekmez:
- Uygulama dizininizi oluşturun:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp manifest.jsondosyanızı ve kodunuzu yazın- İkili dosyanızı derleyin:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Nebo yeni dizini otomatik olarak algılar (veya Nebo'yu yeniden başlatın)
- Kod değişikliklerinden sonra ikili dosyayı yeniden derleyin — dosya izleyici uygulamayı yeniden başlatır
Günlükleri Görüntüleme
Uygulamanın stdout/stderr çıktıları uygulamaya özel günlük dosyalarında toplanır:
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stdout.log
tail -f ~/Library/Application\ Support/Nebo/apps/com.example.myapp/logs/stderr.log Kalıcı Veriler
Uygulamanızın kalıcı olarak saklaması gereken dosyalar için data/ dizinini (NEBO_APP_DATA ortam değişkeni olarak da kullanılabilir) kullanın. Bu dizin uygulama güncellemelerinden ve karantinadan etkilenmez.
Hata Ayıklama İpuçları
- Uygulamanız başlamıyorsa hatalar için
logs/stderr.logdosyasını kontrol edin - İkili dosyanın yürütülebilir olduğundan emin olun (
chmod +x binary) NEBO_APP_SOCKiçindeki Unix soketi yolunu dinlediğinizden emin olun- Soket, başlatmadan sonraki 10 saniye içinde hazır olmalıdır
- Depolama için sabit kodlanmış yollar değil,
NEBO_APP_DATAkullanın - Hata ayıklama günlükleri için stderr'e yazdırın (
logs/stderr.logiçinde toplanır)
Doğrulama
# List installed apps
nebo apps list
# Check running apps via the web UI Settings > Apps
# Or check the apps directory for running sockets
ls ~/Library/Application\ Support/Nebo/apps/*/app.sock Kaldırma
nebo apps uninstall com.example.myapp Beceriler
Beceriler Nedir
Beceriler, Nebo'nun bir sohbet sırasında nasıl davranacağını şekillendiren talimat kümeleridir. Bir beceri etkin olduğunda içeriği doğrudan sistem istemine eklenir — o oturum boyunca yapay zekâ çalışanının üslubunu, yöntemini, alan uzmanlığını ve araç kullanımını yönlendirir.
Beceriler kod değildir. YAML meta verileri olan markdown belgeleridir. Derleme yok, ikili dosya yok, gRPC yok. Bir beceri, bir dizindeki SKILL.md dosyasıdır. Hepsi bu.
Beceriler bağlama özgü ve geçicidir. İlgili olduklarında etkinleşir (tetikleyici eşleşmesiyle veya elle yüklenerek), birkaç tur boyunca kalır ve artık gerekmediğinde sona erer. Bu, yapay zekâ çalışanının bağlamını yalın tutar — istemde yalnızca şu an önemli olan yönlendirme bulunur.
Beceriler uygulamaları tamamlar. Uygulamalar çalıştırılabilir yetenekler sağlar (araçlar, kanallar, ağ geçitleri). Beceriler ise yönetim rehberliği sağlar — bu araçların etkili şekilde nasıl kullanılacağını. Bir takvim uygulaması Nebo'ya etkinlikleri okuma ve yazma yeteneği verir. Bir "toplantı hazırlığı" becerisi ise Nebo'ya o takvim uygulamasını, e-postayı ve web aramasını birlikte kullanarak toplantılara nasıl hazırlanacağını anlatır.
Beceriler ve Uygulamalar
| Beceriler | Uygulamalar | |
|---|---|---|
| Biçim | Markdown (SKILL.md) | Derlenmiş ikili dosya (.napp) |
| Çalışma zamanı | Sistem istemine eklenir | gRPC üzerinden korumalı alanda çalışan süreç |
| Sağladıkları | Davranışsal rehberlik, yöntem | Araçlar, kanallar, arayüz panelleri |
| Ömür | Oturumla sınırlı, TTL'ye dayalı sona erme | Her zaman çalışır |
| Oluşturma | Bir markdown dosyası yazın | Yazın, derleyin, imzalayın, paketleyin |
| Güvenlik | İzin gerekmez | Varsayılan olarak reddeden korumalı alan |
Hızlı Başlangıç
Nebo beceriler klasörünüzde SKILL.md dosyası içeren bir dizin oluşturun:
~/Library/Application Support/Nebo/skills/ # macOS
~/.config/nebo/skills/ # Linux
%AppData%\Nebo\skills\ # Windows mkdir -p ~/.config/nebo/skills/my-skill Bir SKILL.md yazın:
---
name: my-skill
description: One-line description of what this skill does
version: "1.0.0"
triggers:
- keyword that activates this skill
- another trigger phrase
---
# My Skill
Instructions for Nebo when this skill is active.
Tell the agent what to do, how to approach problems,
what tools to use, and what tone to take. Nebo, beceriler dizinini fsnotify ile izler. Beceriniz hemen kullanılabilir — yeniden başlatma gerekmez. Bir tetikleyiciyle eşleşen bir şey söyleyin, otomatik olarak etkinleşsin.
Ya da doğrudan Nebo'dan isteyin: "Blog yazıları yazmak için bir beceri oluştur" — Nebo SKILL.md dosyasını sizin için yazar.
SKILL.md Biçimi
Her beceri iki bölümden oluşan tek bir SKILL.md dosyasıdır: --- işaretleri arasındaki YAML ön bilgisi ve bir markdown gövdesi (sistem istemine eklenen asıl talimatlar).
| Alan | Zorunlu | Varsayılan | Açıklama |
|---|---|---|---|
name | Evet | — | Benzersiz tanımlayıcı (kısa ad olur) |
description | Evet | — | Beceri kataloğunda gösterilen tek satırlık açıklama |
version | Hayır | "1.0.0" | Güncellemeleri izlemek için semver |
author | Hayır | — | Beceri yazarı |
priority | Hayır | 0 | Yüksek değer = önce eşleşir (kritik geçersiz kılmalar için 100+) |
max_turns | Hayır | 4 | Otomatik sona ermeden önceki etkinlik dışı tur sayısı |
triggers | Hayır | [] | Bu beceriyi otomatik etkinleştiren ifadeler (büyük/küçük harfe duyarsız alt dize eşleşmesi) |
tools | Hayır | [] | Bu becerinin kullanmayı beklediği araçlar (bilgi amaçlı) |
dependencies | Hayır | [] | Yüklü olması gereken diğer beceriler |
tags | Hayır | [] | Sınıflandırma ve keşif için |
platform | Hayır | [] | Desteklenen platformlar: macos, linux, windows (boş = tümü) |
Beceriler Nasıl Etkinleşir
Beceriler iki aşamalı bir etkinleştirme modeli izler: önce ipucu, sonra çağırma.
Aşama 1: Tetikleyici Eşleşmesi — Kullanıcı her mesaj gönderdiğinde Nebo, kayıtlı tüm becerileri tetikleyici eşleşmeleri için tarar. Eşleşen beceriler sistem isteminde ipucu olarak görünür. Yapay zekâ çalışanı ipucunu görür ve beceriyi çağırıp çağırmayacağına karar verir.
Aşama 2: Çağırma — Yapay zekâ çalışanı bir beceriyi şu çağrıyla çağırır:
skill(name: "code-review") Bu, SKILL.md şablonunun tamamını araç sonucu olarak döndürür, çağrıyı kaydeder ve sonraki turlarda şablonu sistem istemine yeniden ekler.
TTL ve Sona Erme:
- Otomatik eşleşen beceriler: 4 tur etkinlik dışılık (
max_turnsile yapılandırılabilir) - Elle yüklenen beceriler: 6 tur etkinlik dışılık
- Yeniden çağırma zamanlayıcıyı sıfırlar
- Kesin sınır: oturum başına en fazla 4 etkin beceri
- Belirteç bütçesi: etkin becerilerin toplam içeriği 16.000 karakterle sınırlıdır
Becerileri Yönetme
Yapay zekâ çalışanı becerileri skill aracıyla yönetebilir:
| Eylem | Açıklama | Örnek |
|---|---|---|
catalog | Kullanılabilir tüm becerileri listele | skill(action: "catalog") |
load | Bu oturum için etkinleştir | skill(name: "code-review", action: "load") |
unload | Bir beceriyi devre dışı bırak | skill(name: "code-review", action: "unload") |
create | Diskte yeni bir beceri oluştur | skill(action: "create", content: "...") |
update | Mevcut bir beceriyi güncelle | skill(name: "my-skill", action: "update", content: "...") |
delete | Bir beceriyi diskten sil | skill(name: "my-skill", action: "delete") |
İyi Beceriler Yazmak
İyi bir beceri şablonunda şunlar bulunur:
- Net bir başlık — yapay zekâ çalışanına hangi modda olduğunu söyler
- Temel ilkeler — pazarlığa açık olmayan davranış kuralları
- Yöntem — yaygın senaryolar için adım adım yaklaşım
- Örnekler — somut kullanıcı mesajı ve yanıt kalıpları
- Kaçınılacak kalıplar — YAPILMAMASI gerekenler (modeller olumsuz örneklerden iyi öğrenir)
İpucu: Her beceri tek bir işi iyi yapmalıdır. "Genel programlama" becerisi oluşturmayın — code-review, debugging, api-design becerilerini ayrı ayrı oluşturun. Yapay zekâ çalışanında aynı anda birden fazlası etkin olabilir.
Hazır Beceriler
Nebo, yaygın kullanım durumlarını kapsayan hazır becerilerle gelir:
| Beceri | Öncelik | Açıklama |
|---|---|---|
onboarding | 100 | Yeni kullanıcıyı karşılama ve profil bilgilerini toplama |
best-friend | 50 | Kişilik becerisi — samimi, sadık, açık sözlü |
debugging | 25 | Sistematik hata ayıklama yöntemi |
api-design | 15 | RESTful API tasarımında en iyi uygulamalar |
code-review | 10 | Önem düzeyli yapılandırılmış kod incelemesi |
database-expert | 10 | Veritabanı tasarımı, sorgular, optimizasyon |
git-workflow | 10 | Git dallanma, commit'ler, PR iş akışları |
security-audit | 10 | Güvenlik analizi ve güvenlik açığı tespiti |
Bunlar hem kullanışlı varsayılanlar hem de kendi becerilerinizi oluşturmak için başvuru örnekleridir.
Başvuru
Proto Dosyaları
Proto dosyaları proto/apps/v0/ içinde bulunur. SDK'lar önceden üretilmiş kodla gelir, bu yüzden normal geliştirme için protoc gerekmez.
| Dosya | Hizmet | Temel RPC'ler |
|---|---|---|
v0/common.proto | (yalnızca mesajlar) | HealthCheckRequest/Response, SettingsMap, UserContext, Empty |
v0/tool.proto | ToolService | Name, Description, Schema, Execute, RequiresApproval, Configure |
v0/channel.proto | ChannelService | ID, Connect, Disconnect, Send, Receive (akış), Configure |
v0/comm.proto | CommService | Name, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (akış), Configure |
v0/gateway.proto | GatewayService | HealthCheck, Stream (akış), Poll, Cancel, Configure |
v0/ui.proto | UIService | HealthCheck, HandleRequest, Configure |
v0/schedule.proto | ScheduleService | HealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (akış), Configure |
Her hizmet HealthCheck ve Configure RPC'lerini içerir. SDK ikisini de otomatik olarak yönetir.
Kanal Proto Türleri
| Mesaj Türü | Açıklama |
|---|---|
ChannelSendRequest | message_id, channelId, sender, text, attachments, reply_to, actions, platform_data içeren giden mesaj zarfı |
ChannelSendResponse | İleti dizisi için platform mesaj kimliği |
InboundMessage | Tüm ortak alanları + zaman damgasını içeren gelen mesaj zarfı |
MessageSender | Bot kimliği (name, role, botId) — aracı tarafından zenginleştirilir |
Attachment | Dosya/görsel/ses eki (type, url, filename, size) |
MessageAction | Etkileşimli düğme/klavye eylemi (label, callback_id) |
Bot Kimliği ve Rolleri
Nebo botlarının üç eksenli bir kimlik modeli vardır:
- creature — Botun ne olduğu (arketip): "Hazırcevap stratejist", "Titiz araştırmacı"
- role — Kullanıcıyla nasıl bir ilişkisi olduğu (ilişki): "Arkadaş", "COO", "Mentor"
- vibe — Enerjisi (iletişim tarzı): "Rahat ama fikir sahibi", "Sıcak ve cesaretlendirici"
Kanal eklentiniz giden bir mesaj aldığında sender alanı botun name ve role değerlerini içerir. Bunu platformunuzdaki görünen adı biçimlendirmek için kullanın. Rol bir iş unvanı değildir — bir ilişki tanımıdır. "COO" ve "DevLead" yanında "Arkadaş", "Oğul" ve "Mentor" da geçerli rollerdir.