Kora yvategua
| Kora | Mba'éichagua | Tekotevẽ | He'iséva |
|---|---|---|---|
id | string | héẽ | Plugin mba'ehechaukaha ñemuhápe. Eiporu slug rembosako'i aja. |
slug | string | héẽ | Mba'ehechaukaha ndoiambuéiva. [a-z0-9-], 64 carácter peve, ndaipóri guion ñepyrũme, pahápe térã mokõi oñondive. Ombohéra tembiporu plugin__<slug> ha variable <SLUG>_BIN. |
name | string | héẽ | Téra ojehechaukáva. Embohéra pe servicio ojoajúvape. |
version | string | héẽ | Peteĩchagua semántica, ha'eháicha 0.1.0. |
platforms | map | héẽ | Clave plataforma rehegua binario-pe. Ehecha Plataforma-kuéra. |
description | string | nahániri | Peteĩ ñe'ẽjoaju yvypórape ha mba'apoharakuérape g̃uarã. |
author | string | nahániri | Moherakuãhára réra. |
category | string | nahániri | Oipytyvõ mba'apoharakuérape ojuhu hag̃ua plugin. |
triggers | ñe'ẽjoaju lista | nahániri | Ñe'ẽ omombe'úva araka'épa plugin oñeikotevẽ. Ojeporu jeheka ñe'ẽpykĩme. |
entrySkills | ñe'ẽjoaju lista | nahániri | Katupyry oñembojoajúva oñembohéra raẽ hag̃ua plugin tembiporu ñemyesakãme. |
dependencies | {name, version, optional} lista | nahániri | Ambue plugin ko plugin omomba'apóva. version ijypykuéva ha'e "*"; optional ha'e false. Umi <SLUG>_BIN rape oñemoĩ opa ñehenóime. |
auth | object | nahániri | Jeike ha kuénta-kuéra. Ehecha Jeike. |
capabilities | object | nahániri | configSchema, hooks, commands, routes, providers. |
permissions | object | nahániri | Entorno ñemboguaku ha timeout yvatevéva. |
events | list | nahániri | Ñangarekoha omongaruva mba'apoharakuéra tembiaporape. |
interfaceBindings | map | nahániri | Tembiapo tipo reheguáva plugin ome'ẽva. |
channel | object | nahániri | Peteĩ joaju opytáva peteĩ servicio ñe'ẽmondo rehegua ndive. |
setup | object | nahániri | Peteĩ asistente de configuración pasoha pasoha. |
Nebo ohecha ñemuha guive ñemohenda: slug léi, peteĩchagua semántica, sa'ivévo peteĩ plataforma, peteĩ binaryName ndorekóiva separador rape térã .., peteĩ tembiapoukapy login ndaha'éirõ auth.type env, jehu réra ha tembiapoukapy nandi'ỹva, ha binding plantilla oñeanalisakuaáva. Plugin oĩva puruhára plugin ñongatuhápe ndohasái ko jehecha.
Plataforma-kuéra
Clave-kuéra ha'e darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 ha windows-amd64. Peteĩteĩ entrada oguereko opa po kora oĩva iguýpe. Removerakuã jave, ñemuha ohai hash, tamaño, firma ha mboguejyha URL añetegua, upévare eheja nandi umi marandurenda rembohupívape.
"platforms": {
"darwin-arm64": { "binaryName": "notes-sync", "sha256": "", "signature": "", "size": 0, "downloadUrl": "" },
"linux-amd64": { "binaryName": "notes-sync", "sha256": "", "signature": "", "size": 0, "downloadUrl": "" },
"windows-amd64": { "binaryName": "notes-sync.exe", "sha256": "", "signature": "", "size": 0, "downloadUrl": "" }
} | Kora | He'iséva |
|---|---|
binaryName | Ejecutable marandurenda réra. Emoĩ .exe Windows-pe. |
sha256 | Binario hash. Ojehecha ñemohenda jave. |
signature | Binario firma. Ojehecha ñemohenda jave oĩ jave peteĩ clave firma rehegua. |
size | Tamaño byte-pe. |
downloadUrl | Moõpa Nebo omboguejy paquete. |
Jeike
| Kora | He'iséva |
|---|---|
type | oauth_cli jeike navegador rupi plugin omomba'apóvape g̃uarã; env credencial oñemoĩva valor ramo; neboai ohupyty hag̃ua jára token NeboAI opa clave auth.env opáva _TOKEN-pe. |
env | Mapa variable réra valor ijypykuévape. Avei ha'e umi credencial réra añoite Nebo ome'ẽva login-pe. |
commands.login | Oike. Tekotevẽ ndaha'éirõ type env. Omba'apo kuénta ñongatuha oñemoĩmava ndive. |
commands.status | Ohai JSON he'íva kuénta oikepa. |
commands.refresh | Ombopyahu peteĩ token ndojeikotevẽi ñemba'apo. |
commands.logout | Osẽ kuéntagui. Jára añoite ikatu omomba'apo. |
profileDirEnv | Variable ohupytýva peteĩ ñongatuha credencial-pe g̃uarã peteĩteĩ mba'apohára ha kuéntape. Ko'ỹre plugin oguereko peteĩ kuénta oñemboja'opáva. |
label, description | Moñe'ẽrã tarjeta joaju reheguápe. |
help | {url, urlLabel, text} ojehechaukáva ojoaju aja. |
publicRedirect | Emoĩ true proveedor ndoipotáiramo redirección http://localhost-pe; upéicharõ jeike ohasa NeboAI redirección pública rupi. |
Nebo omoñe'ẽ peteĩha oĩva ko'ã apytépe: authenticated, isAuthenticated, logged_in, loggedIn térã token_valid estado salida-pe. Peteĩ token_error nandi'ỹva, térã valor none credential_source, auth_method, storage térã status-pe, he'ise osẽma kuéntagui. Estado tembiapoukapy oguereko 45 segundo.
{"authenticated": true, "account": "finance@example.com"} configSchema
capabilities.configSchema omombe'u umi valor jára omoĩva plugin-pe g̃uarã. Peteĩteĩ valor oguahẽ binario-pe variable de entorno ramo, key ombohérava. Clave credencial reheguáva oĩvape avei auth.env-pe, esquema ombohéra kora formulario joaju rehegua peteĩteĩ mba'apohárape g̃uarã.
| Kora | Mba'éichagua | Ijypykuéva | He'iséva |
|---|---|---|---|
key | string | tekotevẽ | Variable de entorno réra. |
label | string | tekotevẽ | Kora réra. |
description | string | "" | Moñe'ẽrã pytyvõrã. |
fieldType | string | "string" | Entrada mba'éichagua, ha'eháicha string, number, boolean, select térã password. |
default | string | mba'eve | Valor oñemyenyhẽmava. |
required | boolean | false | Plugin noĩri listo valor oñemoĩ peve. |
secret | boolean | false | Valor oñemokañy oñemoñe'ẽjey jave. |
options | ñe'ẽjoaju lista | mba'eve | Jeporavorã select-pe g̃uarã. |
permissions
| Kora | Ijypykuéva | He'iséva |
|---|---|---|
envAllow | [] | Variable oñepyhy ypykuégui plugin ikatúva ohecha. Nandi ramo opavave oñemoneĩ. |
envDeny | [] | Variable oñepyhy ypykuégui ojeipe'akuaáva tapiaite. |
maxTimeoutSeconds | 300 | Ijyvatevéva oimeraẽ ñehenói timeout-pe g̃uarã. |
network | false | Omombe'u ñandutí jeporu. Marandu ramo añoite; ndojejapokatúi. |
events
Peteĩ jehu ha'e peteĩ ñangarekoha omba'apóva are. Nebo omoñepyrũ peteĩ mba'apohára tembiaporape omaña jave hese, ha omoñepyrũjey opytárõ. Peteĩteĩ tysýi ñangarekoha ohaíva stdout-pe ha'e peteĩ jehu. Jehu réra oguereko slug tenondépe omba'apo jave, upévare note.created oiko notes-sync.note.created.
"events": [
{
"name": "note.created",
"description": "A note was created in the watched notebook.",
"command": "watch --notebook {{notebook}} --format ndjson"
}
] | Kora | He'iséva |
|---|---|
name | Jehu réra, slug'ỹre. Tekotevẽ. |
command | Argumento omoñepyrũva ñangarekoha. Tekotevẽ. {{key}} oñemyengovia mba'apohára entrada valor-kuéragui. |
description | Mba'épa omoheñói jehu. |
multiplexed | true jave, peteĩ ñangarekoha omondo heta jehu mba'éichagua ha peteĩteĩ tysýi oguereko kora "event". |
Tembiaporape-kuéra oñemboheraguapy jehu-kuérape peteĩ mbopu'ãha watch rupive. Ehecha Mbopu'ãha-kuéra.
interfaceBindings
Peteĩ binding ombojoaju peteĩ tembiapo interfaz rehegua ne tembiapoukapy peteĩme. Peteĩteĩ binding oiko tembiporu tipo reheguáva mba'apoharakuérape g̃uarã, oñembohéráva tembiapo rérape letra michĩme ha punto ha guion oiko guion guýpe: notes.search oiko notes_search. Binding-kuéra rupive peteĩ plugin omoañete umi pu'aka peteĩ mba'apohára oikotevẽva; ehecha Pu'aka-kuéra.
"interfaceBindings": {
"notes.search": "notes search --query {query} {tag[]:--tag} {limit?:--limit}",
"invoice.create": "invoices create --amount {amount_cents:cents->dollars}"
} | Marcador | Oiko |
|---|---|
{field} | Kora valor peteĩ ñe'ẽ ramo. Kora noñemondói avei flag ramo. |
{field[]:--flag} | Peteĩ --flag <item> peteĩteĩ mba'épe g̃uarã peteĩ kora lista-pe. |
{field?:--flag} | --flag <value> kora oĩ jave; mba'eve ndaipóri jave. |
{field:cents->dollars} | Peteĩ cantidad entero centavo-pe, ojehaíva dólar ramo. |
Kora entrada peteĩ plantilla ombohéra'ỹva oñembojoapy --field value ramo. Marcador lista ha poravopyrã ha'eva'erã ñe'ẽ henyhẽva. Peteĩ tembiapo oikotevẽva ñemoneĩ ndaikatúi ojehupyty pe tembiapoukapy peteĩchagua ojehenóirõ plugin__<slug> rupive.
Hook, slash command ha ruta
"capabilities": {
"hooks": [
{ "hook": "tool.post_execute", "hookType": "filter", "command": "hook redact", "priority": 50, "timeoutMs": 500 }
],
"commands": [
{ "name": "notes", "description": "Show today's notes", "command": "notes today", "slash": true }
],
"routes": [
{ "path": "/callback", "method": "GET", "command": "http callback" }
]
} hooks
Peteĩ hook omongu'e ne comando peteĩ momento-pe peteĩ mba'apohára jehasápe. Nebo ohai peteĩ payload JSON stdin-pe. Peteĩ hook action rehegua osẽva ndojehesaréi. Peteĩ hook filter ome'ẽ {"payload": ..., "handled": false}; "handled": true ojoko umi hook upe riregua. Jejavy ha tiempo opa oñongatu payload yma ha araka'eve ndojokói pe jehasa. Mbohapy jejavy oñondive rire, peteĩ hook opyta po aravo'i.
| Kora | Ijypykuéva | He'iséva |
|---|---|---|
hook | tekotevẽ | Peteĩ ko'ã apytégui: tool.pre_execute, tool.post_execute, message.post_receive, session.message_append, steering.generate, agent.turn, agent.should_continue. |
hookType | "action" | action térã filter. |
command | tekotevẽ | Argumento ne binario-pe g̃uarã. |
priority | 100 | Michĩvéva omba'apo raẽ. |
timeoutMs | 500 | Aravo pa'ũ milisegundo-pe. |
commands
"slash": true ndive, rehai jave /name args ñomongetápe omomba'apo command args pya'e, mba'apohára'ỹre. Salida ha'e mbohovái. Aravo pa'ũ ha'e 30 segundo.
routes
Peteĩ ruta ombohovái HTTP mba'ejerure /api/v1/plugins/<slug>/api/<path>-pe bot-pe, path ha method rupive. Mba'ejerure rete oho stdin-pe ha ne stdout ha'e mbohovái. Aravo pa'ũ ha'e 30 segundo.
providers
Peteĩ proveedor omoĩ peteĩ ypykue modelo ñomongeta rehegua. Emombe'u id, displayName, providerType, modelsCommand ha chatCommand. Nebo omondo peteĩ mba'ejerure ñomongeta rehegua JSON ramo stdin rupi chatCommand-pe ha omoñe'ẽ jehu oñemondóva JSON tysýi pyahu rupi oñemboja'óva ramo stdout-pe, 300 segundo peve. Ko'ág̃a ojeporu ñomongeta streaming añoite.
channel
Peteĩ canal ombojoaju peteĩ servicio ñe'ẽmondo rehegua. Nebo omomba'apo meme command, omoñe'ẽ ñe'ẽmondo oguahẽva istdout-gui ha ohai mbohovái istdin-pe, mokõivéva JSON tysýi pyahu rupi oñemboja'óva ramo.
| Kora | Ijypykuéva | He'iséva |
|---|---|---|
command | tekotevẽ | Argumento omoñepyrũva joaju. |
name, description | "" | Ojehechauka ñembohekópe. |
restartDelaySecs | 5 | Eha'arõ emoñepyrũjey mboyve oñembyai rire. |
shared | false | Peteĩ joaju opavave mba'apohárape g̃uarã; ñe'ẽmondo oñemondo mba'apohára réra rupive ha mbohovái oguereko peteĩteĩ mba'apohára identidad. |
needsLocalApi | false | Eme'ẽ joajúpe bot API rape local, peteĩ token ha mba'apohára id. Oñembogue, reikotevẽ'ỹrõ. |
setup
Peteĩ asistente ñemboheko rehegua ogueraha jára jehasa rupi peteĩ formulario añoite ndaikatúiva ohupyty. Valor oúva form jehasagui omyenyhẽ {{key}} umi argumento generate upe rireguápe. Valor oúva credentials jehasagui oñeñongatu plugin variable de entorno ramo.
"setup": {
"title": "Connect Example Chat",
"steps": [
{ "kind": "form", "title": "Bot name", "fields": [ { "key": "bot_name", "label": "Name", "required": true } ] },
{ "kind": "generate", "title": "App manifest", "command": "manifest", "args": ["--name", "{{bot_name}}"], "outputFormat": "yaml" },
{ "kind": "external", "title": "Create the app", "url": "https://example.com/apps", "urlLabel": "Open admin" },
{ "kind": "credentials", "title": "Paste the token", "fields": [ { "key": "EXAMPLE_CHAT_TOKEN", "label": "Token", "inputType": "password", "required": true } ], "verifyCommand": "auth status" }
]
} | Paso mba'éichagua | Kora-kuéra |
|---|---|
form | title, description, fields |
generate | title, description, command, args, outputFormat (yaml, json, toml, text), buttonLabel. Ohechauka tembiapoukapy salida rekopia hag̃ua. |
external | title, description, url, urlLabel, instructions |
credentials | title, description, fields, verifyCommand. Paso opa verifyCommand oiko porã jave. |
Kora-kuéra oguereko key, label, default, placeholder, maxLength, help, inputType (text, textarea, password) ha required.