NeboAI
NeboAI
Бастау

Nebo үшін қолданбалар жасаңыз

ЖИ-ге жаңа супер қабілеттер беріңіз. Құралдар, арналар, шлюздер, UI панельдері — нативті бинарлық файлға компиляцияланған, ойыңызға келген кез келген нәрсе.

Шолу

Nebo деген не

Nebo — жеке компьютерлік ЖИ көмекшісі, цифрлық өміріңізді басқаратын үнемі жұмыс істейтін ЖИ қызметкері. Nebo-ны смартфон сияқты елестетіңіз: қолданбалары арқылы түбегейлі өзгеріс әкелетін қуатты платформа.

Nebo өз бетінше-ақ жады, жоспарлау, веб-шолу, файлдарды басқару және shell қолжетімділігі бар қабілетті ЖИ қызметкері. Бірақ нағыз мүмкіндікті қолданбалар ашады. Смартфонның күші оның қолданбалар экожүйесінен келетіні сияқты, Nebo-ның күші де оның мүмкіндіктерін кеңейтетін қолданбалардан келеді.

Қолданбалар деген не

Nebo қолданбалары — керемет функционалы бар, дербес, алдын ала компиляцияланған бірліктер. Әр қолданба Nebo-ға жаңа супер қабілет береді — күнтізбені басқару, хаттарды сұрыптау, жобаларды бақылау, үйді автоматтандыру, қаржылық талдау — әзірлеуші ойлап таба алатын кез келген нәрсе.

Қолданбалар орасан зор мүмкіндікті өте қауіпсіз түрде береді. Әр қолданба әдепкі бойынша бәріне тыйым салынған рұқсаттармен құмсалғышта жұмыс істейді. Ол тек манифестте жарияланған және пайдаланушы мақұлдаған нәрсеге ғана қол жеткізе алады.

Интерфейс 100% сөйлесу арқылы жүреді. Пайдаланушылар қолданбалармен бөлек экрандар немесе бақылау тақталары арқылы жұмыс істемейді. Олар Nebo-мен сөйлеседі, ал Nebo істі бітіру үшін қолданбаның құралдарын пайдаланады. «Ертең күнтізбемде не бар?» — Nebo күнтізбе қолданбасын шақырады. «Сағат 15:00-де Sarah-пен кездесу құр» — Nebo күнтізбе қолданбасын шақырады. Пайдаланушы әңгімеден ешқашан шықпайды.

Қолданбалар қаласа баптаулар интерфейсін ұсына алады — Nebo-ның кіріктірілген браузер терезесінде ашылатын конфигурация панелі. Пайдаланушылар осы жерде API кілттерін енгізеді, функцияларды қосып-өшіреді және қолданбаны баптайды. Баптаулар интерфейсі манифесттегі settings массиві арқылы басқарылады (Nebo форманы автоматты түрде көрсетеді), немесе қолданба ui мүмкіндігі арқылы өзінің толық жеке интерфейсін ұсына алады.

Қолданбалар Nebo-ның кіріктірілген мүмкіндіктерін алмастырады және кеңейтеді. Nebo негізгі платформа құралдарымен келеді (жергілікті күнтізбеге қолжетімділік, скриншоттар және т.б.). Күнтізбе қолданбасын орнатқанда, ол кіріктірілген күнтізбе құралын алмастырып, оның кеңейтілген жиынына айналады — жергілікті + бұлт + біріктіру + бос уақытты тексеру.

Тек компиляцияланған файлдар саясаты

Nebo тек компиляцияланған бинарлық файлдарға қатаң саясат қолданады. Барлық қолданбалар нативті компиляцияланған орындалатын файлдар болуы тиіс.

КүйіТілдер
Қолдау көрсетіледіGo (ұсынылады), Rust, C/C++, Zig
ҚабылданбайдыPython, Node.js, Ruby, Java, .NET, shell скриптері

Негіздеме:

  • ЖИ-дің өзін-өзі өзгертуінің алдын алу — Shell қолжетімділігі бар ЖИ қызметкері интерпретацияланатын скрипттің әрекетін орындалу кезінде өзгерте алады. Компиляцияланған бинарлық файлдар қолтаңба қойылғаннан кейін өзгермейді.
  • Қолтаңба тұтастығы — Ed25519 қолтаңбалары бинарлық файлдың шикі байттарын қамтиды. Қолтаңбаланған бинарлық файлды қолтаңбаны жарамсыз етпей өзгерту мүмкін емес.
  • Құмсалғыш талаптарын орындату — Бинарлық пішімді тексеру (ELF/Mach-O/PE magic bytes) — жылдам әрі сенімді тосқауыл.

Жылдам бастау

SDK орнату

Ресми SDK-лар gRPC серверін баптаудың, сигналдарды өңдеудің және протоколдарды байланыстырудың бәрін өздері атқарады. Сізге тек өңдеуші интерфейстерін іске асыру қалады.

Go (ұсынылады):

go get github.com/neboloop/nebo-sdk-go

Rust (жақында):

# Coming soon
[dependencies]
nebo-sdk = "0.1"

C/C++ (жақында):

# Coming soon — Add as a CMake subdirectory or copy headers from sdk/c/include/

Қолданба каталогының құрылымы

Қолданбалар Nebo деректер каталогыңыздың apps/ ішкі каталогында орналасады:

~/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)

Ең қарапайым қолданбаға арналған тексеру тізімі

  1. id, name, version, provides өрістері бар manifest.json жасаңыз
  2. ЖИ қызметкері құралыңызды қалай пайдалануы керегін сипаттайтын TOOL.md жазыңыз
  3. SDK-ны орнатыңыз (go get github.com/neboloop/nebo-sdk-go)
  4. Мүмкіндігіңізге арналған өңдеуші интерфейсін іске асырыңыз (ToolHandler, ChannelHandler және т.б.)
  5. Өңдеушіні тіркеп, app.Run() шақырыңыз
  6. Нативті бинарлық файл жинаңыз (go build -o binary .)
  7. Бинарлық файлды + manifest.json + TOOL.md файлдарын apps/<your-app-id>/ каталогына орналастырыңыз
  8. Nebo оны автоматты түрде тауып, іске қосады

Конфигурация

manifest.json

Әр қолданбаға manifest.json қажет:

{
    "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
        }
    ]
}

Міндетті өрістер:

ӨрісСипаттама
idКері домендік идентификатор (мысалы, com.mycompany.myapp)
nameАдамға түсінікті атау
versionSemver жолы
providesКемінде бір мүмкіндік (төменде қараңыз)

Міндетті емес өрістер:

ӨрісӘдепкіСипаттама
runtime"local""local" немесе "remote"
protocol"grpc"Тек "grpc" қолдау көрсетіледі
permissions[]Қолданбаға неге қолжетімділік керек
description""Интерфейсте көрсетіледі
settings[]Бапталатын параметрлер (Settings интерфейсінде көрсетіледі)
oauth[]OAuth провайдеріне қойылатын талаптар (төмендегі OAuth бөлімін қараңыз)

Мүмкіндіктер

Қолданбаңыз не ұсынатынын жариялаңыз:

МүмкіндікgRPC қызметіСипаттама
gatewayGatewayServiceLLM модельдерін бағыттау
tool:<name>ToolServiceЖИ қызметкеріне арналған атаулы құрал
channel:<name>ChannelServiceХабар алмасу арнасы
commCommServiceЖИ қызметкерлері арасындағы байланыс
uiUIServiceHTTP прокси бар жеке интерфейс
scheduleScheduleServiceЖеке жоспарлау
visionToolServiceКөру арқылы өңдеу
browserToolServiceБраузерді автоматтандыру

Қолданба бірнеше мүмкіндік ұсына алады. Мысалы, қолданба әрі құрал, әрі UI панелін ұсына алады.

Рұқсаттар

Рұқсаттар қолданбаның неге қол жеткізе алатынын басқарады. Әдепкі бойынша тыйым — жарияланбаса, қолданба оны пайдалана алмайды.

ПрефиксМысалдарСипаттама
network:network:outbound, network:*Желіге қолжетімділік
filesystem:filesystem:read, filesystem:writeФайлдық жүйеге қолжетімділік
memory:memory:read, memory:writeЖИ қызметкерінің жадына қолжетімділік
session:session:readӘңгіме сеанстары
tool:tool:shell, tool:fileБасқа құралдарды пайдалану
shell:shell:execShell командаларын орындау
channel:channel:send, channel:*Арна операциялары
comm:comm:send, comm:*ЖИ қызметкерлері арасындағы байланыс
model:model:chatЖИ модельдеріне қолжетімділік
user:user:tokenСұрауларда пайдаланушы JWT-ін алу
schedule:schedule:createCron тапсырмаларын басқару
database:database:queryДерекқорға қолжетімділік
storage:storage:read, storage:writeТұрақты сақтау орны
context:context:readЖИ қызметкерінің контекстіне қолжетімділік
subagent:subagent:spawnІшкі агент операциялары
lane:lane:enqueueЖолақ операциялары
notification:notification:sendPush-хабарландырулар
embedding:embedding:searchВекторлық эмбеддингтерге қолжетімділік
skill:skill:invokeДағдыны шақыру
advisor:advisor:consultКеңесші жүйесіне қолжетімділік
mcp:mcp:connectMCP серверіне қолжетімділік
voice:voice:recordДауыс/аудиоға қолжетімділік
browser:browser:navigateБраузерді автоматтандыру
oauth:oauth:google, oauth:*OAuth токендеріне қолжетімділік
settings:settings:readБаптауларға қолжетімділік
capability:capability:registerМүмкіндіктерді тіркеу

Қалқымалы таңбалы рұқсаттарға қолдау көрсетіледі: network:* кез келген network: рұқсат тексеруіне сәйкес келеді.

Баптаулар

Баптаулар Nebo интерфейсінде қолданбаның баптаулар панелінде көрсетіледі. Nebo оларды дерекқорда сақтайды және өзгерген кезде Configure RPC арқылы қолданбаңызға жібереді.

Баптаулар схемаңыз NeboAI қолданбалар дүкеніндегі тізімдемеге енгізіледі. Міндетті баптаулары толтырылмаған қолданбалар интерфейсте «Баптау қажет» белгісімен көрсетіледі.

ТүріСипаттама
textБір жолды мәтін енгізу
passwordЖасырылған мәтін енгізу
toggleЛогикалық қосу/өшіру ауыстырғышы
selectАлдын ала анықталған нұсқалары бар ашылмалы тізім
numberСандық енгізу
urlТексерісі бар URL енгізу
{
    "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 талаптары

Қолданбалар OAuth провайдеріне қойылатын талаптарды жариялай алады. Nebo-ның OAuth брокері бүкіл үдерісті өзі жүргізеді — қолданбалар токендерді Configure RPC арқылы автоматты түрде алады.

{
    "oauth": [
        {
            "provider": "google",
            "scopes": ["https://www.googleapis.com/auth/calendar"]
        }
    ]
}
ӨрісСипаттама
providerOAuth провайдері: "google", "microsoft", "github"
scopesҚолданбаға қажет OAuth аумақтарының массиві

Пайдаланушы қолданбаны орнатқанда, Nebo одан қажетті OAuth аумақтарына рұқсат беруді сұрайды. Қолданба OAuth үдерісін өзі жүргізбей-ақ жаңартылған токендерді Configure RPC арқылы алады.

Орта айнымалылары

Қолданба процесіңіз тазартылған ортаны алады. Барлық құпия деректер алынып тасталады. Сізге берілетіндер:

АйнымалыМәні
NEBO_APP_DIRҚолданбаның орнату каталогы
NEBO_APP_SOCKЖасалатын Unix сокетінің жолы
NEBO_APP_IDМанифесттегі қолданба ID-і
NEBO_APP_NAMEМанифесттегі қолданба атауы
NEBO_APP_VERSIONМанифесттегі қолданба нұсқасы
NEBO_APP_DATAҚолданбаның data/ каталогының жолы
PATHЖүйелік PATH (өзгеріссіз беріледі)
HOMEПайдаланушының үй каталогы (өзгеріссіз беріледі)
TMPDIRУақытша каталог (өзгеріссіз беріледі)

Маңызды: Бинарлық файлыңыз NEBO_APP_SOCK мекенжайындағы Unix сокетін тыңдайтын gRPC серверін жасауы тиіс. Nebo бұл сокеттің пайда болуын 10 секундқа дейін күтеді.

Қолданбаны іске қосу реті

  1. Nebo manifest.json файлын оқып, тексереді
  2. Қолданба каталогынан binary немесе app орындалатын файлын табады
  3. .quarantined белгісін тексереді (карантиндегі қолданбаларды іске қоспайды)
  4. Кері қайтарып алу тексерісі (тек NeboAI таратқан қолданбалар үшін)
  5. Қолтаңбаны тексеру (тек NeboAI таратқан қолданбалар үшін, әзірлеу режимінде өткізіліп жіберіледі)
  6. Бинарлық файлды тексеру (символдық сілтемелерді, скрипттерді, орындалмайтын және тым үлкен файлдарды қабылдамайды)
  7. Алдыңғы іске қосудан қалған ескі сокетті тазалайды
  8. Құмсалғыштағы сақтау үшін data/ каталогын жасайды
  9. Әр қолданбаға лог файлдарын баптайды (logs/stdout.log, logs/stderr.log)
  10. Бинарлық файлды тазартылған ортамен және процестер тобын оқшаулаумен іске қосады
  11. Unix сокетінің пайда болуын күтеді (экспоненциалды кідіріс, ең көбі 10 секунд)
  12. Unix сокеті арқылы gRPC бойынша қосылады
  13. provides негізінде мүмкіндікке арналған gRPC клиенттерін жасайды
  14. Жұмыс күйін тексереді
  15. Мүмкіндіктерді ЖИ қызметкерінде тіркейді (құралдар, шлюз, comm және т.б.)

Құрал қолданбалары

Манифестіңізде "provides": ["tool:my_tool_name"] деп жариялаңыз.

STRAP үлгісі

Барлық Nebo құрал қолданбалары схема мен орындауды бағыттау үшін міндетті түрде STRAP (Single Tool Resource Action Pattern) үлгісін пайдалануы керек. Бұл — Nebo ішкі жұмысында 35+ жеке құралды 4 домендік құралға біріктіру үшін пайдаланатын сол үлгі — LLM контекстіне түсетін жүктемені ~80%-ға азайтады.

Негізгі идея: Бірнеше құралды (get_events, check_availability, suggest_slots) тіркеудің орнына, тиісті өңдеушіге бағыттайтын action (және қажет болса resource) өрістері бар БІР құралды тіркеңіз.

Бір ресурсты мысал (күнтізбе):

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")

Көп ресурсты мысал (жоба менеджері):

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")

Схема ережелері:

  1. Әрдайым міндетті string enum ретінде action өрісін қосыңыз
  2. resource өрісін (міндетті string enum) құралыңыз бірнеше бөлек ресурс түрін басқарғанда ғана қосыңыз
  3. Қалған барлық өрістер — әрекетке тән параметрлер
  4. action enum сипаттамасы барлық қолжетімді әрекеттерді тізіп көрсетуі керек

STRAP неге маңызды:

  • LLM-дер action бағыттау үлгісін бір рет үйреніп, оны барлық операцияларға жалпылайды
  • Құрал анықтамалары контекстің ~6%-ын алады — STRAP оны 80%-ға қысқартады
  • Жаңа операциялар — жаңа құрал тіркеу емес, тек enum-ға қосымша
  • Хостингтегі және жергілікті модельдерде бірдей жұмыс істейді

Go мысалы — Калькулятор құралы

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": []
}

Жинау және орнату:

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 мысалы

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 мысалы

#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;
}

Арна қолданбалары

"provides": ["channel:my_channel"] және "permissions": ["channel:send"] деп жариялаңыз.

Арна қолданбалары сыртқы хабар алмасу платформаларын (Telegram, Discord, Slack және т.б.) Nebo-ның ЖИ қызметкерімен байланыстырады. Пайдаланушы сыртқы платформада хабар жібергенде, қолданбаңыз оны Receive арқылы Nebo-ға ағынмен жібереді. ЖИ қызметкері жауап бергісі келгенде, Nebo қолданбаңыздың Send әдісін шақырады.

Қалай жұмыс істейді

  1. Nebo арнаңыздың бірегей идентификаторын алу үшін ID() шақырады
  2. Nebo қолданбаңыздың баптауларындағы конфигурациямен Connect() шақырады
  3. Nebo Receive() ағынын ашады — пайдаланушы ботқа жазған сайын қолданбаңыз кіріс хабарларды жібереді
  4. Кіріс хабарлар ЖИ қызметкерінің негізгі әңгіме жолағына бағытталады
  5. ЖИ қызметкері хабар жібергісі келгенде, Nebo v1 хабар конвертімен Send() шақырады
  6. Жұмысты аяқтағанда Nebo Disconnect() шақырады

v1 хабар конверті

Барлық арна хабарлары — кіріс те, шығыс та — ортақ хабар конвертін пайдаланады:

{
  "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"
}
ӨрісТүріСипаттама
message_idUUID v7Уақыт бойынша реттелген бірегей ID
channel_id{type}:{platform_id}Бағыттауға болатын арна идентификаторы
senderobjectБот сәйкестігі — name, role, botId
textstringХабар мәтіні
attachmentsarrayФайлдар, суреттер, аудио
reply_toUUID v7Тізбек құру үшін ата-хабардың ID-і
actionsarrayИнтерактивті түймелер/пернетақталар
platform_databytesПлатформаға тән мүмкіндіктер үшін мөлдір емес өткізу өрісі
timestampISO 8601Мұны жариялаушы орнатады

Екі қабатты дизайн: Ортақ өрістер (text, attachments, reply_to, actions) қызметкер бастаған хабар алмасудың 90%-ын қамтиды. Платформаға тән мүмкіндіктер platform_data ішіне түседі — плагиніңіз оларды платформаның нативті пішіміне және кері түрлендіреді.

Әңгіме ағындары

Арна хабарлары оқшаулау үшін әр арнаға бөлек әңгіме ағындары арқылы бағытталады:

neboai/bot/{botID}/channels/{channelType}/inbound    # messages from users → agent
neboai/bot/{botID}/channels/{channelType}/outbound   # messages from agent → channel

Go мысалы — Telegram арнасы

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
        }
    ]
}

Қосымша мүмкіндіктер

Comm қолданбасы

"provides": ["comm"] және "permissions": ["comm:*"] деп жариялаңыз. Comm қолданбалары ЖИ қызметкерлері арасында байланыс орнатуға мүмкіндік береді.

ӨрісСипаттама
fromЖіберуші қызметкердің ID-і
toАлушы қызметкердің ID-і
topicХабар тақырыбы/арнасы
type"message", "mention", "proposal", "command", "info", "task"
contentХабар мәтіні

Негізгі мінез-құлық:

  • Register бұл ЖИ қызметкерін оның мүмкіндіктерімен бірге желіде жариялайды
  • Subscribe/Unsubscribe тақырыптарға жазылуды басқарады
  • Receive кіріс хабарларды ағынмен жібереді (арналардағыдай, сервер жақтан ағын)
  • Бір уақытта тек бір comm қолданбасы белсенді бола алады

Шлюз қолданбасы

Шлюз қолданбасы LLM сұрауларын модельдерге бағыттайды. "provides": ["gateway"] және "permissions": ["network:outbound", "user:token"] деп жариялаңыз.

GatewayRequest ішінде хабарлар, құралдар, жүйелік промпт, максималды токен саны, temperature және UserContext (user:token рұқсаты берілсе, JWT токені) болады.

GatewayEvent түрлері:

ТүріМазмұныСипаттама
"text"Мәтін бөлігіАғындық мәтін токені
"tool_call"JSONМодель құралды шақырғысы келеді
"thinking"Мәтін бөлігіКеңейтілген ойлау/пайымдау
"error"Қате туралы хабарБірдеңе дұрыс болмады
"done"БосАғын аяқталды

UI қолданбасы

UI қолданбасы Nebo-ның кіріктірілген браузер терезесінде ашылатын жеке конфигурация интерфейсін ұсынады. "provides": ["ui"] деп жариялаңыз. Автоматты баптаулар формасынан (оны Nebo сіздің settings манифестіңізден көрсетеді) айырмашылығы — UI қолданбасы өзінің толық HTML/CSS/JS фронтендін ұсынады.

Қолданбаңыз статикалық веб-ресурстары (HTML, CSS, JS — әдетте index.html файлы бар SPA) бар ui/ каталогымен бірге шығады. Nebo бұл файлдарды тікелей ұсынады және API шақыруларын gRPC арқылы қолданбаңызға проксилейді.

ЖолМеханизмМақсаты
GET /api/v1/apps/{id}/ui/*Статикалық файл серверіui/ каталогыңыздағы файлдарды ұсынады (SPA үшін index.html файлына қайтарады)
ANY /api/v1/apps/{id}/api/*gRPC проксиHTTP сұрауларын қолданбаңыздың UIService.HandleRequest() әдісіне проксилейді

SDK стандартты net/http.ServeMux орап алады, сондықтан сіз кәдімгі Go HTTP өңдеушілерін жазасыз — gRPC байланыстыруды SDK автоматты түрде атқарады.

Go мысалы — Dashboard UI:

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 файлыңыз /api/v1/apps/com.example.dashboard/api/status мекенжайына fetch шақыруларын жасайды, ал олар mux өңдеушіңізге проксиленеді.

Кесте қолданбасы

Кесте қолданбасы Nebo-ның кіріктірілген cron жоспарлаушысын алмастырады. "provides": ["schedule"] және "permissions": ["schedule:create"] деп жариялаңыз.

Кесте қолданбаңыз іске қосылғанда, Nebo барлық жоспарлауды әдепкі cron қозғалтқышының орнына сіздің қолданбаңыз арқылы бағыттайды. Қолданбаңыз құласа, Nebo автоматты түрде кіріктірілген қозғалтқышқа қайта ауысады.

  • Қолданбаңыз кесте күйіне иелік етеді — кесте қолданбасы белсенді кезде Nebo кестелерді өз дерекқорында сақтамайды
  • Стандартты CRUD: Create, Get, List, Update, Delete, Enable, Disable
  • Triggers — сервер жақтан ағындық RPC — кесте іске қосылған сайын қолданбаңыз іске қосу хабарын жібереді
  • Бір уақытта тек бір кесте қолданбасы белсенді бола алады

Көп мүмкіндікті қолданбалар

Қолданба бірнеше мүмкіндік ұсына алады. Мысалы, әрі құралы, әрі интерфейсі бар бақылау тақтасы қолданбасы:

{
    "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())

Пакеттеу

.napp пішімі

NeboAI арқылы тарату үшін қолданбаңызды .napp файлы (tar.gz мұрағаты) ретінде пакеттеңіз:

cd com.example.myapp/
tar -czf myapp-1.0.0.napp manifest.json binary signatures.json TOOL.md

Міндетті файлдар:

ФайлЕң үлкен өлшеміСипаттама
manifest.json1 MBҚолданба метадеректері
binary немесе app500 MBОрындалатын файл
signatures.json1 MBEd25519 қолтаңбалары
TOOL.md1 MBЖИ қызметкеріне арналған құрал нұсқаулары

Ашу кезіндегі қауіпсіздік ережелері:

  • Жол бойымен жоғары өтуге болмайды (../ қабылданбайды)
  • Символдық сілтемелерге болмайды (қабылданбайды)
  • Абсолюттік жолдарға болмайды (қабылданбайды)
  • Тек рұқсат етілген тізімдегі файл атаулары қабылданады

Қолтаңбалар

NeboAI қолданбаларға Ed25519 арқылы қолтаңба қояды. signatures.json пішімі:

{
    "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>"
}

Әзірлеу режимінде (NeboAI URL бапталмаған кезде) қолтаңбаны тексеру толығымен өткізіліп жіберіледі. Жергілікті әзірлеу үшін сізге signatures.json қажет емес.

Жариялау

Қолданбаңыз жергілікті түрде жұмыс істегеннен кейін, оны барлық Nebo пайдаланушыларына тарату үшін NeboAI арқылы жариялаңыз.

Әзірлеуші аккаунтын баптау

  1. POST /api/v1/owners/register арқылы NeboAI аккаунтын тіркеңіз
  2. JWT токенін алу үшін кіріңіз: POST /api/v1/owners/login
  3. Әзірлеуші аккаунтын жасаңыз: POST /api/v1/developer/accounts

Жіберу үдерісі

draft → pending_review → [approved] → published
                       → [rejected] → draft (fix and resubmit)

1-қадам: Қолданбаны жасау

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"
  }'

2-қадам: Платформалық бинарлық файлдарды жүктеу

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"

Әр платформаға бір бинарлық файл жүктеңіз: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.

3-қадам: Тексеруге жіберу

curl -X POST https://neboai.com/api/v1/developer/apps/{id}/submit \
  -H "Authorization: Bearer $TOKEN"

Тексеру үдерісі

  1. Автоматты сканерлеу — бинарлық файлдар VirusTotal арқылы сканерленеді
  2. Әкімші тексеруі — NeboAI командасы метадеректерді, манифестті және сканерлеу нәтижелерін қарайды
  3. Мақұлданғанда — NeboAI қолданбаға Ed25519 арқылы қолтаңба қойып, оны жариялайды
  4. Қабылданбағанда — себебін аласыз, түзетіп, қайта жібере аласыз

Тексерудің мақсатты уақыты: <24 сағат.

Жаңартуларды шығару

  1. Қолданба нұсқасын жаңартыңыз: жаңа нұсқамен PUT /api/v1/developer/apps/{id}
  2. Әр платформаға жаңа бинарлық файлдарды жүктеңіз
  3. Қайтадан тексеруге жіберіңіз

Әр жаңарту дәл сондай тексеруден өтеді. Жаңа нұсқа мақұлданғанша алдыңғы нұсқалар қолжетімді болып қалады.

Дүкен метадеректері

ӨрісСипаттама
categoryмысалы, productivity, communication, developer-tools
iconҚолданба белгішесінің URL-і
visibilitypublic немесе private
descriptionМанифест сипаттамасынан ұзынырақ/толығырақ болуы мүмкін

Әзірлеу үдерісі

Жергілікті әзірлеу

Жергілікті әзірлеу үшін пакеттеу қажет емес:

  1. Қолданба каталогын жасаңыз:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. manifest.json файлыңыз бен кодыңызды жазыңыз
  3. Бинарлық файлды жинаңыз:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. Nebo жаңа каталогты автоматты түрде анықтайды (немесе Nebo-ны қайта іске қосыңыз)
  5. Кодты өзгерткеннен кейін бинарлық файлды қайта жинаңыз — файл бақылаушысы қолданбаны қайта іске қосады

Логтарды қарау

Қолданбаның stdout/stderr ағындары әр қолданбаға арналған лог файлдарына жазылады:

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

Тұрақты деректер

Қолданбаңыз сақтап қалуы тиіс кез келген файл үшін data/ каталогын (ол NEBO_APP_DATA орта айнымалысы ретінде де қолжетімді) пайдаланыңыз. Бұл каталог қолданба жаңартулары мен карантиннен кейін де сақталады.

Ақауларды іздеу бойынша кеңестер

  • Қолданбаңыз іске қосылмаса, қателерді logs/stderr.log файлынан тексеріңіз
  • Бинарлық файлдың орындалатынына көз жеткізіңіз (chmod +x binary)
  • NEBO_APP_SOCK ішіндегі Unix сокет жолын тыңдап тұрғаныңызға көз жеткізіңіз
  • Сокет іске қосылғаннан кейін 10 секунд ішінде дайын болуы тиіс
  • Сақтау үшін қатаң жазылған жолдарды емес, NEBO_APP_DATA пайдаланыңыз
  • Жөндеу логтары үшін stderr-ге шығарыңыз (logs/stderr.log файлына жазылады)

Тексеру

# 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

Жою

nebo apps uninstall com.example.myapp

Дағдылар

Дағдылар деген не

Дағдылар — әңгіме барысында Nebo-ның мінез-құлқын айқындайтын нұсқаулар жиынтығы. Дағды белсенді болғанда, оның мазмұны тікелей жүйелік промптқа енгізіледі — сол сеанс үшін ЖИ қызметкерінің үнін, әдістемесін, салалық біліктілігін және құралдарды пайдалануын бағыттайды.

Дағдылар — код емес. Олар YAML метадеректері бар markdown құжаттары. Компиляция да, бинарлық файл да, gRPC да жоқ. Дағды — каталогтағы SKILL.md файлы. Болғаны сол.

Дағдылар контекстке байланысты әрі уақытша. Олар қажет кезде іске қосылады (іске қосу шартына сәйкестік немесе қолмен жүктеу арқылы), бірнеше жүріс бойы сақталады және енді қажет болмаған кезде мерзімі бітеді. Бұл ЖИ қызметкерінің контекстін ықшам ұстайды — промптта тек дәл қазір маңызды нұсқаулар ғана болады.

Дағдылар қолданбаларды толықтырады. Қолданбалар орындалатын мүмкіндіктерді (құралдар, арналар, шлюздер) береді. Дағдылар үйлестіру нұсқауларын береді — сол құралдарды қалай тиімді пайдалану керек. Күнтізбе қолданбасы Nebo-ға оқиғаларды оқу және жазу мүмкіндігін береді. «Кездесуге дайындық» дағдысы Nebo-ға сол күнтізбе қолданбасын, поштаны және веб-іздеуді бірге пайдаланып, кездесулерге қалай дайындалу керегін айтады.

Дағдылар мен қолданбалар

ДағдыларҚолданбалар
ПішіміMarkdown (SKILL.md)Компиляцияланған бинарлық файл (.napp)
Орындалу ортасыЖүйелік промптқа енгізіледіgRPC арқылы жұмыс істейтін құмсалғыштағы процесс
ҰсынадыМінез-құлық нұсқаулары, әдістемеҚұралдар, арналар, UI панельдері
Өмір сүру мерзіміСеанс аясында, TTL бойынша мерзімі бітедіӘрдайым жұмыс істейді
ЖасауMarkdown файлын жазуЖазу, компиляциялау, қолтаңба қою, пакеттеу
ҚауіпсіздікРұқсат қажет емесӘдепкі бойынша тыйым салынған құмсалғыш

Жылдам бастау

Nebo дағдылар қалтасында SKILL.md файлы бар каталог жасаңыз:

~/Library/Application Support/Nebo/skills/   # macOS
~/.config/nebo/skills/                        # Linux
%AppData%\Nebo\skills\                        # Windows
mkdir -p ~/.config/nebo/skills/my-skill

SKILL.md жазыңыз:

---
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 дағдылар каталогын fsnotify арқылы бақылайды. Дағдыңыз бірден қолжетімді болады — қайта іске қосу қажет емес. Іске қосу шартына сәйкес келетін бір нәрсе айтыңыз, сонда ол автоматты түрде іске қосылады.

Немесе Nebo-дан тікелей сұраңыз: «Блог жазбаларын жазуға арналған дағды жаса» — Nebo SKILL.md файлын сіз үшін жазып береді.

SKILL.md пішімі

Әр дағды екі бөліктен тұратын жалғыз SKILL.md файлы: --- белгілерінің арасындағы YAML frontmatter және markdown мәтіні (жүйелік промптқа енгізілетін нақты нұсқаулар).

ӨрісМіндеттіӘдепкіСипаттама
nameИә—Бірегей идентификатор (slug-қа айналады)
descriptionИә—Дағдылар каталогында көрсетілетін бір жолдық сипаттама
versionЖоқ"1.0.0"Жаңартуларды бақылауға арналған semver
authorЖоқ—Дағды авторы
priorityЖоқ0Жоғарырақ = бірінші сәйкестендіріледі (маңызды басымдықтар үшін 100+)
max_turnsЖоқ4Автоматты түрде мерзімі біткенге дейінгі белсенсіз жүрістер саны
triggersЖоқ[]Бұл дағдыны автоматты түрде іске қосатын тіркестер (регистрді ескермейтін ішкі жол сәйкестігі)
toolsЖоқ[]Бұл дағды пайдаланатын құралдар (ақпарат үшін)
dependenciesЖоқ[]Орнатылуы тиіс басқа дағдылар
tagsЖоқ[]Санаттау және табу үшін
platformЖоқ[]Қолдау көрсетілетін платформалар: macos, linux, windows (бос = барлығы)

Дағдылар қалай іске қосылады

Дағдылар екі кезеңді іске қосу үлгісіне сүйенеді: алдымен нұсқау, содан кейін шақыру.

1-кезең: Іске қосу шартын сәйкестендіру — Пайдаланушы хабар жіберген сайын Nebo тіркелген барлық дағдыларды іске қосу шарттарына сәйкестігін тексереді. Сәйкес келетін дағдылар жүйелік промптта нұсқау ретінде пайда болады. ЖИ қызметкері нұсқауды көріп, дағдыны шақыру-шақырмауды шешеді.

2-кезең: Шақыру — ЖИ қызметкері дағдыны мына шақыру арқылы іске қосады:

skill(name: "code-review")

Бұл құрал нәтижесі ретінде толық SKILL.md үлгісін қайтарады, шақыруды тіркейді және кейінгі жүрістерде үлгіні жүйелік промптқа қайта енгізеді.

TTL және мерзімнің бітуі:

  • Автоматты сәйкестендірілген дағдылар: 4 белсенсіз жүріс (max_turns арқылы бапталады)
  • Қолмен жүктелген дағдылар: 6 белсенсіз жүріс
  • Қайта шақыру таймерді қайта бастайды
  • Қатаң шек: бір сеансқа ең көбі 4 белсенді дағды
  • Токен бюджеті: белсенді дағдылардың жалпы мазмұны 16 000 таңбамен шектеледі

Дағдыларды басқару

ЖИ қызметкері дағдыларды skill құралы арқылы басқара алады:

ӘрекетСипаттамаМысал
catalogБарлық қолжетімді дағдыларды тізімдеуskill(action: "catalog")
loadОсы сеанс үшін іске қосуskill(name: "code-review", action: "load")
unloadДағдыны өшіруskill(name: "code-review", action: "unload")
createДискіде жаңа дағды жасауskill(action: "create", content: "...")
updateБар дағдыны жаңартуskill(name: "my-skill", action: "update", content: "...")
deleteДағдыны дискіден жоюskill(name: "my-skill", action: "delete")

Жақсы дағдылар жазу

Жақсы дағды үлгісінде мыналар болады:

  1. Айқын тақырып — ЖИ қызметкеріне қандай режимде екенін айтады
  2. Негізгі қағидалар — талқыланбайтын мінез-құлық ережелері
  3. Әдістеме — жиі кездесетін жағдайларға арналған қадамдық тәсіл
  4. Мысалдар — пайдаланушы хабары мен жауаптың нақты үлгілері
  5. Анти-үлгілер — нені істеуге БОЛМАЙДЫ (модельдер теріс мысалдардан жақсы үйренеді)

Кеңес: Әр дағды бір нәрсені жақсы істеуі керек. «Жалпы бағдарламалау» дағдысын жасамаңыз — code-review, debugging, api-design дағдыларын бөлек жасаңыз. ЖИ қызметкерінде бір мезгілде бірнеше белсенді дағды бола алады.

Кіріктірілген дағдылар

Nebo жиі кездесетін жағдайларды қамтитын кіріктірілген дағдылармен келеді:

ДағдыБасымдықСипаттама
onboarding100Жаңа пайдаланушыны қарсы алу және профиль деректерін жинау
best-friend50Мінез дағдысы — еркін, адал, шынайы әңгіме
debugging25Жүйелі жөндеу әдістемесі
api-design15RESTful API жобалаудың үздік тәжірибелері
code-review10Маңыздылық деңгейлері бар құрылымдалған код шолуы
database-expert10Дерекқорды жобалау, сұраулар, оңтайландыру
git-workflow10Git тармақтау, коммиттер, PR жұмыс үдерістері
security-audit10Қауіпсіздікті талдау және осалдықтарды анықтау

Бұлар әрі пайдалы әдепкі параметрлер, әрі өз дағдыларыңызды жасауға арналған эталондық үлгілер қызметін атқарады.

Анықтама

Proto файлдары

Proto файлдары proto/apps/v0/ ішінде орналасқан. SDK-лар алдын ала генерацияланған кодпен келеді, сондықтан әдеттегі әзірлеу үшін protoc қажет емес.

ФайлҚызметНегізгі RPC-лер
v0/common.proto(тек хабарлар)HealthCheckRequest/Response, SettingsMap, UserContext, Empty
v0/tool.protoToolServiceName, Description, Schema, Execute, RequiresApproval, Configure
v0/channel.protoChannelServiceID, Connect, Disconnect, Send, Receive (stream), Configure
v0/comm.protoCommServiceName, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure
v0/gateway.protoGatewayServiceHealthCheck, Stream (stream), Poll, Cancel, Configure
v0/ui.protoUIServiceHealthCheck, HandleRequest, Configure
v0/schedule.protoScheduleServiceHealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (stream), Configure

Әр қызметте HealthCheck және Configure RPC-лері бар. SDK екеуін де автоматты түрде өңдейді.

Арна proto түрлері

Хабар түріСипаттама
ChannelSendRequestmessage_id, channelId, sender, text, attachments, reply_to, actions, platform_data өрістері бар шығыс хабар конверті
ChannelSendResponseТізбек құруға арналған платформа хабарының ID-і
InboundMessageБарлық ортақ өрістері + уақыт белгісі бар кіріс хабар конверті
MessageSenderБот сәйкестігі (name, role, botId) — брокер толықтырады
AttachmentФайл/сурет/аудио тіркемесі (type, url, filename, size)
MessageActionИнтерактивті түйме/пернетақта әрекеті (label, callback_id)

Бот сәйкестігі және рөлдері

Nebo боттарының үш өлшемді сәйкестік үлгісі бар:

  • creature — Бот кім (архетип): «Тапқыр стратег», «Ұқыпты зерттеуші»
  • role — Оның пайдаланушыға қатысы (қарым-қатынас): «Дос», «COO», «Тәлімгер»
  • vibe — Оның энергиясы (сөйлесу стилі): «Сабырлы, бірақ өз пікірі бар», «Жылы әрі қолдаушы»

Арна плагиніңіз шығыс хабар алғанда, sender өрісінде боттың name және role мәндері болады. Мұны платформаңызда көрсетілетін атауды пішімдеу үшін пайдаланыңыз. Рөл — лауазым емес, қарым-қатынасты сипаттайтын белгі. «Дос», «Ұл» және «Тәлімгер» — «COO» мен «DevLead» сияқты жарамды рөлдер.