Polia najvyššej úrovne
| Pole | Typ | Povinné | Význam |
|---|---|---|---|
id | string | áno | Identifikátor doplnku v obchode. Počas vývoja použite slug. |
slug | string | áno | Stály identifikátor. [a-z0-9-], najviac 64 znakov, bez spojovníka na začiatku či na konci a bez zdvojeného spojovníka. Určuje názov nástroja plugin__<slug> a premennej <SLUG>_BIN. |
name | string | áno | Zobrazovaný názov. Uveďte službu, ku ktorej sa pripája. |
version | string | áno | Sémantická verzia, napríklad 0.1.0. |
platforms | map | áno | Kľúč platformy priradený k binárnemu súboru. Pozrite Platformy. |
description | string | nie | Jedna veta pre ľudí aj zamestnancov. |
author | string | nie | Názov vydavateľa. |
category | string | nie | Pomáha zamestnancom doplnok nájsť. |
triggers | zoznam reťazcov | nie | Slová, ktoré opisujú, kedy sa doplnok uplatní. Používajú sa v tipoch pri vyhľadávaní. |
entrySkills | zoznam reťazcov | nie | Pribalené zručnosti, ktoré sa v popise nástroja doplnku uvedú ako prvé. |
dependencies | zoznam {name, version, optional} | nie | Ďalšie doplnky, ktoré tento doplnok spúšťa. version má predvolenú hodnotu "*"; optional hodnotu false. Ich cesty <SLUG>_BIN sa nastavia pri každom volaní. |
auth | object | nie | Prihlásenie a účty. Pozrite Overovanie. |
capabilities | object | nie | configSchema, hooks, commands, routes, providers. |
permissions | object | nie | Filtrovanie prostredia a horná hranica časového limitu. |
events | list | nie | Sledovače, ktoré napájajú pracovné postupy zamestnancov. |
interfaceBindings | map | nie | Typové operácie, ktoré doplnok poskytuje. |
channel | object | nie | Trvalý most k službe na posielanie správ. |
setup | object | nie | Podrobný sprievodca nastavením. |
Nebo overuje inštalácie z obchodu: pravidlá pre slug, sémantickú verziu, aspoň jednu platformu, binaryName bez oddeľovačov cesty a bez .., príkaz login, ak auth.type nie je env, neprázdne názvy udalostí a príkazy a šablóny väzieb, ktoré sa dajú spracovať. Doplnky v adresári používateľských doplnkov overovanie preskakujú.
Platformy
Kľúče sú darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 a windows-amd64. Každá položka má všetkých päť polí uvedených nižšie. Pri zverejnení obchod zapíše skutočný hash, veľkosť, podpis a URL na stiahnutie, preto ich v nahrávanom súbore nechajte prázdne.
"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": "" }
} | Pole | Význam |
|---|---|
binaryName | Názov spustiteľného súboru. Vo Windows pridajte .exe. |
sha256 | Hash binárneho súboru. Overuje sa pri inštalácii. |
signature | Podpis binárneho súboru. Overuje sa pri inštalácii, keď je k dispozícii podpisový kľúč. |
size | Veľkosť v bajtoch. |
downloadUrl | Odkiaľ Nebo stiahne balík. |
Overovanie
| Pole | Význam |
|---|---|
type | oauth_cli pre prihlásenie v prehliadači, ktoré riadi doplnok; env pre prihlasovacie údaje zadané ako hodnoty; neboai na prijatie tokenu NeboAI vlastníka v každom kľúči auth.env, ktorý končí na _TOKEN. |
env | Mapa názvov premenných na predvolené hodnoty. Zároveň jediné názvy prihlasovacích údajov, ktoré Nebo odovzdá príkazu login. |
commands.login | Prihlási. Povinné, ak type nie je env. Spúšťa sa s nastaveným priečinkom účtu. |
commands.status | Vypíše JSON, ktorý hovorí, či je účet prihlásený. |
commands.refresh | Obnoví token bez interakcie. |
commands.logout | Odhlási. Spustiť ho môže iba vlastník. |
profileDirEnv | Premenná, ktorá dostane samostatný priečinok s prihlasovacími údajmi pre každého zamestnanca a účet. Bez nej má doplnok jeden spoločný účet. |
label, description | Text na karte pripojenia. |
help | {url, urlLabel, text} zobrazené počas pripájania. |
publicRedirect | Nastavte true, keď poskytovateľ odmieta presmerovania na http://localhost; prihlásenie potom prebehne cez verejné presmerovanie NeboAI. |
Nebo vo výstupe stavu prečíta prvé z polí authenticated, isAuthenticated, logged_in, loggedIn alebo token_valid. Neprázdne token_error alebo hodnota none v credential_source, auth_method, storage či status znamená, že účet je odhlásený. Príkaz stavu má 45 sekúnd.
{"authenticated": true, "account": "finance@example.com"} configSchema
capabilities.configSchema opisuje hodnoty, ktoré vlastník pre doplnok nastaví. Každá hodnota sa k binárnemu súboru dostane ako premenná prostredia s názvom podľa key. Pri kľúčoch prihlasovacích údajov uvedených aj v auth.env schéma pomenúva polia formulára pripojenia pre jednotlivých zamestnancov.
| Pole | Typ | Predvolené | Význam |
|---|---|---|---|
key | string | povinné | Názov premennej prostredia. |
label | string | povinné | Označenie poľa. |
description | string | "" | Text pomocníka. |
fieldType | string | "string" | Typ vstupu, napríklad string, number, boolean, select alebo password. |
default | string | žiadne | Predvyplnená hodnota. |
required | boolean | false | Doplnok nie je pripravený, kým sa hodnota nenastaví. |
secret | boolean | false | Hodnota je pri spätnom načítaní skrytá. |
options | zoznam reťazcov | žiadne | Možnosti pre select. |
permissions
| Pole | Predvolené | Význam |
|---|---|---|
envAllow | [] | Zdedené premenné, ktoré doplnok smie vidieť. Prázdne povoľuje všetky. |
envDeny | [] | Zdedené premenné, ktoré sa vždy odstránia. |
maxTimeoutSeconds | 300 | Horná hranica časového limitu každého volania. |
network | false | Deklaruje používanie siete. Iba informatívne; nevynucuje sa. |
events
Udalosť je dlhodobo bežiaci sledovač. Nebo ho spustí, keď ho sleduje pracovný postup zamestnanca, a reštartuje ho, ak skončí. Každý riadok, ktorý sledovač zapíše na stdout, je jedna udalosť. Názov udalosti dostane pri behu predponu so slugom, takže z note.created sa stane notes-sync.note.created.
"events": [
{
"name": "note.created",
"description": "A note was created in the watched notebook.",
"command": "watch --notebook {{notebook}} --format ndjson"
}
] | Pole | Význam |
|---|---|
name | Názov udalosti bez slugu. Povinné. |
command | Argumenty, ktoré spúšťajú sledovač. Povinné. {{key}} sa nahradí vstupnými hodnotami zamestnanca. |
description | Čo udalosť vyvoláva. |
multiplexed | Pri true jeden sledovač vysiela viac typov udalostí a každý riadok obsahuje pole "event". |
Pracovné postupy sa na udalosti prihlasujú spúšťačom watch. Pozrite Spúšťače.
interfaceBindings
Väzba priraďuje operáciu rozhrania jednému z vašich príkazov. Z každej väzby sa stane typový nástroj pre zamestnancov, pomenovaný podľa operácie malými písmenami, s bodkami a spojovníkmi nahradenými podčiarkovníkmi: z notes.search sa stane notes_search. Väzbami doplnok spĺňa schopnosti, ktoré zamestnanec vyžaduje; pozrite Schopnosti.
"interfaceBindings": {
"notes.search": "notes search --query {query} {tag[]:--tag} {limit?:--limit}",
"invoice.create": "invoices create --amount {amount_cents:cents->dollars}"
} | Zástupný symbol | Rozvinie sa na |
|---|---|
{field} | Hodnota poľa ako jedno slovo. Pole sa zároveň neodovzdá ako prepínač. |
{field[]:--flag} | Jedna dvojica --flag <item> pre každú položku v poli so zoznamom. |
{field?:--flag} | --flag <value>, keď je pole prítomné; nič, keď chýba. |
{field:cents->dollars} | Celočíselná suma v centoch zapísaná v dolároch. |
Vstupné polia, ktoré šablóna neuvádza, sa pripoja ako --field value. Zástupné symboly zoznamov a voliteľných polí musia byť celé slová. K operácii, ktorá vyžaduje schválenie, sa nedá dostať volaním toho istého príkazu cez plugin__<slug>.
Háčiky, lomkové príkazy a trasy
"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
Hook spustí váš príkaz v určitom bode ťahu zamestnanca. Nebo zapíše JSON payload na stdin. Výstup hooku typu action sa ignoruje. Hook typu filter vráti {"payload": ..., "handled": false}; "handled": true zastaví ďalšie hooky. Chyby a vypršania časového limitu zachovajú predchádzajúci payload a nikdy neblokujú ťah. Po troch zlyhaniach za sebou sa hook na päť minút pozastaví.
| Pole | Predvolené | Význam |
|---|---|---|
hook | povinné | Jedno z tool.pre_execute, tool.post_execute, message.post_receive, session.message_append, steering.generate, agent.turn, agent.should_continue. |
hookType | "action" | action alebo filter. |
command | povinné | Argumenty pre váš binárny súbor. |
priority | 100 | Nižšie sa spustí skôr. |
timeoutMs | 500 | Časový limit v milisekundách. |
commands
S "slash": true sa po napísaní /name args do chatu priamo spustí command args, bez zamestnanca. Výstup je odpoveďou. Časový limit je 30 sekúnd.
routes
Trasa odpovedá na požiadavky HTTP na adrese /api/v1/plugins/<slug>/api/<path> na botovi, podľa zhody path a method. Telo požiadavky ide na stdin a váš stdout je odpoveďou. Časový limit je 30 sekúnd.
providers
Poskytovateľ pridáva zdroj chatových modelov. Deklarujte id, displayName, providerType, modelsCommand a chatCommand. Nebo pošle požiadavku na chat ako JSON na stdin príkazu chatCommand a streamované udalosti číta zo stdout ako JSON oddelený novými riadkami, najviac 300 sekúnd. Dnes sa používa iba streamovanie chatu.
channel
Kanál premosťuje službu na posielanie správ. Nebo udržiava command spustený, prichádzajúce správy číta z jeho stdout a odpovede zapisuje na jeho stdin, v oboch prípadoch ako JSON oddelený novými riadkami.
| Pole | Predvolené | Význam |
|---|---|---|
command | povinné | Argumenty, ktoré spúšťajú most. |
name, description | "" | Zobrazí sa v nastaveniach. |
restartDelaySecs | 5 | Čakanie pred reštartom po páde. |
shared | false | Jeden most pre všetkých zamestnancov; správy sa smerujú podľa mena zamestnanca a odpovede nesú identitu každého zamestnanca. |
needsLocalApi | false | Odovzdá mostu adresu lokálneho API bota, token a id zamestnanca. Vypnuté, pokiaľ to nepotrebujete. |
setup
Sprievodca nastavením prevedie vlastníka krokmi, ktoré jeden formulár nepokryje. Hodnoty z krokov form vypĺňajú {{key}} v neskorších argumentoch generate. Hodnoty z krokov credentials sa ukladajú ako premenné prostredia doplnku.
"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" }
]
} | Druh kroku | Polia |
|---|---|
form | title, description, fields |
generate | title, description, command, args, outputFormat (yaml, json, toml, text), buttonLabel. Zobrazí výstup príkazu na skopírovanie. |
external | title, description, url, urlLabel, instructions |
credentials | title, description, fields, verifyCommand. Krok sa dokončí, keď verifyCommand uspeje. |
Polia majú key, label, default, placeholder, maxLength, help, inputType (text, textarea, password) a required.