Ñ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ýva | Go (oñemoñe'ẽvéva), Rust, C/C++, Zig |
| Oñemboykéva | Python, 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
- Emopu'ã
manifest.jsonid,name,version,providesreheve - Ehai
TOOL.mdomombe'úva mba'éichapa mba'apohára IA oipurúva'erã nde tembiporu - Emoĩ SDK (
go get github.com/neboloop/nebo-sdk-go) - Eimplementa handler interfaz nde katupyrýpe g̃uarã (
ToolHandler,ChannelHandler, ha ambue) - Eregistra handler ha ehenói
app.Run() - Emopu'ã peteĩ binario nativo (
go build -o binary .) - Emoĩ binario + manifest.json + TOOL.md directorio
apps/<your-app-id>/-pe - 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 |
|---|---|
id | Identificador dominio jere (techapyrã, com.mycompany.myapp) |
name | Téra tapicha ikatúva omoñe'ẽ |
version | Semver jehaipy |
provides | Sa'ive peteĩ katupyry (ehecha iguýpe) |
Campo ndaha'éiva tekotevẽ:
| Campo | Ijypyguá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'ẽ:
| Katupyry | gRPC Servicio | Ñemombe'u |
|---|---|---|
gateway | GatewayService | LLM modelo ñembohape |
tool:<name> | ToolService | Peteĩ tembiporu héra reheve mba'apohára IA-pe g̃uarã |
channel:<name> | ChannelService | Peteĩ canal ñe'ẽmondorã |
comm | CommService | Ñomongeta mba'apohára IA-kuéra pa'ũme |
ui | UIService | UI hekoitéva HTTP proxy reheve |
schedule | ScheduleService | Horario ñemohenda hekoitéva |
vision | ToolService | Ta'ãnga ñembosako'i |
browser | ToolService | Navegador 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:write | Archivo sistema jeike |
memory: | memory:read, memory:write | Mba'apohára IA mandu'a jeike |
session: | session:read | Ñomongeta sesión |
tool: | tool:shell, tool:file | Eipuru ambue tembiporu |
shell: | shell:exec | Shell comando ñemboguata |
channel: | channel:send, channel:* | Canal rembiapo |
comm: | comm:send, comm:* | Ñomongeta mba'apohára IA-kuéra pa'ũme |
model: | model:chat | IA modelo jeike |
user: | user:token | Ohupyty ojeporúva JWT jerure-kuérape |
schedule: | schedule:create | Cron tembiapo ñeñangareko |
database: | database:query | Marandu ryru jeike |
storage: | storage:read, storage:write | Ñeñongatu opa'ỹva |
context: | context:read | Mba'apohára IA tekoha jeike |
subagent: | subagent:spawn | Sub-agente rembiapo |
lane: | lane:enqueue | Lane rembiapo |
notification: | notification:send | Ñemomarandu push |
embedding: | embedding:search | Vector embedding jeike |
skill: | skill:invoke | Katupyry ñehenói |
advisor: | advisor:consult | Advisor sistema jeike |
mcp: | mcp:connect | MCP servidor jeike |
voice: | voice:record | Ñe'ẽ/audio jeike |
browser: | browser:navigate | Navegador automatización |
oauth: | oauth:google, oauth:* | OAuth token jeike |
settings: | settings:read | Ñemboheko jeike |
capability: | capability:register | Katupyry ñ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 |
|---|---|
text | Jehaipy ñemoinge peteĩ línea-pe |
password | Jehaipy ñemoinge okañýva |
toggle | Boolean myendy/mboguejy |
select | Lísta oguejýva opción oĩmava reheve |
number | Papapy ñemoinge |
url | URL ñ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 |
|---|---|
provider | OAuth proveedor: "google", "microsoft", "github" |
scopes | OAuth 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:
| Variable | Valor |
|---|---|
NEBO_APP_DIR | Aplicación ñemoĩ directorio |
NEBO_APP_SOCK | Unix socket ojejapova'erã rape |
NEBO_APP_ID | Aplicación ID manifiesto-gui |
NEBO_APP_NAME | Aplicación téra manifiesto-gui |
NEBO_APP_VERSION | Aplicación versión manifiesto-gui |
NEBO_APP_DATA | Aplicación directorio data/ rape |
PATH | Sistema PATH (ohasa jeýva) |
HOME | Ojeporúva óga directorio (ohasa jeýva) |
TMPDIR | Directorio 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
- Nebo omoñe'ẽ
manifest.jsonha ohesa'ỹijo - Ojuhu ejecutable
binarytérãappaplicación directorio-pe - Ohecha oĩpa marca
.quarantined(ndomoñepyrũi aplicación cuarentena-pe oĩva) - Ñemboyke jehecha (aplicación NeboAI omboja'óva añoite)
- Firma jehechajey (aplicación NeboAI omboja'óva añoite, ndojejapói dev-pe)
- Binario jehesa'ỹijo (omboyke symlink, script, ndaha'éiva ejecutable, archivo tuichaitereíva)
- Omopotĩ socket tuja jeguata mboyvegua
- Omopu'ã directorio
data/ñeñongatu sandbox-pe g̃uarã - Omboheko log archivo peteĩteĩ aplicación-pe (
logs/stdout.log,logs/stderr.log) - Omoñepyrũ binario tekoha oñemopotĩva ha proceso aty ñemomombyry reheve
- Oha'arõ Unix socket ojehecha (backoff exponencial, 10 segundo peve)
- Ojoaju gRPC rupive Unix socket ári
- Omopu'ã gRPC cliente peteĩteĩ katupyrýpe g̃uarã
provideshe'iháicha - Omboguata tesãi jehecha
- 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:
- Emoinge akóinte peteĩ campo
actionstring enum tekotevẽva ramo - Embojoapy peteĩ campo
resource(string enum tekotevẽva) nde tembiporu oñangarekóramo añoite heta recurso iñambuéva rehe - Opa ambue campo ha'e parámetro peteĩteĩ action-pegua
- Enum
actionñemombe'u omoha'ãngava'erã opaite action oĩva
Mba'ére iñimportante STRAP:
- LLM-kuéra oikuaa ñembohape
actionpeteĩ 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
- Nebo ohenói
ID()ohupyty hag̃ua nde canal identificador peteĩchagua'ỹva - Nebo ohenói
Connect()configuración nde aplicación ñembohekógui reheve - Nebo oipe'a peteĩ stream
Receive()— nde aplicación omondo ñe'ẽmondo oguahẽva peteĩ ojeporúva omondo jave ñe'ẽmondo bot-pe - Ñe'ẽmondo oguahẽva oñembohape mba'apohára IA ñomongeta lane tenondeguápe
- Mba'apohára IA omondose jave peteĩ ñe'ẽmondo, Nebo ohenói
Send()v1 ñe'ẽmondo envelope reheve - 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"
} | Campo | Mba'eichagua | Ñemombe'u |
|---|---|---|
message_id | UUID v7 | ID peteĩchagua'ỹva ára rupi oñemohendáva |
channel_id | {type}:{platform_id} | Canal identificador ikatúva oñembohape |
sender | object | Bot jehechakuaa — téra, tembiapo, botId |
text | string | Ñe'ẽmondo rete |
attachments | array | Archivo, ta'ãnga, audio |
reply_to | UUID v7 | Ñe'ẽmondo tuvicha ID hilo-pe g̃uarã |
actions | array | Votõ/teclado ojeporu ojuehe |
platform_data | bytes | Ohasa jeýva hesakã'ỹva plataforma peteĩteĩ mba'épe g̃uarã |
timestamp | ISO 8601 | Moherakuã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 |
|---|---|
from | Omondóva mba'apohára ID |
to | Ohupytýva mba'apohára ID |
topic | Ñe'ẽmondo téma/canal |
type | "message", "mention", "proposal", "command", "info", "task" |
content | Ñe'ẽmondo rete |
Reko tenondegua:
Registeromoherakuã ko mba'apohára IA red-pe ikatupyry reheveSubscribe/Unsubscribeoñangareko téma suscripción reheReceiveomondo ñ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'eichagua | Ipype oĩva | Ñemombe'u |
|---|---|---|
"text" | Jehaipy pehẽ | Jehaipy token oñemondóva |
"tool_call" | JSON | Modelo ohenóise peteĩ tembiporu |
"thinking" | Jehaipy pehẽ | Jepy'amongeta ipukuvéva |
"error" | Jejavy ñe'ẽmondo | Oĩ mba'e ndoikóiva |
"done" | Nandi | Stream 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.
| Rape | Mba'éicha omba'apo | Mba'erã |
|---|---|---|
GET /api/v1/apps/{id}/ui/* | Archivo estático servidor | Ome'ẽ archivo nde directorio ui/-gui (SPA ojevy index.html-pe) |
ANY /api/v1/apps/{id}/api/* | gRPC proxy | Ombohasa 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 Triggersha'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:
| Archivo | Tuichakue Yvatevéva | Ñemombe'u |
|---|---|---|
manifest.json | 1 MB | Aplicación metadata |
binary térã app | 500 MB | Ejecutable |
signatures.json | 1 MB | Ed25519 firma |
TOOL.md | 1 MB | Tembiporu 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
- Eregistra peteĩ kuénta NeboAI
POST /api/v1/owners/register-pe - Eike rehupyty hag̃ua peteĩ JWT token:
POST /api/v1/owners/login - 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
- Jehesa'ỹijo ijeheguíva — binario-kuéra ojehesa'ỹijo VirusTotal rupive
- Admin jehesa'ỹijo — NeboAI aty ohesa'ỹijo metadata, manifiesto ha jehesa'ỹijo rembiapopyre
- Oñemoneĩ jave — NeboAI omboheragua'i aplicación Ed25519 reheve ha omoherakuã
- Oñemboyke jave — rehupyty peteĩ mba'érepa ha ikatu emyatyrõ ha emondo jey
Jehesa'ỹijo ára ojeha'arõva: <24 aravo.
Ñembohekopyahu Ñemondo
- Emopyahu aplicación versión:
PUT /api/v1/developer/apps/{id}versión pyahu ndive - Embojupi binario pyahu peteĩteĩ plataforma-pe
- 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 |
|---|---|
category | techapyrã, productivity, communication, developer-tools |
icon | Aplicación ícono URL |
visibility | public térã private |
description | Ikatu ipukuve/hetave manifiesto ñemombe'úgui |
Dev Tembiapo Rape
Desarrollo Local
Ndaikotevẽi ñembyaty desarrollo local-pe g̃uarã:
- Ejapo ne aplicación carpeta:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp - Ehai nde
manifest.jsonha código - Emopu'ã ne binario:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Nebo ojuhu ijeheguiete directorio pyahu (térã emoñepyrũ jey Nebo)
- 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.logjejavy 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
| Katupyry | Aplicación-kuéra | |
|---|---|---|
| Formato | Markdown (SKILL.md) | Binario compilado (.napp) |
| Ñemboguata | Oike sistema prompt-pe | Proceso sandbox-pe gRPC rupive |
| Ome'ẽ | Reko mbo'epy, método | Tembiporu, canal, panel UI |
| Ára pukukue | Peteĩ sesión-pe g̃uarã, opa TTL rupive | Akóinte omba'apo |
| Ñemopu'ã | Ehai peteĩ archivo markdown | Ehai, ecompila, emboheragua'i, embyaty |
| Tekorosã | Ndaikotevẽi permiso | Sandbox 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).
| Campo | Tekotevẽ | Ijypyguáva | Ñemombe'u |
|---|---|---|---|
name | Héẽ | — | Identificador peteĩchagua'ỹva (oiko slug) |
description | Héẽ | — | Ñemombe'u peteĩ línea-pe ojehechaukáva katupyry catálogo-pe |
version | Nahániri | "1.0.0" | Semver ñembohekopyahu ñeñangarekorã |
author | Nahániri | — | Katupyry apohára |
priority | Nahániri | 0 | Yvatevéva = ojejojogua raẽ (100+ ñemyengovia iñimportantetereívape g̃uarã) |
max_turns | Nahániri | 4 | Jere omba'apo'ỹre opa mboyve ijeheguiete |
triggers | Nahániri | [] | Ñe'ẽ omyendýva ko katupyry ijeheguiete (jojogua pehẽme, tai tuicha térã michĩ ndaha'éi iñambue) |
tools | Nahániri | [] | Tembiporu ko katupyry oha'arõva oipuru (marandu ramo) |
dependencies | Nahániri | [] | Ambue katupyry oñemoĩva'erã |
tags | Nahániri | [] | Ñemohenda ha jejuhúpe g̃uarã |
platform | Nahá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_turnsrupive) - 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'u | Techapyrã |
|---|---|---|
catalog | Ehechauka opaite katupyry oĩva | skill(action: "catalog") |
load | Emyendy ko sesión-pe g̃uarã | skill(name: "code-review", action: "load") |
unload | Embogue peteĩ katupyry | skill(name: "code-review", action: "unload") |
create | Emopu'ã peteĩ katupyry pyahu disco-pe | skill(action: "create", content: "...") |
update | Embohekopyahu peteĩ katupyry oĩmava | skill(name: "my-skill", action: "update", content: "...") |
delete | Embogue peteĩ katupyry disco-gui | skill(name: "my-skill", action: "delete") |
Ehai Katupyry Iporãva
Peteĩ katupyry techapyrã iporãva oguereko:
- Peteĩ título hesakãva — omombe'u mba'apohára IA-pe mba'e reko-pe oĩ
- Ñemboguatarã tenondegua — reko léi ndaikatúiva oñemoambue
- Método — tape pasopegua umi mba'e ojehu jepívape g̃uarã
- Techapyrã — rape hesakãva ojeporúva ñe'ẽmondo guive mbohovái peve
- 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:
| Katupyry | Tenondeguáva | Ñemombe'u |
|---|---|---|
onboarding | 100 | Ojeporúva pyahu ñemomaitei ha perfil ñembyaty |
best-friend | 50 | Teko katupyry — ndahasýiva, ijeroviaha, ñe'ẽ añetegua |
debugging | 25 | Jejavy jejuhu método oñemohendáva |
api-design | 15 | RESTful API diseño tembiapo iporãvéva |
code-review | 10 | Código jehesa'ỹijo oñemohendáva ipohýi nivel reheve |
database-expert | 10 | Marandu ryru diseño, consulta, ñemoporã |
git-workflow | 10 | Git rakã, commit, PR tembiapo rape |
security-audit | 10 | Tekorosã 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.
| Archivo | Servicio | RPC tenondegua |
|---|---|---|
v0/common.proto | (ñe'ẽmondo añoite) | HealthCheckRequest/Response, SettingsMap, UserContext, Empty |
v0/tool.proto | ToolService | Name, Description, Schema, Execute, RequiresApproval, Configure |
v0/channel.proto | ChannelService | ID, Connect, Disconnect, Send, Receive (stream), Configure |
v0/comm.proto | CommService | Name, Version, Connect, Disconnect, Send, Subscribe, Register, Receive (stream), Configure |
v0/gateway.proto | GatewayService | HealthCheck, Stream (stream), Poll, Cancel, Configure |
v0/ui.proto | UIService | HealthCheck, HandleRequest, Configure |
v0/schedule.proto | ScheduleService | HealthCheck, Create, Get, List, Update, Delete, Enable, Disable, Trigger, History, Triggers (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 |
ChannelSendResponse | Plataforma ñe'ẽmondo ID hilo-pe g̃uarã |
InboundMessage | Ñe'ẽmondo oguahẽva envelope opaite campo opavavegua + timestamp reheve |
MessageSender | Bot jehechakuaa (name, role, botId) — broker ombohetavéva |
Attachment | Archivo/ta'ãnga/audio moirũ (type, url, filename, size) |
MessageAction | Votõ/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.