NeboAI
NeboAI
Malite

Wuo ngwa maka Nebo

Nye AI gị ike pụrụ iche ọhụrụ. Ngwaọrụ, ọwa, ọnụ ụzọ, panel UI — ihe ọ bụla ị nwere ike iche n'echiche, e chịkọtara ka ọ bụrụ binary nke sistemụ ahụ.

Nchịkọta

Ihe Nebo bụ

Nebo bụ onye enyemaka AI nke onwe gị na kọmputa — onye ọrụ AI na-arụ ọrụ mgbe niile nke na-ejikwa ndụ dijitalụ gị. Chee echiche banyere Nebo dị ka i si eche banyere ekwentị smart: ikpo okwu dị ike nke na-agbanwe ihe n'ezie site na ngwa ya.

N'onwe ya, Nebo bụ onye ọrụ AI nwere ikike, nwere ncheta, nhazi oge, nlegharị webụ, njikwa faịlụ, na ohere shell. Mana ihe na-emeghe ike ya n'ezie bụ ngwa. Dị ka ike ekwentị smart si abịa site na gburugburu ngwa ya, ike Nebo na-abịa site na ngwa ndị na-agbasa ihe ọ nwere ike ime.

Ihe ngwa bụ

Ngwa Nebo bụ nkeji zuru onwe ha, e chịkọtara tupu oge, nwere ọrụ dị egwu. Ngwa ọ bụla na-enye Nebo ike pụrụ iche ọhụrụ — njikwa kalenda, nhazi email, nsochi ọrụ, akpaaka ụlọ, nyocha ego — ihe ọ bụla onye mmepe nwere ike iche n'echiche.

Ngwa na-enye ike dị egwu n'ụzọ dị nnọọ nchebe. Ngwa ọ bụla na-agba n'ime sandbox nwere ikike a na-ajụ na mbụ. Ọ nwere ike ịbanye naanị n'ihe manifest ya kwupụtara ma onye ọrụ ahụ kwado.

Ihe njikọ ahụ bụ mkparịta ụka 100%. Ndị ọrụ anaghị eji ngwa site na ihuenyo ma ọ bụ dashboard dị iche. Ha na-agwa Nebo okwu, Nebo na-ejikwa ngwaọrụ ngwa ahụ mezue ihe. "Gịnị dị na kalenda m echi?" — Nebo na-akpọ ngwa kalenda. "Mepụta nzukọ mụ na Sarah n'elekere 3 nke ehihie" — Nebo na-akpọ ngwa kalenda. Onye ọrụ ahụ anaghị ahapụ mkparịta ụka ahụ.

Ngwa nwere ike inye UI ntọala ma ọ bụrụ na ha chọrọ — panel nhazi na-emeghe na windo nchọgharị dị n'ime Nebo. Ebe a ka ndị ọrụ na-etinye igodo API, na-agbanye ma ọ bụ na-agbanyụ atụmatụ, ma na-ahazi ngwa ahụ. Usoro settings dị na manifest na-achịkwa UI ntọala (Nebo na-egosi fọm ahụ n'onwe ya), ma ọ bụ ngwa ahụ nwere ike inye UI pụrụ iche nke ya zuru ezu site n'ikike ui.

Ngwa na-anọchi ma na-agbasa ikike Nebo nwere n'ime ya. Nebo na-abịa nwere ngwaọrụ ikpo okwu ndị bụ isi (ohere kalenda dị na kọmputa, foto ihuenyo, wdg). Mgbe ị wụnyere ngwa kalenda, ọ na-anọchi ngwaọrụ kalenda dị n'ime ma bụrụ nke ka ukwuu — kọmputa + cloud + nchịkọta + nlele oge efu.

Iwu naanị binary e chịkọtara

Nebo na-amanye iwu siri ike nke naanị binary e chịkọtara. Ngwa niile ga-abụrịrị mmemme e chịkọtara maka sistemụ ahụ.

ỌnọdụAsụsụ
A na-akwadoGo (a na-atụ aro ya), Rust, C/C++, Zig
A jụrụPython, Node.js, Ruby, Java, .NET, script shell

Ihe kpatara ya:

  • Igbochi AI ịgbanwe onwe ya — Onye ọrụ AI nwere ohere shell nwere ike ịgbanwe omume script a na-atụgharị n'oge ọ na-agba. Binary e chịkọtara anaghị agbanwe mgbe a bịanyere ha aka.
  • Izi ezi nke mbịanye aka — Mbịanye aka Ed25519 na-ekpuchi byte binary niile. A pụghị ịgbanwe binary a bịanyere aka n'emebighị mbịanye aka ahụ.
  • Ịmanye sandbox — Nkwado ụdị binary (byte anwansi ELF/Mach-O/PE) bụ ọnụ ụzọ ngwa ngwa, a pụrụ ịtụkwasị obi.

Mmalite ngwa ngwa

Wụnye SDK

SDK gọọmentị na-elekọta nhazi sava gRPC niile, njikwa signal, na njikọ protocol. Ị na-emejuputa naanị interface handler.

Go (a na-atụ aro ya):

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

Rust (na-abịa n'oge na-adịghị anya):

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

C/C++ (na-abịa n'oge na-adịghị anya):

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

Nhazi ndekọ ngwa

Ngwa na-ebi na ndekọ nta apps/ nke ndekọ data Nebo gị:

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

Ndepụta nlele maka ngwa kacha nta

  1. Mepụta manifest.json nwere id, name, version, provides
  2. Dee TOOL.md na-akọwa otú onye ọrụ AI kwesịrị iji ngwaọrụ gị
  3. Wụnye SDK (go get github.com/neboloop/nebo-sdk-go)
  4. Mejuputa interface handler maka ikike gị (ToolHandler, ChannelHandler, wdg)
  5. Debanye handler ahụ ma kpọọ app.Run()
  6. Wuo binary nke sistemụ ahụ (go build -o binary .)
  7. Tinye binary + manifest.json + TOOL.md na ndekọ apps/<your-app-id>/
  8. Nebo na-achọpụta ya n'onwe ya ma malite ya

Nhazi

manifest.json

Ngwa ọ bụla chọrọ 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
        }
    ]
}

Mpaghara achọrọ:

MpagharaNkọwa
idNjirimara ngalaba azụ (dịka, com.mycompany.myapp)
nameAha mmadụ nwere ike ịgụ
versionEriri semver
providesOpekata mpe otu ikike (lee n'okpuru)

Mpaghara nhọrọ:

MpagharaNdabaraNkọwa
runtime"local""local" ma ọ bụ "remote"
protocol"grpc"Naanị "grpc" ka a na-akwado
permissions[]Ihe ngwa ahụ chọrọ ohere ịbanye
description""A na-egosi ya na UI
settings[]Ntọala a pụrụ ịhazi (a na-egosi ha na UI Ntọala)
oauth[]Ihe achọrọ n'aka onye na-enye OAuth (lee ngalaba OAuth n'okpuru)

Ikike

Kwupụta ihe ngwa gị na-enye:

IkikeỌrụ gRPCNkọwa
gatewayGatewayServiceNzigharị ụdị LLM
tool:<name>ToolServiceNgwaọrụ nwere aha maka onye ọrụ AI
channel:<name>ChannelServiceỌwa ozi
commCommServiceNkwurịta okwu n'etiti ndị ọrụ AI
uiUIServiceUI pụrụ iche nwere proxy HTTP
scheduleScheduleServiceNhazi oge pụrụ iche
visionToolServiceNhazi ọhụụ
browserToolServiceAkpaaka nchọgharị

Ngwa nwere ike inye ọtụtụ ikike. Dịka ọmụmaatụ, ngwa nwere ike inye ma ngwaọrụ ma panel UI.

Ikike

Ikike na-achịkwa ihe ngwa ahụ nwere ike ịbanye. A na-ajụ na mbụ — ọ bụrụ na e kwupụtaghị ya, ngwa ahụ enweghị ike iji ya.

MbidoIhe atụNkọwa
network:network:outbound, network:*Ohere netwọk
filesystem:filesystem:read, filesystem:writeOhere sistemụ faịlụ
memory:memory:read, memory:writeOhere ncheta onye ọrụ AI
session:session:readOge mkparịta ụka
tool:tool:shell, tool:fileJiri ngwaọrụ ndị ọzọ
shell:shell:execỊgba iwu shell
channel:channel:send, channel:*Omume ọwa
comm:comm:send, comm:*Nkwurịta okwu n'etiti ndị ọrụ AI
model:model:chatOhere ụdị AI
user:user:tokenNata JWT onye ọrụ n'arịrịọ
schedule:schedule:createNjikwa ọrụ cron
database:database:queryOhere nchekwa data
storage:storage:read, storage:writeNchekwa na-adịgide adịgide
context:context:readOhere ọnọdụ onye ọrụ AI
subagent:subagent:spawnOmume sub-agent
lane:lane:enqueueOmume lane
notification:notification:sendỌkwa push
embedding:embedding:searchOhere vector embedding
skill:skill:invokeỊkpọ nka
advisor:advisor:consultOhere sistemụ onye ndụmọdụ
mcp:mcp:connectOhere sava MCP
voice:voice:recordOhere olu/ụda
browser:browser:navigateAkpaaka nchọgharị
oauth:oauth:google, oauth:*Ohere token OAuth
settings:settings:readOhere ntọala
capability:capability:registerNdebanye ikike

A na-akwado ikike wildcard: network:* dabara na nlele ikike network: ọ bụla.

Ntọala

Ntọala na-apụta na UI Nebo n'okpuru panel ntọala ngwa ahụ. Nebo na-echekwa ha na nchekwa data ma zigara ha ngwa gị site na RPC Configure mgbe ha gbanwere.

E tinyere atụmatụ ntọala gị na ndepụta ụlọ ahịa ngwa NeboAI. Ngwa nwere ntọala achọrọ a na-ahazibeghị na-egosi akara "Needs Setup" na UI.

ỤdịNkọwa
textNtinye ederede otu ahịrị
passwordNtinye ederede e zoro ezo
toggleMgbanwe gbanye/gbanyụọ
selectNdepụta na-agbada nwere nhọrọ a kara aka
numberNtinye nọmba
urlNtinye URL nwere nkwado
{
    "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"}
    ]
}

Ihe achọrọ maka OAuth

Ngwa nwere ike ikwupụta ihe ha chọrọ n'aka onye na-enye OAuth. Onye ogbugbo OAuth nke Nebo na-elekọta usoro ahụ niile — ngwa na-anata token n'onwe ha site na RPC Configure.

{
    "oauth": [
        {
            "provider": "google",
            "scopes": ["https://www.googleapis.com/auth/calendar"]
        }
    ]
}
MpagharaNkọwa
providerOnye na-enye OAuth: "google", "microsoft", "github"
scopesUsoro scope OAuth ngwa ahụ chọrọ

Mgbe onye ọrụ wụnyere ngwa ahụ, Nebo na-arịọ ya ka o nye ikike maka scope OAuth achọrọ. Ngwa ahụ na-anata token emelitere site na RPC Configure n'enweghị ilekọta usoro OAuth n'onwe ya.

Mgbanwe gburugburu

Usoro ngwa gị na-anata gburugburu a sachara ọcha. A na-ewepụ ihe nzuzo niile. Ị na-enweta:

MgbanweUru
NEBO_APP_DIRNdekọ nwụnye ngwa
NEBO_APP_SOCKỤzọ gaa na socket Unix a ga-emepụta
NEBO_APP_IDID ngwa site na manifest
NEBO_APP_NAMEAha ngwa site na manifest
NEBO_APP_VERSIONỤdị ngwa site na manifest
NEBO_APP_DATAỤzọ gaa na ndekọ data/ nke ngwa
PATHPATH sistemụ (a na-agafe ya)
HOMENdekọ ụlọ onye ọrụ (a na-agafe ya)
TMPDIRNdekọ nwa oge (a na-agafe ya)

Dị oke mkpa: Binary gị ga-emepụta sava gRPC na-ege ntị na socket Unix dị na NEBO_APP_SOCK. Nebo na-eche ruo sekọnd 10 ka socket a pụta.

Usoro mmalite ngwa

  1. Nebo na-agụ manifest.json ma kwado ya
  2. Na-achọta mmemme binary ma ọ bụ app na ndekọ ngwa
  3. Na-elele akara .quarantined (ọ naghị amalite ngwa e kewapụrụ)
  4. Nlele nkagbu (naanị ngwa NeboAI kesara)
  5. Nkwenye mbịanye aka (naanị ngwa NeboAI kesara, a na-agafe ya n'ọnọdụ dev)
  6. Nkwado binary (na-ajụ symlink, script, ihe na-abụghị mmemme, faịlụ buru oke ibu)
  7. Na-ehicha socket ochie site n'ọgba gara aga
  8. Na-emepụta ndekọ data/ maka nchekwa sandbox
  9. Na-ahazi faịlụ log kwa ngwa (logs/stdout.log, logs/stderr.log)
  10. Na-amalite binary na gburugburu a sachara ọcha na nkewa otu usoro
  11. Na-eche ka socket Unix pụta (nchere na-amụba, kacha sekọnd 10)
  12. Na-ejikọ site na gRPC n'elu socket Unix
  13. Na-emepụta onye ahịa gRPC kwa ikike dabere na provides
  14. Na-agba nlele ahụ ike
  15. Na-edebanye ikike na onye ọrụ AI (ngwaọrụ, ọnụ ụzọ, comm, wdg)

Ngwa ngwaọrụ

Kwupụta "provides": ["tool:my_tool_name"] na manifest gị.

Usoro STRAP

Ngwa ngwaọrụ Nebo niile ga-eji STRAP (Single Tool Resource Action Pattern) maka atụmatụ ha na nzigharị mmezu. Nke a bụ otu usoro Nebo na-eji n'ime iji chịkọta ihe karịrị ngwaọrụ 35 n'otu n'otu ka ha bụrụ ngwaọrụ ngalaba 4 — na-ebelata ibu ọnọdụ LLM ihe dị ka 80%.

Echiche bụ isi: Kama ịdebanye ọtụtụ ngwaọrụ (get_events, check_availability, suggest_slots), debanye OTU ngwaọrụ nwere mpaghara action (na resource ma ọ bụrụ na ịchọrọ) na-ezigara handler ziri ezi.

Ihe atụ otu resource (kalenda):

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

Ihe atụ ọtụtụ resource (onye njikwa ọrụ):

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

Iwu atụmatụ:

  1. Tinye mpaghara action mgbe niile dị ka string enum achọrọ
  2. Gbakwunye mpaghara resource (string enum achọrọ) naanị ma ọ bụrụ na ngwaọrụ gị na-ejikwa ọtụtụ ụdị resource dị iche iche
  3. Mpaghara ndị ọzọ niile bụ paramita kwa action
  4. Nkọwa enum action kwesịrị idepụta action niile dị

Gịnị mere STRAP ji dị mkpa:

  • LLM na-amụta usoro nzigharị action otu ugboro ma tinye ya n'omume niile
  • Nkọwa ngwaọrụ na-eri ihe dị ka 6% nke ọnọdụ — STRAP na-ebelata ya 80%
  • Omume ọhụrụ bụ naanị mgbakwunye enum, ọ bụghị ndebanye ngwaọrụ ọhụrụ
  • Ọ na-arụ ọrụ otu ụzọ ahụ n'ụdị a na-edebe n'ịntanetị na ndị dị na kọmputa

Ihe atụ Go — Ngwaọrụ mgbako

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

Wuo ma wụnye:

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/

Ihe atụ 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(())
}

Ihe atụ 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;
}

Ngwa ọwa

Kwupụta "provides": ["channel:my_channel"] na "permissions": ["channel:send"].

Ngwa ọwa na-ejikọ ikpo okwu ozi dị n'èzí (Telegram, Discord, Slack, wdg) na onye ọrụ AI nke Nebo. Mgbe onye ọrụ zigara ozi n'ikpo okwu dị n'èzí, ngwa gị na-ezigara Nebo ya site na Receive. Mgbe onye ọrụ AI chọrọ ịza, Nebo na-akpọ Send nke ngwa gị.

Otú o si arụ ọrụ

  1. Nebo na-akpọ ID() iji nweta njirimara pụrụ iche nke ọwa gị
  2. Nebo na-akpọ Connect() na nhazi sitere na ntọala ngwa gị
  3. Nebo na-emeghe iyi Receive() — ngwa gị na-eziga ozi na-abata mgbe ọ bụla onye ọrụ ziteere bot ozi
  4. A na-ezigara ozi na-abata n'ụzọ mkparịta ụka bụ isi nke onye ọrụ AI
  5. Mgbe onye ọrụ AI chọrọ iziga ozi, Nebo na-akpọ Send() na envelopu ozi v1
  6. Mgbe a na-emechi, Nebo na-akpọ Disconnect()

Envelopu ozi v1

Ozi ọwa niile — ndị na-abata na ndị na-apụ — na-eji envelopu ozi a na-ekekọrịta:

{
  "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"
}
MpagharaỤdịNkọwa
message_idUUID v7ID pụrụ iche a haziri site n'oge
channel_id{type}:{platform_id}Njirimara ọwa a pụrụ izigharị
senderobjectNjirimara bot — aha, ọrụ, botId
textstringAhụ ozi
attachmentsarrayFaịlụ, foto, ụda
reply_toUUID v7ID ozi nne maka threading
actionsarrayBọtịnụ/kibọọdụ mmekọrịta
platform_databytesNgafe na-adịghị ahụ anya maka atụmatụ kpọmkwem ikpo okwu
timestampISO 8601Onye mbipụta na-esetịpụ nke a

Imewe ọkwa abụọ: Mpaghara a na-ekekọrịta (text, attachments, reply_to, actions) na-ekpuchi 90% nke ozi onye ọrụ na-amalite. Atụmatụ kpọmkwem ikpo okwu na-aga na platform_data — plugin gị na-atụgharị ha gaa/site n'ụdị ikpo okwu ahụ.

Iyi mkparịta ụka

A na-ezigharị ozi ọwa n'iyi mkparịta ụka kwa ọwa maka nkewa:

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

Ihe atụ Go — Ọwa 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
        }
    ]
}

Ikike ndị ọzọ

Ngwa Comm

Kwupụta "provides": ["comm"] na "permissions": ["comm:*"]. Ngwa Comm na-eme ka nkwurịta okwu n'etiti ndị ọrụ AI kwe omume.

MpagharaNkọwa
fromID onye ọrụ na-eziga
toID onye ọrụ na-anata
topicIsiokwu/ọwa ozi
type"message", "mention", "proposal", "command", "info", "task"
contentAhụ ozi

Omume ndị bụ isi:

  • Register na-ama ọkwa onye ọrụ AI a na netwọk ya na ikike ya
  • Subscribe/Unsubscribe na-ejikwa ndenye aha isiokwu
  • Receive na-ezipụ ozi na-abata (server-streaming, dị ka ọwa)
  • Naanị otu ngwa comm nwere ike ịrụ ọrụ n'otu oge

Ngwa ọnụ ụzọ

Ngwa ọnụ ụzọ na-ezigara ụdị arịrịọ LLM. Kwupụta "provides": ["gateway"] na "permissions": ["network:outbound", "user:token"].

GatewayRequest nwere ozi, ngwaọrụ, ntụziaka sistemụ, token kacha, temperature, na UserContext (token JWT ma ọ bụrụ na e nyere ikike user:token).

Ụdị GatewayEvent:

ỤdịỌdịnayaNkọwa
"text"Iberibe ederedeToken ederede na-asọ asọ
"tool_call"JSONỤdị ahụ chọrọ ịkpọ ngwaọrụ
"thinking"Iberibe ederedeEchiche/ntụgharị uche agbatịrị
"error"Ozi njehieIhe mebiri
"done"EfuIyi ahụ agwụla

Ngwa UI

Ngwa UI na-enye interface nhazi pụrụ iche na-emeghe na windo nchọgharị dị n'ime Nebo. Kwupụta "provides": ["ui"]. N'adịghị ka fọm ntọala akpaghị aka (nke Nebo na-egosi site na manifest settings gị), ngwa UI na-enye frontend HTML/CSS/JS nke ya zuru ezu.

Ngwa gị na-abịa na ndekọ ui/ nwere akụ webụ na-adịghị agbanwe (HTML, CSS, JS — na-abụkarị SPA nwere index.html). Nebo na-enye faịlụ ndị a ozugbo ma na-ebuga oku API na ngwa gị site na gRPC.

ỤzọUsoroEbumnuche
GET /api/v1/apps/{id}/ui/*Sava faịlụ na-adịghị agbanweNa-enye faịlụ site na ndekọ ui/ gị (nlọghachi SPA gaa na index.html)
ANY /api/v1/apps/{id}/api/*Proxy gRPCNa-ebuga arịrịọ HTTP na UIService.HandleRequest() nke ngwa gị

SDK na-ekpuchi net/http.ServeMux nkịtị ka i dee handler HTTP Go nkịtị — SDK na-elekọta njikọ gRPC n'onwe ya.

Ihe atụ Go — UI Dashboard:

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 gị ga-eme oku fetch na /api/v1/apps/com.example.dashboard/api/status, nke a na-ebuga na handler mux gị.

Ngwa nhazi oge

Ngwa nhazi oge na-anọchi onye nhazi cron dị n'ime Nebo. Kwupụta "provides": ["schedule"] na "permissions": ["schedule:create"].

Mgbe ngwa nhazi oge gị malitere, Nebo na-ezigara ngwa gị nhazi oge niile kama injin cron ndabara. Ọ bụrụ na ngwa gị dara, Nebo na-alaghachi n'injin dị n'ime ya n'onwe ya.

  • Ngwa gị na-enwe ọnọdụ nhazi oge — Nebo anaghị echekwa nhazi oge na DB nke ya mgbe ngwa nhazi oge na-arụ ọrụ
  • CRUD nkịtị: Create, Get, List, Update, Delete, Enable, Disable
  • Triggers bụ RPC server-streaming — ngwa gị na-eziga ozi trigger mgbe ọ bụla nhazi oge gbara
  • Naanị otu ngwa nhazi oge nwere ike ịrụ ọrụ n'otu oge

Ngwa nwere ọtụtụ ikike

Ngwa nwere ike inye ọtụtụ ikike. Dịka ọmụmaatụ, ngwa dashboard nwere ma ngwaọrụ ma UI:

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

Ngwugwu

Ụdị .napp

Maka nkesa site na NeboAI, kechie ngwa gị dị ka faịlụ .napp (ebe nchekwa tar.gz):

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

Faịlụ achọrọ:

FaịlụNha kachaNkọwa
manifest.json1 MBMetadata ngwa
binary ma ọ bụ app500 MBMmemme
signatures.json1 MBMbịanye aka Ed25519
TOOL.md1 MBNtụziaka ngwaọrụ maka onye ọrụ AI

Iwu nchekwa n'oge mwepụta:

  • Enweghị ngafe ụzọ (a na-ajụ ../)
  • Enweghị symlink (a na-ajụ ya)
  • Enweghị ụzọ zuru oke (a na-ajụ ya)
  • Naanị aha faịlụ dị na ndepụta e kwere ka a na-anabata

Mbịanye aka

NeboAI na-eji Ed25519 bịanye aka na ngwa. Ụdị 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>"
}

N'ọnọdụ dev (e hazighị URL NeboAI), a na-agafe nkwenye mbịanye aka kpamkpam. Ị chọghị signatures.json maka mmepe na kọmputa gị.

Mbipụta

Ozugbo ngwa gị rụrụ ọrụ na kọmputa gị, bipụta ya site na NeboAI maka nkesa nye ndị ọrụ Nebo niile.

Nhazi akaụntụ onye mmepe

  1. Debanye akaụntụ NeboAI na POST /api/v1/owners/register
  2. Banye iji nweta token JWT: POST /api/v1/owners/login
  3. Mepụta akaụntụ onye mmepe: POST /api/v1/developer/accounts

Usoro nzipu

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

Nzọụkwụ 1: Mepụta ngwa ahụ

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

Nzọụkwụ 2: Bulite binary ikpo okwu

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"

Bulite otu binary kwa ikpo okwu: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.

Nzọụkwụ 3: Zipu maka nyocha

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

Usoro nyocha

  1. Nnyocha akpaghị aka — a na-enyocha binary site na VirusTotal
  2. Nyocha onye nchịkwa — otu NeboAI na-enyocha metadata, manifest, na nsonaazụ nnyocha
  3. Mgbe a kwadoro ya — NeboAI na-eji Ed25519 bịanye aka na ngwa ahụ ma bipụta ya
  4. Mgbe a jụrụ ya — ị na-anata ihe kpatara ya ma nwee ike idozi ma zipu ọzọ

Oge nyocha a na-achọ: <24 awa.

Iziga mmelite

  1. Melite ụdị ngwa ahụ: PUT /api/v1/developer/apps/{id} ya na ụdị ọhụrụ ahụ
  2. Bulite binary ọhụrụ maka ikpo okwu ọ bụla
  3. Zipu maka nyocha ọzọ

Mmelite ọ bụla na-agafe otu usoro nyocha ahụ. Ụdị ndị gara aga ka dị ruo mgbe a kwadoro ụdị ọhụrụ ahụ.

Metadata ụlọ ahịa

MpagharaNkọwa
categorydịka, productivity, communication, developer-tools
iconURL akara ngosi ngwa
visibilitypublic ma ọ bụ private
descriptionỌ nwere ike ịdị ogologo/baa ụba karịa nkọwa manifest

Usoro ọrụ dev

Mmepe na kọmputa gị

Achọghị ngwugwu maka mmepe na kọmputa gị:

  1. Mepụta folda ngwa gị:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. Dee manifest.json na koodu gị
  3. Wuo binary gị:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. Nebo na-achọpụta ndekọ ọhụrụ ahụ n'onwe ya (ma ọ bụ malitegharịa Nebo)
  5. Mgbe ị gbanwere koodu, wughachi binary ahụ — onye na-ele faịlụ anya ga-amalitegharị ngwa ahụ

Ile log anya

A na-ejide stdout/stderr ngwa na faịlụ log kwa ngwa:

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 na-adịgide adịgide

Jiri ndekọ data/ (dịkwa dị ka mgbanwe gburugburu NEBO_APP_DATA) maka faịlụ ọ bụla ngwa gị chọrọ idobe. Ndekọ a na-adịgide mgbe e melitere ngwa na mgbe e kewapụrụ ya.

Ndụmọdụ maka ịchọpụta nsogbu

  • Ọ bụrụ na ngwa gị amaliteghị, lelee logs/stderr.log maka njehie
  • Jide n'aka na binary ahụ nwere ike ịgba (chmod +x binary)
  • Jide n'aka na ị na-ege ntị n'ụzọ socket Unix sitere na NEBO_APP_SOCK
  • Socket ahụ ga-adị njikere n'ime sekọnd 10 ka mmalite gasịrị
  • Jiri NEBO_APP_DATA maka nchekwa, ọ bụghị ụzọ e debere n'ime koodu
  • Bipụta na stderr maka log nchọpụta nsogbu (a na-ejide ya na logs/stderr.log)

Nkwenye

# 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

Iwepụ nwụnye

nebo apps uninstall com.example.myapp

Nka

Ihe nka bụ

Nka bụ ntụziaka na-akpụzi otú Nebo si eme omume n'oge mkparịta ụka. Mgbe nka na-arụ ọrụ, a na-etinye ọdịnaya ya ozugbo n'ime ntụziaka sistemụ — na-eduzi ụda olu onye ọrụ AI, usoro ya, nka ọkachamara ya, na otú o si eji ngwaọrụ n'oge ahụ.

Nka abụghị koodu. Ha bụ akwụkwọ markdown nwere metadata YAML. Enweghị nchịkọta, enweghị binary, enweghị gRPC. Nka bụ faịlụ SKILL.md n'ime ndekọ. Nke ahụ bụ ya.

Nka dabere n'ọnọdụ ma bụrụ nwa oge. Ha na-arụ ọrụ mgbe ha dị mkpa (site na trigger dabara ma ọ bụ ibudata n'aka), na-adịgide ntụgharị ole na ole, ma na-agwụ mgbe achọkwaghị ha. Nke a na-eme ka ọnọdụ onye ọrụ AI ghara ibu ibu — naanị nduzi dị mkpa ugbu a dị na ntụziaka ahụ.

Nka na-emeju ngwa. Ngwa na-enye ikike a pụrụ ịgba (ngwaọrụ, ọwa, ọnụ ụzọ). Nka na-enye nduzi nhazi — otú e si eji ngwaọrụ ndị ahụ nke ọma. Ngwa kalenda na-enye Nebo ike ịgụ na ide ihe omume. Nka "nkwadebe nzukọ" na-agwa Nebo otú ọ ga-esi kwadebe maka nzukọ site n'iji ngwa kalenda ahụ, email, na ọchụchọ webụ ọnụ.

Nka ma ọ bụ ngwa

NkaNgwa
ỤdịMarkdown (SKILL.md)Binary e chịkọtara (.napp)
Oge ọ na-agbaA na-etinye ya na ntụziaka sistemụUsoro sandbox n'elu gRPC
Na-enyeNduzi omume, usoroNgwaọrụ, ọwa, panel UI
Ogologo ndụỌ dị n'oge mkparịta ụka, ọ na-agwụ dabere na TTLNa-agba mgbe niile
ImepụtaDee faịlụ markdownDee, chịkọta, bịanye aka, kechie
NchekwaAchọghị ikikeSandbox a na-ajụ na mbụ

Mmalite ngwa ngwa

Mepụta ndekọ na folda nka Nebo gị nwere faịlụ SKILL.md:

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

Dee 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 na-eji fsnotify ele ndekọ nka anya. Nka gị dị ozugbo — achọghị ịmalitegharị. Kwuo ihe dabara na trigger, ọ ga-arụ ọrụ n'onwe ya.

Ma ọ bụ jụọ Nebo ozugbo: "Mepụta nka maka ide edemede blọọgụ" — Nebo ga-edere gị faịlụ SKILL.md ahụ.

Ụdị SKILL.md

Nka ọ bụla bụ otu faịlụ SKILL.md nwere akụkụ abụọ: frontmatter YAML n'etiti akara ---, na ahụ markdown (ezigbo ntụziaka a na-etinye na ntụziaka sistemụ).

MpagharaAchọrọNdabaraNkọwa
nameEe—Njirimara pụrụ iche (ọ na-aghọ slug)
descriptionEe—Nkọwa otu ahịrị a na-egosi na katalọgụ nka
versionMba"1.0.0"Semver maka nsochi mmelite
authorMba—Onye dere nka
priorityMba0Ka elu = a na-ebu ụzọ dabara ya (100+ maka nnọchi dị oke mkpa)
max_turnsMba4Ntụgharị enweghị ọrụ tupu ọ gwụ n'onwe ya
triggersMba[]Nkebiokwu na-eme ka nka a rụọ ọrụ n'onwe ya (ndakọrịta akụkụ eriri, mkpụrụedemede ukwu na nta adịghị iche)
toolsMba[]Ngwaọrụ nka a na-atụ anya iji (maka ozi)
dependenciesMba[]Nka ndị ọzọ a ga-awụnyerịrị
tagsMba[]Maka nkewa na nchọpụta
platformMba[]Ikpo okwu a na-akwado: macos, linux, windows (efu = ha niile)

Otú nka si amalite ọrụ

Nka na-agbaso usoro mmalite nwere akụkụ abụọ: ntụaka, mgbe ahụ ịkpọ.

Akụkụ 1: Ndakọrịta trigger — Oge ọ bụla onye ọrụ zigara ozi, Nebo na-enyocha nka niile e debanyere aha maka trigger dabara. Nka dabara na-apụta dị ka ntụaka na ntụziaka sistemụ. Onye ọrụ AI na-ahụ ntụaka ahụ ma kpebie ma ọ ga-akpọ nka ahụ.

Akụkụ 2: Ịkpọ — Onye ọrụ AI na-akpọ nka site n'ịkpọ:

skill(name: "code-review")

Nke a na-eweghachi ndebiri SKILL.md zuru ezu dị ka nsonaazụ ngwaọrụ, na-edekọ ịkpọ ahụ, ma na-etinyeghachi ndebiri ahụ na ntụziaka sistemụ na ntụgharị ndị na-esote.

TTL na ngwụcha:

  • Nka dabara n'onwe ha: ntụgharị 4 enweghị ọrụ (a pụrụ ịhazi ya site na max_turns)
  • Nka e budatara n'aka: ntụgharị 6 enweghị ọrụ
  • Ịkpọghachi na-ahazigharị oge ahụ
  • Oke siri ike: kacha nka 4 na-arụ ọrụ kwa oge mkparịta ụka
  • Mmefu token: ọdịnaya nka niile na-arụ ọrụ jikọtara ọnụ nwere oke mkpụrụedemede 16,000

Ijikwa nka

Onye ọrụ AI nwere ike ijikwa nka site na ngwaọrụ skill:

OmumeNkọwaIhe atụ
catalogDepụta nka niile dịskill(action: "catalog")
loadMee ka ọ rụọ ọrụ maka oge mkparịta ụka askill(name: "code-review", action: "load")
unloadKwụsị nkaskill(name: "code-review", action: "unload")
createMepụta nka ọhụrụ na diskiskill(action: "create", content: "...")
updateMelite nka dị adịskill(name: "my-skill", action: "update", content: "...")
deleteHichapụ nka na diskiskill(name: "my-skill", action: "delete")

Ide ezigbo nka

Ezigbo ndebiri nka nwere:

  1. Isiokwu doro anya — na-agwa onye ọrụ AI ọnọdụ ọ nọ na ya
  2. Ụkpụrụ ndị bụ isi — iwu omume a na-agaghị ịgbanwe
  3. Usoro — ụzọ nzọụkwụ na nzọụkwụ maka ọnọdụ ndị a na-ahụkarị
  4. Ihe atụ — usoro doro anya site n'ozi onye ọrụ ruo azịza
  5. Ihe a na-ekwesịghị ime — ihe A NA-EKWESỊGHỊ ime (ụdị AI na-amụta nke ọma site n'ihe atụ ọjọọ)

Ndụmọdụ: Nka ọ bụla kwesịrị ime otu ihe nke ọma. Emepụtala nka "mmemme n'ozuzu" — mepụta code-review, debugging, api-design dị ka nka dị iche iche. Onye ọrụ AI nwere ike inwe ọtụtụ na-arụ ọrụ n'otu oge.

Nka e jikọtara

Nebo na-abịa nwere nka e jikọtara na-ekpuchi ojiji ndị a na-ahụkarị:

NkaMkpaNkọwa
onboarding100Ekele onye ọrụ ọhụrụ na nchịkọta profaịlụ
best-friend50Nka àgwà — dị nwayọọ, kwesịrị ntụkwasị obi, okwu eziokwu
debugging25Usoro nchọpụta nsogbu a haziri ahazi
api-design15Omume kacha mma maka imewe RESTful API
code-review10Nyocha koodu a haziri ahazi nwere ọkwa njọ
database-expert10Imewe nchekwa data, ajụjụ, nkwalite
git-workflow10Alaka Git, commit, usoro ọrụ PR
security-audit10Nyocha nchekwa na nchọpụta adịghị ike

Ndị a na-arụ ọrụ dị ka ndabara bara uru na ihe atụ ntụaka maka ịmepụta nka nke gị.

Ntụaka

Faịlụ Proto

Faịlụ Proto na-ebi na proto/apps/v0/. SDK na-abịa nwere koodu e mepụtara tupu oge, ya mere ị chọghị protoc maka mmepe nkịtị.

FaịlụỌrụRPC ndị bụ isi
v0/common.proto(naanị ozi)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

Ọrụ ọ bụla gụnyere RPC HealthCheck na Configure. SDK na-elekọta ha abụọ n'onwe ya.

Ụdị Proto ọwa

Ụdị oziNkọwa
ChannelSendRequestEnvelopu ozi na-apụ nwere message_id, channelId, sender, text, attachments, reply_to, actions, platform_data
ChannelSendResponseID ozi ikpo okwu maka threading
InboundMessageEnvelopu ozi na-abata nwere mpaghara niile a na-ekekọrịta + timestamp
MessageSenderNjirimara bot (name, role, botId) — onye ogbugbo na-emeju ya
AttachmentIhe mgbakwunye faịlụ/foto/ụda (type, url, filename, size)
MessageActionOmume bọtịnụ/kibọọdụ mmekọrịta (label, callback_id)

Njirimara bot na ọrụ

Bot Nebo nwere usoro njirimara nwere akụkụ atọ:

  • creature — Ihe bot ahụ bụ (ụdị): "Onye atụmatụ nwere uche ngwa ngwa", "Onye nyocha na-akpachapụ anya"
  • role — Otú o si metụta onye ọrụ (mmekọrịta): "Enyi", "COO", "Onye ndụmọdụ"
  • vibe — Ike ya (ụzọ nkwurịta okwu): "Dị jụụ mana nwere echiche", "Dị ọkụ n'obi ma na-agba ume"

Mgbe plugin ọwa gị natara ozi na-apụ, mpaghara sender nwere name na role nke bot ahụ. Jiri nke a hazie aha ngosi maka ikpo okwu gị. Ọrụ ahụ abụghị aha ọkwa ọrụ — ọ bụ nkọwa mmekọrịta. "Enyi", "Nwa nwoke", na "Onye ndụmọdụ" bụ ọrụ ziri ezi tinyere "COO" na "DevLead".