Fält på toppnivå
| Fält | Typ | Obligatoriskt | Betydelse |
|---|---|---|---|
id | string | ja | Pluginets identifierare på marknadsplatsen. Använd slug-värdet under utvecklingen. |
slug | string | ja | Stabil identifierare. [a-z0-9-], högst 64 tecken, inget inledande, avslutande eller dubbelt bindestreck. Namnger verktyget plugin__<slug> och variabeln <SLUG>_BIN. |
name | string | ja | Visningsnamn. Ange tjänsten det ansluter till. |
version | string | ja | Semantisk version, till exempel 0.1.0. |
platforms | map | ja | Plattformsnyckel till binärfil. Se Plattformar. |
description | string | nej | En mening för människor och medarbetare. |
author | string | nej | Utgivarens namn. |
category | string | nej | Hjälper medarbetare att hitta pluginet. |
triggers | lista med strängar | nej | Ord som beskriver när pluginet är aktuellt. Används i söktips. |
entrySkills | lista med strängar | nej | Medföljande färdigheter att nämna först i pluginets verktygsbeskrivning. |
dependencies | lista med {name, version, optional} | nej | Andra plugins som det här kör. version är som standard "*"; optional är false. Deras sökvägar <SLUG>_BIN sätts vid varje anrop. |
auth | object | nej | Inloggning och konton. Se Autentisering. |
capabilities | object | nej | configSchema, hooks, commands, routes, providers. |
permissions | object | nej | Miljöfiltrering och övre gräns för tidsgränsen. |
events | list | nej | Bevakare som matar medarbetarnas arbetsflöden. |
interfaceBindings | map | nej | Typade operationer som pluginet tillhandahåller. |
channel | object | nej | En beständig brygga till en meddelandetjänst. |
setup | object | nej | En installationsguide steg för steg. |
Nebo validerar installationer från marknadsplatsen: slug-reglerna, en semantisk version, minst en plattform, ett binaryName utan sökvägsavgränsare eller .., ett login-kommando om inte auth.type är env, händelsenamn och kommandon som inte är tomma, och bindningsmallar som går att tolka. Plugins i användarens plugin-katalog hoppar över valideringen.
Plattformar
Nycklarna är darwin-arm64, darwin-amd64, linux-arm64, linux-amd64, windows-arm64 och windows-amd64. Varje post har alla fem fälten nedan. När du publicerar skriver marknadsplatsen in den riktiga hashen, storleken, signaturen och nedladdningsadressen, så lämna dem tomma i filen du laddar upp.
"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": "" }
} | Fält | Betydelse |
|---|---|
binaryName | Den körbara filens namn. Lägg till .exe på Windows. |
sha256 | Binärfilens hash. Kontrolleras vid installation. |
signature | Binärfilens signatur. Kontrolleras vid installation när en signeringsnyckel finns. |
size | Storlek i byte. |
downloadUrl | Var Nebo laddar ner paketet. |
Autentisering
| Fält | Betydelse |
|---|---|
type | oauth_cli för en webbläsarinloggning som pluginet kör; env för inloggningsuppgifter som anges som värden; neboai för att få ägarens NeboAI-token i varje auth.env-nyckel som slutar på _TOKEN. |
env | Mappning från variabelnamn till standardvärde. Också de enda namn på inloggningsuppgifter som Nebo skickar till login. |
commands.login | Loggar in. Obligatoriskt om inte type är env. Körs med kontomappen angiven. |
commands.status | Skriver ut JSON som anger om kontot är inloggat. |
commands.refresh | Förnyar en token utan interaktion. |
commands.logout | Loggar ut. Bara ägaren kan köra det. |
profileDirEnv | Variabel som får en separat mapp för inloggningsuppgifter för varje medarbetare och konto. Utan den har pluginet ett enda delat konto. |
label, description | Text på anslutningskortet. |
help | {url, urlLabel, text} som visas under anslutningen. |
publicRedirect | Sätt true när leverantören vägrar omdirigeringar till http://localhost; inloggningen går då via NeboAI:s publika omdirigering. |
Nebo läser det första av authenticated, isAuthenticated, logged_in, loggedIn eller token_valid i statusutdata. En token_error som inte är tom, eller värdet none i credential_source, auth_method, storage eller status, betyder utloggad. Statuskommandot har 45 sekunder på sig.
{"authenticated": true, "account": "finance@example.com"} configSchema
capabilities.configSchema beskriver de värden en ägare anger för pluginet. Varje värde når binärfilen som en miljövariabel med det namn som key anger. För nycklar för inloggningsuppgifter som också listas i auth.env sätter schemat etiketter på fälten i anslutningsformuläret per medarbetare.
| Fält | Typ | Standard | Betydelse |
|---|---|---|---|
key | string | obligatoriskt | Miljövariabelns namn. |
label | string | obligatoriskt | Fältets etikett. |
description | string | "" | Hjälptext. |
fieldType | string | "string" | Inmatningstyp, till exempel string, number, boolean, select eller password. |
default | string | inget | Förifyllt värde. |
required | boolean | false | Pluginet är inte redo förrän värdet är angivet. |
secret | boolean | false | Värdet maskeras när det läses tillbaka. |
options | lista med strängar | inget | Val för select. |
permissions
| Fält | Standard | Betydelse |
|---|---|---|
envAllow | [] | Ärvda variabler som pluginet får se. Tomt tillåter alla. |
envDeny | [] | Ärvda variabler som alltid tas bort. |
maxTimeoutSeconds | 300 | Övre gräns för alla anrops tidsgräns. |
network | false | Anger nätverksanvändning. Informativt; tillämpas inte. |
events
En händelse är en långvarig bevakare. Nebo startar den när en medarbetares arbetsflöde bevakar den, och startar om den om den avslutas. Varje rad bevakaren skriver till stdout är en händelse. Händelsenamnet får slug-värdet som prefix vid körning, så note.created blir notes-sync.note.created.
"events": [
{
"name": "note.created",
"description": "A note was created in the watched notebook.",
"command": "watch --notebook {{notebook}} --format ndjson"
}
] | Fält | Betydelse |
|---|---|
name | Händelsenamn, utan slug-värdet. Obligatoriskt. |
command | Argument som startar bevakaren. Obligatoriskt. {{key}} ersätts med medarbetarens indatavärden. |
description | Vad som utlöser händelsen. |
multiplexed | När true sänder en bevakare flera händelsetyper och varje rad har ett "event"-fält. |
Arbetsflöden prenumererar på händelser med en watch-utlösare. Se Utlösare.
interfaceBindings
En bindning kopplar en gränssnittsoperation till ett av dina kommandon. Varje bindning blir ett typat verktyg för medarbetare, namngivet efter operationen med gemener och med punkter och bindestreck som understreck: notes.search blir notes_search. Bindningar är hur ett plugin uppfyller de förmågor som en medarbetare kräver; se Förmågor.
"interfaceBindings": {
"notes.search": "notes search --query {query} {tag[]:--tag} {limit?:--limit}",
"invoice.create": "invoices create --amount {amount_cents:cents->dollars}"
} | Platshållare | Expanderas till |
|---|---|
{field} | Fältets värde som ett ord. Fältet skickas inte också som flagga. |
{field[]:--flag} | Ett --flag <item>-par för varje objekt i ett listfält. |
{field?:--flag} | --flag <value> när fältet finns; ingenting när det saknas. |
{field:cents->dollars} | Ett heltalsbelopp i cent, skrivet som dollar. |
Indatafält som en mall inte namnger läggs till som --field value. List- och valfria platshållare måste vara hela ord. En operation som kräver godkännande går inte att nå genom att anropa samma kommando via plugin__<slug>.
Hooks, snedstreckskommandon och routes
"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
En hook kör ditt kommando vid en viss punkt i en medarbetares tur. Nebo skriver en JSON-nyttolast till stdin. Utdata från en action-hook ignoreras. En filter-hook returnerar {"payload": ..., "handled": false}; "handled": true stoppar senare hooks. Fel och timeouts behåller den föregående nyttolasten och blockerar aldrig turen. Efter tre misslyckanden i rad pausas en hook i fem minuter.
| Fält | Standard | Betydelse |
|---|---|---|
hook | obligatoriskt | En av tool.pre_execute, tool.post_execute, message.post_receive, session.message_append, steering.generate, agent.turn, agent.should_continue. |
hookType | "action" | action eller filter. |
command | obligatoriskt | Argument till din binärfil. |
priority | 100 | Lägre körs först. |
timeoutMs | 500 | Tidsgräns i millisekunder. |
commands
Med "slash": true kör /name args i chatten command args direkt, utan medarbetaren. Utdata är svaret. Tidsgränsen är 30 sekunder.
routes
En route besvarar HTTP-förfrågningar på /api/v1/plugins/<slug>/api/<path> på boten, matchade på path och method. Förfrågans innehåll går till stdin och din stdout är svaret. Tidsgränsen är 30 sekunder.
providers
En leverantör lägger till en källa för chattmodeller. Ange id, displayName, providerType, modelsCommand och chatCommand. Nebo skickar en chattförfrågan som JSON på stdin till chatCommand och läser strömmade händelser som radavgränsad JSON på stdout, i upp till 300 sekunder. I dag används bara strömmande chatt.
channel
En kanal bryggar en meddelandetjänst. Nebo håller command igång, läser inkommande meddelanden från dess stdout och skriver svar till dess stdin, båda som radavgränsad JSON.
| Fält | Standard | Betydelse |
|---|---|---|
command | obligatoriskt | Argument som startar bryggan. |
name, description | "" | Visas i inställningarna. |
restartDelaySecs | 5 | Väntetid innan omstart efter en krasch. |
shared | false | En brygga för alla medarbetare; meddelanden dirigeras efter medarbetarens namn och svaren bär varje medarbetares identitet. |
needsLocalApi | false | Ge bryggan botens lokala API-adress, en token och medarbetar-id:t. Av om du inte behöver det. |
setup
En installationsguide leder ägaren genom steg som ett enda formulär inte kan täcka. Värden från form-steg fyller i {{key}} i senare generate-argument. Värden från credentials-steg sparas som pluginets miljövariabler.
"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" }
]
} | Stegtyp | Fält |
|---|---|
form | title, description, fields |
generate | title, description, command, args, outputFormat (yaml, json, toml, text), buttonLabel. Visar kommandots utdata för kopiering. |
external | title, description, url, urlLabel, instructions |
credentials | title, description, fields, verifyCommand. Steget är klart när verifyCommand lyckas. |
Fälten har key, label, default, placeholder, maxLength, help, inputType (text, textarea, password) och required.