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-akwado | Go (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
- Mepụta
manifest.jsonnwereid,name,version,provides - Dee
TOOL.mdna-akọwa otú onye ọrụ AI kwesịrị iji ngwaọrụ gị - Wụnye SDK (
go get github.com/neboloop/nebo-sdk-go) - Mejuputa interface handler maka ikike gị (
ToolHandler,ChannelHandler, wdg) - Debanye handler ahụ ma kpọọ
app.Run() - Wuo binary nke sistemụ ahụ (
go build -o binary .) - Tinye binary + manifest.json + TOOL.md na ndekọ
apps/<your-app-id>/ - 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ọ:
| Mpaghara | Nkọwa |
|---|---|
id | Njirimara ngalaba azụ (dịka, com.mycompany.myapp) |
name | Aha mmadụ nwere ike ịgụ |
version | Eriri semver |
provides | Opekata mpe otu ikike (lee n'okpuru) |
Mpaghara nhọrọ:
| Mpaghara | Ndabara | Nkọ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ụ gRPC | Nkọwa |
|---|---|---|
gateway | GatewayService | Nzigharị ụdị LLM |
tool:<name> | ToolService | Ngwaọrụ nwere aha maka onye ọrụ AI |
channel:<name> | ChannelService | Ọwa ozi |
comm | CommService | Nkwurịta okwu n'etiti ndị ọrụ AI |
ui | UIService | UI pụrụ iche nwere proxy HTTP |
schedule | ScheduleService | Nhazi oge pụrụ iche |
vision | ToolService | Nhazi ọhụụ |
browser | ToolService | Akpaaka 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.
| Mbido | Ihe atụ | Nkọwa |
|---|---|---|
network: | network:outbound, network:* | Ohere netwọk |
filesystem: | filesystem:read, filesystem:write | Ohere sistemụ faịlụ |
memory: | memory:read, memory:write | Ohere ncheta onye ọrụ AI |
session: | session:read | Oge mkparịta ụka |
tool: | tool:shell, tool:file | Jiri 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:chat | Ohere ụdị AI |
user: | user:token | Nata JWT onye ọrụ n'arịrịọ |
schedule: | schedule:create | Njikwa ọrụ cron |
database: | database:query | Ohere nchekwa data |
storage: | storage:read, storage:write | Nchekwa na-adịgide adịgide |
context: | context:read | Ohere ọnọdụ onye ọrụ AI |
subagent: | subagent:spawn | Omume sub-agent |
lane: | lane:enqueue | Omume lane |
notification: | notification:send | Ọkwa push |
embedding: | embedding:search | Ohere vector embedding |
skill: | skill:invoke | Ịkpọ nka |
advisor: | advisor:consult | Ohere sistemụ onye ndụmọdụ |
mcp: | mcp:connect | Ohere sava MCP |
voice: | voice:record | Ohere olu/ụda |
browser: | browser:navigate | Akpaaka nchọgharị |
oauth: | oauth:google, oauth:* | Ohere token OAuth |
settings: | settings:read | Ohere ntọala |
capability: | capability:register | Ndebanye 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 |
|---|---|
text | Ntinye ederede otu ahịrị |
password | Ntinye ederede e zoro ezo |
toggle | Mgbanwe gbanye/gbanyụọ |
select | Ndepụta na-agbada nwere nhọrọ a kara aka |
number | Ntinye nọmba |
url | Ntinye 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"]
}
]
} | Mpaghara | Nkọwa |
|---|---|
provider | Onye na-enye OAuth: "google", "microsoft", "github" |
scopes | Usoro 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:
| Mgbanwe | Uru |
|---|---|
NEBO_APP_DIR | Ndekọ nwụnye ngwa |
NEBO_APP_SOCK | Ụzọ gaa na socket Unix a ga-emepụta |
NEBO_APP_ID | ID ngwa site na manifest |
NEBO_APP_NAME | Aha ngwa site na manifest |
NEBO_APP_VERSION | Ụdị ngwa site na manifest |
NEBO_APP_DATA | Ụzọ gaa na ndekọ data/ nke ngwa |
PATH | PATH sistemụ (a na-agafe ya) |
HOME | Ndekọ ụlọ onye ọrụ (a na-agafe ya) |
TMPDIR | Ndekọ 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
- Nebo na-agụ
manifest.jsonma kwado ya - Na-achọta mmemme
binaryma ọ bụappna ndekọ ngwa - Na-elele akara
.quarantined(ọ naghị amalite ngwa e kewapụrụ) - Nlele nkagbu (naanị ngwa NeboAI kesara)
- Nkwenye mbịanye aka (naanị ngwa NeboAI kesara, a na-agafe ya n'ọnọdụ dev)
- Nkwado binary (na-ajụ symlink, script, ihe na-abụghị mmemme, faịlụ buru oke ibu)
- Na-ehicha socket ochie site n'ọgba gara aga
- Na-emepụta ndekọ
data/maka nchekwa sandbox - Na-ahazi faịlụ log kwa ngwa (
logs/stdout.log,logs/stderr.log) - Na-amalite binary na gburugburu a sachara ọcha na nkewa otu usoro
- Na-eche ka socket Unix pụta (nchere na-amụba, kacha sekọnd 10)
- Na-ejikọ site na gRPC n'elu socket Unix
- Na-emepụta onye ahịa gRPC kwa ikike dabere na
provides - Na-agba nlele ahụ ike
- 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ụ:
- Tinye mpaghara
actionmgbe niile dị ka string enum achọrọ - Gbakwunye mpaghara
resource(string enum achọrọ) naanị ma ọ bụrụ na ngwaọrụ gị na-ejikwa ọtụtụ ụdị resource dị iche iche - Mpaghara ndị ọzọ niile bụ paramita kwa action
- Nkọwa enum
actionkwesịrị idepụta action niile dị
Gịnị mere STRAP ji dị mkpa:
- LLM na-amụta usoro nzigharị
actionotu 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ụ
- Nebo na-akpọ
ID()iji nweta njirimara pụrụ iche nke ọwa gị - Nebo na-akpọ
Connect()na nhazi sitere na ntọala ngwa gị - Nebo na-emeghe iyi
Receive()— ngwa gị na-eziga ozi na-abata mgbe ọ bụla onye ọrụ ziteere bot ozi - A na-ezigara ozi na-abata n'ụzọ mkparịta ụka bụ isi nke onye ọrụ AI
- Mgbe onye ọrụ AI chọrọ iziga ozi, Nebo na-akpọ
Send()na envelopu ozi v1 - 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_id | UUID v7 | ID pụrụ iche a haziri site n'oge |
channel_id | {type}:{platform_id} | Njirimara ọwa a pụrụ izigharị |
sender | object | Njirimara bot — aha, ọrụ, botId |
text | string | Ahụ ozi |
attachments | array | Faịlụ, foto, ụda |
reply_to | UUID v7 | ID ozi nne maka threading |
actions | array | Bọtịnụ/kibọọdụ mmekọrịta |
platform_data | bytes | Ngafe na-adịghị ahụ anya maka atụmatụ kpọmkwem ikpo okwu |
timestamp | ISO 8601 | Onye 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.
| Mpaghara | Nkọwa |
|---|---|
from | ID onye ọrụ na-eziga |
to | ID onye ọrụ na-anata |
topic | Isiokwu/ọwa ozi |
type | "message", "mention", "proposal", "command", "info", "task" |
content | Ahụ ozi |
Omume ndị bụ isi:
Registerna-ama ọkwa onye ọrụ AI a na netwọk ya na ikike yaSubscribe/Unsubscribena-ejikwa ndenye aha isiokwuReceivena-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ịnaya | Nkọwa |
|---|---|---|
"text" | Iberibe ederede | Token ederede na-asọ asọ |
"tool_call" | JSON | Ụdị ahụ chọrọ ịkpọ ngwaọrụ |
"thinking" | Iberibe ederede | Echiche/ntụgharị uche agbatịrị |
"error" | Ozi njehie | Ihe mebiri |
"done" | Efu | Iyi 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ọ | Usoro | Ebumnuche |
|---|---|---|
GET /api/v1/apps/{id}/ui/* | Sava faịlụ na-adịghị agbanwe | Na-enye faịlụ site na ndekọ ui/ gị (nlọghachi SPA gaa na index.html) |
ANY /api/v1/apps/{id}/api/* | Proxy gRPC | Na-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 Triggersbụ 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 kacha | Nkọwa |
|---|---|---|
manifest.json | 1 MB | Metadata ngwa |
binary ma ọ bụ app | 500 MB | Mmemme |
signatures.json | 1 MB | Mbịanye aka Ed25519 |
TOOL.md | 1 MB | Ntụ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
- Debanye akaụntụ NeboAI na
POST /api/v1/owners/register - Banye iji nweta token JWT:
POST /api/v1/owners/login - 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
- Nnyocha akpaghị aka — a na-enyocha binary site na VirusTotal
- Nyocha onye nchịkwa — otu NeboAI na-enyocha metadata, manifest, na nsonaazụ nnyocha
- Mgbe a kwadoro ya — NeboAI na-eji Ed25519 bịanye aka na ngwa ahụ ma bipụta ya
- 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
- Melite ụdị ngwa ahụ:
PUT /api/v1/developer/apps/{id}ya na ụdị ọhụrụ ahụ - Bulite binary ọhụrụ maka ikpo okwu ọ bụla
- 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
| Mpaghara | Nkọwa |
|---|---|
category | dịka, productivity, communication, developer-tools |
icon | URL akara ngosi ngwa |
visibility | public 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ị:
- Mepụta folda ngwa gị:
mkdir -p ~/Library/Application\ Support/Nebo/apps/com.example.myapp - Dee
manifest.jsonna koodu gị - Wuo binary gị:
go build -o ~/Library/Application\ Support/Nebo/apps/com.example.myapp/binary . - Nebo na-achọpụta ndekọ ọhụrụ ahụ n'onwe ya (ma ọ bụ malitegharịa Nebo)
- 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.logmaka 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_DATAmaka 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
| Nka | Ngwa | |
|---|---|---|
| Ụdị | Markdown (SKILL.md) | Binary e chịkọtara (.napp) |
| Oge ọ na-agba | A na-etinye ya na ntụziaka sistemụ | Usoro sandbox n'elu gRPC |
| Na-enye | Nduzi omume, usoro | Ngwaọrụ, ọwa, panel UI |
| Ogologo ndụ | Ọ dị n'oge mkparịta ụka, ọ na-agwụ dabere na TTL | Na-agba mgbe niile |
| Imepụta | Dee faịlụ markdown | Dee, chịkọta, bịanye aka, kechie |
| Nchekwa | Achọghị ikike | Sandbox 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ụ).
| Mpaghara | Achọrọ | Ndabara | Nkọwa |
|---|---|---|---|
name | Ee | — | Njirimara pụrụ iche (ọ na-aghọ slug) |
description | Ee | — | Nkọwa otu ahịrị a na-egosi na katalọgụ nka |
version | Mba | "1.0.0" | Semver maka nsochi mmelite |
author | Mba | — | Onye dere nka |
priority | Mba | 0 | Ka elu = a na-ebu ụzọ dabara ya (100+ maka nnọchi dị oke mkpa) |
max_turns | Mba | 4 | Ntụgharị enweghị ọrụ tupu ọ gwụ n'onwe ya |
triggers | Mba | [] | 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) |
tools | Mba | [] | Ngwaọrụ nka a na-atụ anya iji (maka ozi) |
dependencies | Mba | [] | Nka ndị ọzọ a ga-awụnyerịrị |
tags | Mba | [] | Maka nkewa na nchọpụta |
platform | Mba | [] | 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:
| Omume | Nkọwa | Ihe atụ |
|---|---|---|
catalog | Depụta nka niile dị | skill(action: "catalog") |
load | Mee ka ọ rụọ ọrụ maka oge mkparịta ụka a | skill(name: "code-review", action: "load") |
unload | Kwụsị nka | skill(name: "code-review", action: "unload") |
create | Mepụta nka ọhụrụ na diski | skill(action: "create", content: "...") |
update | Melite nka dị adị | skill(name: "my-skill", action: "update", content: "...") |
delete | Hichapụ nka na diski | skill(name: "my-skill", action: "delete") |
Ide ezigbo nka
Ezigbo ndebiri nka nwere:
- Isiokwu doro anya — na-agwa onye ọrụ AI ọnọdụ ọ nọ na ya
- Ụkpụrụ ndị bụ isi — iwu omume a na-agaghị ịgbanwe
- Usoro — ụzọ nzọụkwụ na nzọụkwụ maka ọnọdụ ndị a na-ahụkarị
- Ihe atụ — usoro doro anya site n'ozi onye ọrụ ruo azịza
- 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ị:
| Nka | Mkpa | Nkọwa |
|---|---|---|
onboarding | 100 | Ekele onye ọrụ ọhụrụ na nchịkọta profaịlụ |
best-friend | 50 | Nka àgwà — dị nwayọọ, kwesịrị ntụkwasị obi, okwu eziokwu |
debugging | 25 | Usoro nchọpụta nsogbu a haziri ahazi |
api-design | 15 | Omume kacha mma maka imewe RESTful API |
code-review | 10 | Nyocha koodu a haziri ahazi nwere ọkwa njọ |
database-expert | 10 | Imewe nchekwa data, ajụjụ, nkwalite |
git-workflow | 10 | Alaka Git, commit, usoro ọrụ PR |
security-audit | 10 | Nyocha 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.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 |
Ọrụ ọ bụla gụnyere RPC HealthCheck na Configure. SDK na-elekọta ha abụọ n'onwe ya.
Ụdị Proto ọwa
| Ụdị ozi | Nkọwa |
|---|---|
ChannelSendRequest | Envelopu ozi na-apụ nwere message_id, channelId, sender, text, attachments, reply_to, actions, platform_data |
ChannelSendResponse | ID ozi ikpo okwu maka threading |
InboundMessage | Envelopu ozi na-abata nwere mpaghara niile a na-ekekọrịta + timestamp |
MessageSender | Njirimara bot (name, role, botId) — onye ogbugbo na-emeju ya |
Attachment | Ihe mgbakwunye faịlụ/foto/ụda (type, url, filename, size) |
MessageAction | Omume 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".