NeboAI
NeboAI
Eñepyrũ

Emopu'ã Aplicación Nebo-pe g̃uarã

Eme'ẽ nde IA-pe pu'aka guasu pyahu. Tembiporu, canal, gateway, panel UI — oimeraẽ mba'e ikatúva reimo'ã, oñembohasáva peteĩ binario nativo-pe.

Ñemombe'u mbykymi

Mba'épa Nebo

Nebo ha'e peteĩ pytyvõhára IA nde escritorio-pegua — peteĩ mba'apohára IA omba'apóva akóinte oñangarekóva nde rekove digital rehe. Epensa Nebo rehe rehechaháicha peteĩ smartphone: peteĩ plataforma imbaretéva omoambuepáva hekove iaplicación-kuéra rupive.

Ijehegui, Nebo ha'e peteĩ mba'apohára IA ikatupyrýva oguerekóva mandu'a, horario ñemohenda, web jeheka, archivo ñeñangareko ha shell jeike. Ha katu pe mba'e tuichavéva ha'e umi Aplicación. Peteĩ smartphone ipu'aka ou haguéicha iecosistema aplicación-gui, Nebo ipu'aka ou umi aplicación ombotuichavéva ikatúvagui ojapo.

Mba'épa umi Aplicación

Nebo Aplicación-kuéra ha'e pehẽ ijeheguíva ha oñembohasa raẽva binario-pe, oguerekóva katupyry hechapyrãva. Peteĩteĩ aplicación ome'ẽ Nebo-pe pu'aka guasu pyahu — calendario ñeñangareko, correo jeporavo, proyecto ñeñangareko, óga automatización, viru jehesa'ỹijo — oimeraẽ mba'e peteĩ programador ikatúva oimo'ã.

Umi aplicación ome'ẽ pu'aka hechapyrãva tekorosã guasúpe. Opaite aplicación omba'apo peteĩ sandbox-pe permiso ojeporu'ỹva ijypýpe. Ikatu oike umi imanifiesto he'ívape ha pe ojeporúva omoneĩvape añoite.

Interfaz ha'e 100% ñomongeta. Umi ojeporúva ndoikói aplicación-kuérape pantalla térã panel ojeipe'áva rupive. Oñe'ẽ Nebo ndive, ha Nebo oipuru aplicación tembiporu ojapo hag̃ua tembiapo. "Mba'épa oĩ che calendario-pe ko'ẽrõ?" — Nebo ohenói calendario aplicación. "Emoĩ peteĩ ñembyaty Sarah ndive 3pm-pe" — Nebo ohenói calendario aplicación. Pe ojeporúva araka'eve nosẽi ñomongetágui.

Umi aplicación ikatu ome'ẽ, ipotárõ, peteĩ ñemboheko UI — peteĩ panel ñembohekopegua ojepe'áva Nebo ventana navegador ijypyguápe. Upépe umi ojeporúva omoĩ API llave, omyendy térã omboguejy mba'e, ha ombohekopy aplicación. Ñemboheko UI oñemboguata manifiesto array settings rupive (Nebo ohechauka formulario ijeheguiete), térã aplicación ikatu ome'ẽ iUI hekoitéva ae katupyry ui rupive.

Umi aplicación omyengovia ha ombotuichave Nebo katupyry ijypyguáva. Nebo ou tembiporu plataforma ijypyguáva reheve (calendario local jeike, captura de pantalla, ha ambue). Remoĩ jave peteĩ calendario aplicación, omyengovia tembiporu calendario ijypyguáva ha oiko hetavéva — local + nube + ñembyaty + ára sãso jehecha.

Compilado-nte Ñembohape

Nebo omomba'e peteĩ ñembohape binario compilado-nte rehegua imbaretéva. Opaite aplicación ha'eva'erã ejecutable nativo compilado.

Mba'éichapa oĩÑe'ẽ-kuéra
OjeguerohorývaGo (oñemoñe'ẽvéva), Rust, C/C++, Zig
OñemboykévaPython, Node.js, Ruby, Java, .NET, shell script

Mba'érepa:

  • Ojejoko IA ojemoambue ijehegui — Peteĩ mba'apohára IA oguerekóva shell jeike ikatu omoambue peteĩ script interpretado reko omba'apo aja. Umi binario compilado ndojemoambuéi oñemboheragua'i rire.
  • Firma tekoitépe — Firma Ed25519 ojaho'i binario byte-kuéra. Peteĩ binario oñemboheragua'íva ndaikatúi oñemoambue omboyke'ỹre firma.
  • Sandbox ñemomba'e — Binario formato jehesa'ỹijo (ELF/Mach-O/PE magic bytes) ha'e peteĩ okẽ pya'e ha jeroviaha.

Ñepyrũ Pya'e

Emoĩ SDK

SDK oficial ojapo opaite servidor gRPC ñemboheko, señal ñeñangareko ha protocolo ñembojoaju. Nde reimplementánte handler interfaz-kuéra.

Go (oñemoñe'ẽvéva):

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

Rust (oúta pya'e):

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

C/C++ (oúta pya'e):

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

Aplicación Directorio Ñemohenda

Umi aplicación oiko subdirectorio apps/-pe nde Nebo marandu directorio-pe:

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

Aplicación Michĩvéva Lísta

  1. Emopu'ã manifest.json id, name, version, provides reheve
  2. Ehai TOOL.md omombe'úva mba'éichapa mba'apohára IA oipurúva'erã nde tembiporu
  3. Emoĩ SDK (go get github.com/neboloop/nebo-sdk-go)
  4. Eimplementa handler interfaz nde katupyrýpe g̃uarã (ToolHandler, ChannelHandler, ha ambue)
  5. Eregistra handler ha ehenói app.Run()
  6. Emopu'ã peteĩ binario nativo (go build -o binary .)
  7. Emoĩ binario + manifest.json + TOOL.md directorio apps/<your-app-id>/-pe
  8. Nebo ojuhu ha omoñepyrũ ijeheguiete

Ñemboheko

manifest.json

Opaite aplicación oikotevẽ peteĩ 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
        }
    ]
}

Campo tekotevẽva:

CampoÑemombe'u
idIdentificador dominio jere (techapyrã, com.mycompany.myapp)
nameTéra tapicha ikatúva omoñe'ẽ
versionSemver jehaipy
providesSa'ive peteĩ katupyry (ehecha iguýpe)

Campo ndaha'éiva tekotevẽ:

CampoIjypyguávaÑemombe'u
runtime"local""local" térã "remote"
protocol"grpc""grpc" añoite ojeguerohory
permissions[]Mba'épe aplicación oikotevẽ oike
description""Ojehechauka UI-pe
settings[]Ñemboheko ikatúva oñemoambue (ojehechauka Ñemboheko UI-pe)
oauth[]OAuth proveedor tekotevẽ (ehecha OAuth pehẽ iguýpe)

Katupyry

Emombe'u mba'épa nde aplicación ome'ẽ:

KatupyrygRPC ServicioÑemombe'u
gatewayGatewayServiceLLM modelo ñembohape
tool:<name>ToolServicePeteĩ tembiporu héra reheve mba'apohára IA-pe g̃uarã
channel:<name>ChannelServicePeteĩ canal ñe'ẽmondorã
commCommServiceÑomongeta mba'apohára IA-kuéra pa'ũme
uiUIServiceUI hekoitéva HTTP proxy reheve
scheduleScheduleServiceHorario ñemohenda hekoitéva
visionToolServiceTa'ãnga ñembosako'i
browserToolServiceNavegador automatización

Peteĩ aplicación ikatu ome'ẽ heta katupyry. Techapyrã, peteĩ aplicación ikatu ome'ẽ peteĩ tembiporu ha avei peteĩ panel UI.

Permiso

Permiso-kuéra oñangareko mba'épe aplicación ikatu oike. Oñemboyke ijypýpe — ndojemombe'úiramo, aplicación ndaikatúi oipuru.

ÑepyrũrãTechapyrãÑemombe'u
network:network:outbound, network:*Red jeike
filesystem:filesystem:read, filesystem:writeArchivo sistema jeike
memory:memory:read, memory:writeMba'apohára IA mandu'a jeike
session:session:readÑomongeta sesión
tool:tool:shell, tool:fileEipuru ambue tembiporu
shell:shell:execShell comando ñemboguata
channel:channel:send, channel:*Canal rembiapo
comm:comm:send, comm:*Ñomongeta mba'apohára IA-kuéra pa'ũme
model:model:chatIA modelo jeike
user:user:tokenOhupyty ojeporúva JWT jerure-kuérape
schedule:schedule:createCron tembiapo ñeñangareko
database:database:queryMarandu ryru jeike
storage:storage:read, storage:writeÑeñongatu opa'ỹva
context:context:readMba'apohára IA tekoha jeike
subagent:subagent:spawnSub-agente rembiapo
lane:lane:enqueueLane rembiapo
notification:notification:sendÑemomarandu push
embedding:embedding:searchVector embedding jeike
skill:skill:invokeKatupyry ñehenói
advisor:advisor:consultAdvisor sistema jeike
mcp:mcp:connectMCP servidor jeike
voice:voice:recordÑe'ẽ/audio jeike
browser:browser:navigateNavegador automatización
oauth:oauth:google, oauth:*OAuth token jeike
settings:settings:readÑemboheko jeike
capability:capability:registerKatupyry ñemboheraguapy

Permiso comodín ojeguerohory: network:* ojojogua oimeraẽ permiso network: jehecha ndive.

Ñemboheko

Ñemboheko ojehecha Nebo UI-pe aplicación ñemboheko panel-pe. Nebo oñongatu marandu ryrúpe ha omondo nde aplicación-pe RPC Configure rupive oñemoambue jave.

Nde ñemboheko esquema oĩ NeboAI aplicación ñemuha ñemoha'ãngápe. Umi aplicación oguerekóva ñemboheko tekotevẽva ojeboheko'ỹva ohechauka "Needs Setup" ra'ãnga UI-pe.

Mba'eichaguaÑemombe'u
textJehaipy ñemoinge peteĩ línea-pe
passwordJehaipy ñemoinge okañýva
toggleBoolean myendy/mboguejy
selectLísta oguejýva opción oĩmava reheve
numberPapapy ñemoinge
urlURL ñemoinge jehesa'ỹijo reheve
{
    "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 Tekotevẽ

Umi aplicación ikatu omombe'u OAuth proveedor tekotevẽ. Nebo OAuth broker ojapo opaite tape — umi aplicación ohupyty token ijeheguiete RPC Configure rupive.

{
    "oauth": [
        {
            "provider": "google",
            "scopes": ["https://www.googleapis.com/auth/calendar"]
        }
    ]
}
CampoÑemombe'u
providerOAuth proveedor: "google", "microsoft", "github"
scopesOAuth scope array aplicación oikotevẽva

Pe ojeporúva omoĩ jave aplicación, Nebo ojerure chupe omoneĩ hag̃ua umi OAuth scope tekotevẽva. Aplicación ohupyty token oñembopyahúva RPC Configure rupive ojapo'ỹre ijehegui OAuth tape.

Tekoha Variable

Nde aplicación proceso ohupyty peteĩ tekoha oñemopotĩva. Opaite secreto ojeipe'a. Rehupyty:

VariableValor
NEBO_APP_DIRAplicación ñemoĩ directorio
NEBO_APP_SOCKUnix socket ojejapova'erã rape
NEBO_APP_IDAplicación ID manifiesto-gui
NEBO_APP_NAMEAplicación téra manifiesto-gui
NEBO_APP_VERSIONAplicación versión manifiesto-gui
NEBO_APP_DATAAplicación directorio data/ rape
PATHSistema PATH (ohasa jeýva)
HOMEOjeporúva óga directorio (ohasa jeýva)
TMPDIRDirectorio temporal (ohasa jeýva)

Iñimportanteterei: Nde binario omopu'ãva'erã peteĩ servidor gRPC ohendúva Unix socket-pe NEBO_APP_SOCK-pe. Nebo oha'arõ 10 segundo peve ko socket ojehecha hag̃ua.

Aplicación Ñemoñepyrũ Jojaha

  1. Nebo omoñe'ẽ manifest.json ha ohesa'ỹijo
  2. Ojuhu ejecutable binary térã app aplicación directorio-pe
  3. Ohecha oĩpa marca .quarantined (ndomoñepyrũi aplicación cuarentena-pe oĩva)
  4. Ñemboyke jehecha (aplicación NeboAI omboja'óva añoite)
  5. Firma jehechajey (aplicación NeboAI omboja'óva añoite, ndojejapói dev-pe)
  6. Binario jehesa'ỹijo (omboyke symlink, script, ndaha'éiva ejecutable, archivo tuichaitereíva)
  7. Omopotĩ socket tuja jeguata mboyvegua
  8. Omopu'ã directorio data/ ñeñongatu sandbox-pe g̃uarã
  9. Omboheko log archivo peteĩteĩ aplicación-pe (logs/stdout.log, logs/stderr.log)
  10. Omoñepyrũ binario tekoha oñemopotĩva ha proceso aty ñemomombyry reheve
  11. Oha'arõ Unix socket ojehecha (backoff exponencial, 10 segundo peve)
  12. Ojoaju gRPC rupive Unix socket ári
  13. Omopu'ã gRPC cliente peteĩteĩ katupyrýpe g̃uarã provides he'iháicha
  14. Omboguata tesãi jehecha
  15. Oregistra katupyry mba'apohára IA ndive (tembiporu, gateway, comm, ha ambue)

Tembiporu Aplicación

Emombe'u "provides": ["tool:my_tool_name"] nde manifiesto-pe.

STRAP Rape

Opaite Nebo tembiporu aplicación oipuruva'erã STRAP (Single Tool Resource Action Pattern) iesquema ha ñemboguata ñembohapépe g̃uarã. Kóva ha'e pe rape voi Nebo oipurúva ipype ombyaty hag̃ua 35+ tembiporu peteĩteĩva 4 tembiporu dominio-pe — omboguejy LLM tekoha ipohýiva ~80%.

Temiandu tenondegua: Eregistra rangue heta tembiporu (get_events, check_availability, suggest_slots), eregistra PETEĨ tembiporu campo action (ha ipotárõ resource) reheve ombohapéva handler hekopegua gotyo.

Techapyrã peteĩ recurso reheve (calendario):

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

Techapyrã heta recurso reheve (proyecto ñangarekohára):

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

Esquema léi:

  1. Emoinge akóinte peteĩ campo action string enum tekotevẽva ramo
  2. Embojoapy peteĩ campo resource (string enum tekotevẽva) nde tembiporu oñangarekóramo añoite heta recurso iñambuéva rehe
  3. Opa ambue campo ha'e parámetro peteĩteĩ action-pegua
  4. Enum action ñemombe'u omoha'ãngava'erã opaite action oĩva

Mba'ére iñimportante STRAP:

  • LLM-kuéra oikuaa ñembohape action peteĩ jey ha oipuru opaite tembiapópe
  • Tembiporu ñemombe'u oipuru ~6% tekohágui — STRAP omboguejy 80%
  • Tembiapo pyahu ha'e enum ñembojoapy añoite, ndaha'éi tembiporu ñemboheraguapy pyahu
  • Omba'apo peteĩchaite modelo nube-pegua ha local-pe

Go Techapyrã — Calculadora Tembiporu

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

Emopu'ã ha emoĩ:

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 Techapyrã

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 Techapyrã

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

Canal Aplicación

Emombe'u "provides": ["channel:my_channel"] ha "permissions": ["channel:send"].

Canal aplicación ombojoaju plataforma ñe'ẽmondo okayguáva (Telegram, Discord, Slack, ha ambue) Nebo mba'apohára IA ndive. Peteĩ ojeporúva omondo jave peteĩ ñe'ẽmondo plataforma okayguápe, nde aplicación omondo Nebo-pe Receive rupive. Mba'apohára IA ombohovaise jave, Nebo ohenói nde aplicación Send.

Mba'éicha omba'apo

  1. Nebo ohenói ID() ohupyty hag̃ua nde canal identificador peteĩchagua'ỹva
  2. Nebo ohenói Connect() configuración nde aplicación ñembohekógui reheve
  3. Nebo oipe'a peteĩ stream Receive() — nde aplicación omondo ñe'ẽmondo oguahẽva peteĩ ojeporúva omondo jave ñe'ẽmondo bot-pe
  4. Ñe'ẽmondo oguahẽva oñembohape mba'apohára IA ñomongeta lane tenondeguápe
  5. Mba'apohára IA omondose jave peteĩ ñe'ẽmondo, Nebo ohenói Send() v1 ñe'ẽmondo envelope reheve
  6. Oñembogue jave, Nebo ohenói Disconnect()

v1 Ñe'ẽmondo Envelope

Opaite canal ñe'ẽmondo — oguahẽva ha osẽva — oipuru ñe'ẽmondo envelope opavavegua:

{
  "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"
}
CampoMba'eichaguaÑemombe'u
message_idUUID v7ID peteĩchagua'ỹva ára rupi oñemohendáva
channel_id{type}:{platform_id}Canal identificador ikatúva oñembohape
senderobjectBot jehechakuaa — téra, tembiapo, botId
textstringÑe'ẽmondo rete
attachmentsarrayArchivo, ta'ãnga, audio
reply_toUUID v7Ñe'ẽmondo tuvicha ID hilo-pe g̃uarã
actionsarrayVotõ/teclado ojeporu ojuehe
platform_databytesOhasa jeýva hesakã'ỹva plataforma peteĩteĩ mba'épe g̃uarã
timestampISO 8601Moherakuãhára omoĩ kóva

Mokõi capa diseño: Campo opavavegua (text, attachments, reply_to, actions) ojaho'i 90% ñe'ẽmondo mba'apohára oñepyrũva. Plataforma peteĩteĩ mba'e oho platform_data-pe — nde plugin ombohasa plataforma nativo formato-pe ha upégui.

Ñomongeta Stream

Canal ñe'ẽmondo oñembohape ñomongeta stream peteĩteĩ canal-pegua rupive ojeipe'a hag̃ua:

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

Go Techapyrã — Telegram Canal

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

Hetave Katupyry

Comm Aplicación

Emombe'u "provides": ["comm"] ha "permissions": ["comm:*"]. Comm aplicación ohejá mba'apohára IA-kuéra oñomongeta.

CampoÑemombe'u
fromOmondóva mba'apohára ID
toOhupytýva mba'apohára ID
topicÑe'ẽmondo téma/canal
type"message", "mention", "proposal", "command", "info", "task"
contentÑe'ẽmondo rete

Reko tenondegua:

  • Register omoherakuã ko mba'apohára IA red-pe ikatupyry reheve
  • Subscribe/Unsubscribe oñangareko téma suscripción rehe
  • Receive omondo ñe'ẽmondo oguahẽva (server-streaming, canal-kuérapeicha)
  • Peteĩ comm aplicación añoite ikatu omba'apo peteĩ jave

Gateway Aplicación

Peteĩ gateway aplicación ombohape LLM jerure modelo-kuérape. Emombe'u "provides": ["gateway"] ha "permissions": ["network:outbound", "user:token"].

GatewayRequest oguereko ñe'ẽmondo, tembiporu, sistema prompt, max tokens, temperature ha peteĩ UserContext (JWT token oñeme'ẽramo permiso user:token).

GatewayEvent mba'eichagua:

Mba'eichaguaIpype oĩvaÑemombe'u
"text"Jehaipy pehẽJehaipy token oñemondóva
"tool_call"JSONModelo ohenóise peteĩ tembiporu
"thinking"Jehaipy pehẽJepy'amongeta ipukuvéva
"error"Jejavy ñe'ẽmondoOĩ mba'e ndoikóiva
"done"NandiStream opáma

UI Aplicación

Peteĩ UI aplicación ome'ẽ peteĩ interfaz ñembohekopegua hekoitéva ojepe'áva Nebo ventana navegador ijypyguápe. Emombe'u "provides": ["ui"]. Ndaha'éi formulario ñemboheko ijeheguívaicha (Nebo ohechaukáva nde manifiesto settings-gui), peteĩ UI aplicación ome'ẽ ifrontend HTML/CSS/JS ae.

Nde aplicación ogueru peteĩ directorio ui/ oguerekóva web archivo estático (HTML, CSS, JS — jepi peteĩ SPA index.html reheve). Nebo ome'ẽ ko'ã archivo voi ha ombohasa API ñehenói nde aplicación-pe gRPC rupive.

RapeMba'éicha omba'apoMba'erã
GET /api/v1/apps/{id}/ui/*Archivo estático servidorOme'ẽ archivo nde directorio ui/-gui (SPA ojevy index.html-pe)
ANY /api/v1/apps/{id}/api/*gRPC proxyOmbohasa HTTP jerure nde aplicación UIService.HandleRequest()-pe

SDK ojaho'i peteĩ net/http.ServeMux estándar upévare rehai Go HTTP handler jepiguáva — SDK ojapo gRPC ñembojoaju ijeheguiete.

Go Techapyrã — Panel 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())
}

Nde ui/index.html ojapóta fetch ñehenói /api/v1/apps/com.example.dashboard/api/status-pe, oñembohasáva nde handler mux peve.

Horario Aplicación

Peteĩ horario aplicación omyengovia Nebo cron scheduler ijypyguáva. Emombe'u "provides": ["schedule"] ha "permissions": ["schedule:create"].

Nde horario aplicación oñepyrũ jave, Nebo ombohape opaite horario ñemohenda nde aplicación rupive cron motor ijypyguáva rangue. Nde aplicación oñembyaírõ, Nebo ojevy ijeheguiete motor ijypyguávape.

  • Nde aplicación ha'e horario reko jára — Nebo ndoñongatúi horario imarandu ryrúpe peteĩ horario aplicación omba'apo jave
  • CRUD estándar: Create, Get, List, Update, Delete, Enable, Disable
  • Triggers ha'e peteĩ RPC server-streaming — nde aplicación omondo peteĩ trigger ñe'ẽmondo peteĩ horario oñepyrũ jave
  • Peteĩ horario aplicación añoite ikatu omba'apo peteĩ jave

Aplicación Heta Katupyry Reheve

Peteĩ aplicación ikatu ome'ẽ heta katupyry. Techapyrã, peteĩ panel aplicación oguerekóva peteĩ tembiporu ha peteĩ 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())

Ñembyaty

.napp Formato

Remboja'o hag̃ua NeboAI rupive, embyaty nde aplicación peteĩ archivo .napp ramo (peteĩ tar.gz):

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

Archivo tekotevẽva:

ArchivoTuichakue YvatevévaÑemombe'u
manifest.json1 MBAplicación metadata
binary térã app500 MBEjecutable
signatures.json1 MBEd25519 firma
TOOL.md1 MBTembiporu mbo'epy mba'apohára IA-pe g̃uarã

Tekorosã léi ojeipe'a jave:

  • Ndaipóri rape jehasa (../ oñemboyke)
  • Ndaipóri symlink (oñemboyke)
  • Ndaipóri rape absoluto (oñemboyke)
  • Archivo téra oñemoneĩva añoite ojeguerohory

Firma

NeboAI omboheragua'i aplicación-kuéra Ed25519 reheve. Formato 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>"
}

Dev reko-pe (ndaipóri NeboAI URL oñembohekóva), firma jehechajey ndojejapói. Ndereikotevẽi signatures.json desarrollo local-pe g̃uarã.

Ñemoherakuã

Nde aplicación omba'apo porã rire local-pe, emoherakuã NeboAI rupive remboja'o hag̃ua opaite Nebo ojeporúvape.

Programador Kuénta Ñemboheko

  1. Eregistra peteĩ kuénta NeboAI POST /api/v1/owners/register-pe
  2. Eike rehupyty hag̃ua peteĩ JWT token: POST /api/v1/owners/login
  3. Emopu'ã peteĩ programador kuénta: POST /api/v1/developer/accounts

Ñemondo Rape

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

Paso 1: Emopu'ã aplicación

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

Paso 2: Embojupi plataforma binario

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"

Embojupi peteĩ binario peteĩteĩ plataforma-pe: darwin-arm64, darwin-amd64, linux-amd64, linux-arm64.

Paso 3: Emondo ojehesa'ỹijo hag̃ua

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

Jehesa'ỹijo Rape

  1. Jehesa'ỹijo ijeheguíva — binario-kuéra ojehesa'ỹijo VirusTotal rupive
  2. Admin jehesa'ỹijo — NeboAI aty ohesa'ỹijo metadata, manifiesto ha jehesa'ỹijo rembiapopyre
  3. Oñemoneĩ jave — NeboAI omboheragua'i aplicación Ed25519 reheve ha omoherakuã
  4. Oñemboyke jave — rehupyty peteĩ mba'érepa ha ikatu emyatyrõ ha emondo jey

Jehesa'ỹijo ára ojeha'arõva: <24 aravo.

Ñembohekopyahu Ñemondo

  1. Emopyahu aplicación versión: PUT /api/v1/developer/apps/{id} versión pyahu ndive
  2. Embojupi binario pyahu peteĩteĩ plataforma-pe
  3. Emondo jey ojehesa'ỹijo hag̃ua

Peteĩteĩ ñembohekopyahu ohasa upe jehesa'ỹijo rape voi rupi. Versión mboyvegua opyta oĩ versión pyahu oñemoneĩ peve.

Ñemuha Metadata

CampoÑemombe'u
categorytechapyrã, productivity, communication, developer-tools
iconAplicación ícono URL
visibilitypublic térã private
descriptionIkatu ipukuve/hetave manifiesto ñemombe'úgui

Dev Tembiapo Rape

Desarrollo Local

Ndaikotevẽi ñembyaty desarrollo local-pe g̃uarã:

  1. Ejapo ne aplicación carpeta:
    mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp
  2. Ehai nde manifest.json ha código
  3. Emopu'ã ne binario:
    go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary .
  4. Nebo ojuhu ijeheguiete directorio pyahu (térã emoñepyrũ jey Nebo)
  5. Código remoambue rire, emopu'ã jey binario — archivo ñangarekohára omoñepyrũ jeýta aplicación

Log Jehecha

Aplicación stdout/stderr oñeñongatu log archivo peteĩteĩ aplicación-pegua-pe:

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

Marandu Opa'ỹva

Eipuru directorio data/ (oĩ avei env var NEBO_APP_DATA ramo) opaite archivo nde aplicación oñongatuva'erãme g̃uarã. Ko directorio opyta aplicación ñembohekopyahu ha cuarentena rire.

Jejavy Jejuhu Ñemoñe'ẽ

  • Nde aplicación noñepyrũiramo, ehecha logs/stderr.log jejavy rehe
  • Ehecha binario ikatúpa oñemboguata (chmod +x binary)
  • Ehecha rehendúpa Unix socket rape NEBO_APP_SOCK-gui
  • Socket oĩva'erã 10 segundo ñepyrũ rire
  • Eipuru NEBO_APP_DATA ñeñongatúpe g̃uarã, ndaha'éi rape hardcoded
  • Ehai stderr-pe debug log-pe g̃uarã (oñeñongatu logs/stderr.log-pe)

Jehechajey

# 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

Ñemboyke

nebo apps uninstall com.example.myapp

Katupyry

Mba'épa umi Katupyry

Katupyry ha'e mbo'epy aty omoha'ãngáva mba'éicha Nebo ojeporta peteĩ ñomongeta aja. Peteĩ katupyry omba'apo jave, ipype oĩva oike voi sistema prompt-pe — ohechauka mba'apohára IA-pe iñe'ẽ reko, imétodo, ikuaapy ha tembiporu jeporu upe sesión-pe g̃uarã.

Katupyry ndaha'éi código. Ha'e kuatiakuéra markdown YAML metadata reheve. Ndaipóri compilación, ndaipóri binario, ndaipóri gRPC. Peteĩ katupyry ha'e peteĩ archivo SKILL.md peteĩ directorio-pe. Upéva añoite.

Katupyry oñeikotevẽháme añoite ha sapy'apeguánte. Omba'apo oñeikotevẽ jave (trigger jojogua térã ojemyenyhẽ pópe rupive), opyta mbovy jere, ha opa ndoikotevẽvéi jave. Kóva omomichĩ mba'apohára IA tekoha — pe mbo'epy iñimportánteva ko'ag̃aite añoite oĩ prompt-pe.

Katupyry ombotuichave aplicación-kuéra. Aplicación ome'ẽ katupyry ikatúva oñemboguata (tembiporu, canal, gateway). Katupyry ome'ẽ ñemboguata rape — mba'éicha jaipuru porã ko'ã tembiporu. Peteĩ calendario aplicación ome'ẽ Nebo-pe katupyry omoñe'ẽ ha ohai hag̃ua jehu. Peteĩ katupyry "ñembyaty ñembosako'i" omombe'u Nebo-pe mba'éicha oñembosako'íta ñembyatýpe g̃uarã oipurúvo upe calendario aplicación, correo ha web jeheka oñondive.

Katupyry ha Aplicación

KatupyryAplicación-kuéra
FormatoMarkdown (SKILL.md)Binario compilado (.napp)
ÑemboguataOike sistema prompt-peProceso sandbox-pe gRPC rupive
Ome'ẽReko mbo'epy, métodoTembiporu, canal, panel UI
Ára pukukuePeteĩ sesión-pe g̃uarã, opa TTL rupiveAkóinte omba'apo
Ñemopu'ãEhai peteĩ archivo markdownEhai, ecompila, emboheragua'i, embyaty
TekorosãNdaikotevẽi permisoSandbox oñemboykéva ijypýpe

Ñepyrũ Pya'e

Emopu'ã peteĩ directorio nde Nebo katupyry carpeta-pe peteĩ archivo SKILL.md reheve:

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

Ehai peteĩ 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 oñangareko katupyry directorio rehe fsnotify reheve. Nde katupyry oĩma pya'eterei — ndaikotevẽi emoñepyrũ jey. Ere peteĩ mba'e ojojoguáva peteĩ trigger ndive, ha omba'apo ijeheguiete.

Térã eporandu Nebo-pe voi: "Emopu'ã peteĩ katupyry blog jehaipy rehe" — Nebo ohaíta ndéve archivo SKILL.md.

SKILL.md Formato

Opaite katupyry ha'e peteĩ archivo SKILL.md añoite mokõi pehẽ reheve: YAML frontmatter marca --- pa'ũme, ha peteĩ markdown rete (mbo'epy añetegua oikéva sistema prompt-pe).

CampoTekotevẽIjypyguávaÑemombe'u
nameHéẽ—Identificador peteĩchagua'ỹva (oiko slug)
descriptionHéẽ—Ñemombe'u peteĩ línea-pe ojehechaukáva katupyry catálogo-pe
versionNahániri"1.0.0"Semver ñembohekopyahu ñeñangarekorã
authorNahániri—Katupyry apohára
priorityNahániri0Yvatevéva = ojejojogua raẽ (100+ ñemyengovia iñimportantetereívape g̃uarã)
max_turnsNahániri4Jere omba'apo'ỹre opa mboyve ijeheguiete
triggersNahániri[]Ñe'ẽ omyendýva ko katupyry ijeheguiete (jojogua pehẽme, tai tuicha térã michĩ ndaha'éi iñambue)
toolsNahániri[]Tembiporu ko katupyry oha'arõva oipuru (marandu ramo)
dependenciesNahániri[]Ambue katupyry oñemoĩva'erã
tagsNahániri[]Ñemohenda ha jejuhúpe g̃uarã
platformNahániri[]Plataforma ojeguerohorýva: macos, linux, windows (nandi = opavave)

Mba'éicha Omba'apo Katupyry

Katupyry osegi peteĩ ñemyendy mokõi pehẽme: ñemomarandu ha upéi ñehenói.

Pehẽ 1: Trigger Jojogua — Opa jey peteĩ ojeporúva omondo jave peteĩ ñe'ẽmondo, Nebo ohesa'ỹijo opaite katupyry oñemboheraguapýva trigger jojogua rehe. Katupyry ojojoguáva ojehecha ñemomarandu ramo sistema prompt-pe. Mba'apohára IA ohecha ñemomarandu ha oiporavo ohenóitapa katupyry.

Pehẽ 2: Ñehenói — Mba'apohára IA ohenói peteĩ katupyry ohenóivo:

skill(name: "code-review")

Kóva ome'ẽ jey SKILL.md techapyrã tuichakue tembiporu rembiapopyre ramo, oñongatu ñehenói, ha omoinge jey techapyrã sistema prompt-pe umi jere oúvape.

TTL ha Opa:

  • Katupyry ojejojoguáva ijeheguiete: 4 jere omba'apo'ỹre (ikatu oñemoambue max_turns rupive)
  • Katupyry ojemyenyhẽva pópe: 6 jere omba'apo'ỹre
  • Ñehenói jey omoñepyrũ jey aravopapaha
  • Rapykuere hatãva: 4 katupyry omba'apóva peve peteĩ sesión-pe
  • Token presupuesto: katupyry omba'apóva ipype oĩva oñembyatývo 16,000 tai peve

Katupyry Ñeñangareko

Mba'apohára IA ikatu oñangareko katupyry rehe tembiporu skill rupive:

TembiapoÑemombe'uTechapyrã
catalogEhechauka opaite katupyry oĩvaskill(action: "catalog")
loadEmyendy ko sesión-pe g̃uarãskill(name: "code-review", action: "load")
unloadEmbogue peteĩ katupyryskill(name: "code-review", action: "unload")
createEmopu'ã peteĩ katupyry pyahu disco-peskill(action: "create", content: "...")
updateEmbohekopyahu peteĩ katupyry oĩmavaskill(name: "my-skill", action: "update", content: "...")
deleteEmbogue peteĩ katupyry disco-guiskill(name: "my-skill", action: "delete")

Ehai Katupyry Iporãva

Peteĩ katupyry techapyrã iporãva oguereko:

  1. Peteĩ título hesakãva — omombe'u mba'apohára IA-pe mba'e reko-pe oĩ
  2. Ñemboguatarã tenondegua — reko léi ndaikatúiva oñemoambue
  3. Método — tape pasopegua umi mba'e ojehu jepívape g̃uarã
  4. Techapyrã — rape hesakãva ojeporúva ñe'ẽmondo guive mbohovái peve
  5. Rape vai — mba'épa NDOJEJAPOVA'ERÃI (modelo-kuéra oaprende porã techapyrã vaígui)

Ñemoñe'ẽ: Peteĩteĩ katupyry ojapova'erã peteĩ mba'e porã. Ani emopu'ã peteĩ katupyry "programación general" — emopu'ã code-review, debugging, api-design katupyry ojeipe'áva ramo. Mba'apohára IA ikatu oguereko heta omba'apóva peteĩ jave.

Katupyry Oúva Nebo Ndive

Nebo ou katupyry reheve ojaho'íva umi jeporu jepiguáva:

KatupyryTenondeguávaÑemombe'u
onboarding100Ojeporúva pyahu ñemomaitei ha perfil ñembyaty
best-friend50Teko katupyry — ndahasýiva, ijeroviaha, ñe'ẽ añetegua
debugging25Jejavy jejuhu método oñemohendáva
api-design15RESTful API diseño tembiapo iporãvéva
code-review10Código jehesa'ỹijo oñemohendáva ipohýi nivel reheve
database-expert10Marandu ryru diseño, consulta, ñemoporã
git-workflow10Git rakã, commit, PR tembiapo rape
security-audit10Tekorosã jehesa'ỹijo ha vulnerabilidad jejuhu

Ko'ãva oiko ijypyguáva iporãva ha avei techapyrã remopu'ã hag̃ua nde katupyry ae.

Rehegua

Proto Archivo

Proto archivo oiko proto/apps/v0/-pe. SDK-kuéra ou código ojejapo raẽmava reheve, upévare ndereikotevẽi protoc desarrollo jepiguápe.

ArchivoServicioRPC tenondegua
v0/common.proto(ñe'ẽmondo añoite)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

Opaite servicio oguereko RPC HealthCheck ha Configure. SDK ojapo mokõivéva ijeheguiete.

Canal Proto Mba'eichagua

Ñe'ẽmondo Mba'eichaguaÑemombe'u
ChannelSendRequestÑe'ẽmondo osẽva envelope message_id, channelId, sender, text, attachments, reply_to, actions, platform_data reheve
ChannelSendResponsePlataforma ñe'ẽmondo ID hilo-pe g̃uarã
InboundMessageÑe'ẽmondo oguahẽva envelope opaite campo opavavegua + timestamp reheve
MessageSenderBot jehechakuaa (name, role, botId) — broker ombohetavéva
AttachmentArchivo/ta'ãnga/audio moirũ (type, url, filename, size)
MessageActionVotõ/teclado tembiapo ojeporu ojuehe (label, callback_id)

Bot Jehechakuaa ha Tembiapo

Nebo bot-kuéra oguereko jehechakuaa mbohapy eje reheve:

  • creature — Mba'épa pe bot (arquetipo): "Estratega iñakãporãva", "Jeheka apohára ojesarekóva"
  • role — Mba'éicha ojoaju ojeporúva ndive (joaju): "Angirũ", "COO", "Mbo'ehára"
  • vibe — Ipu'aka (ñe'ẽ reko): "Trankílo ha katu oguereko temiandu", "Ihakuvóva ha omokyre'ỹva"

Nde canal plugin ohupyty jave peteĩ ñe'ẽmondo osẽva, campo sender oguereko bot name ha role. Eipuru kóva remohenda hag̃ua téra ojehechaukáva nde plataforma-pe. Role ndaha'éi tembiapo réra — ha'e joaju ñemombe'u. "Angirũ", "Ta'ýra" ha "Mbo'ehára" ha'e role ojeguerohorýva "COO" ha "DevLead" ykére.