NeboAI
NeboAI
Qallariy

Pluginkuna

Huk pluginqa llamk'aqkunaman imatapas llamk'anankupaq qun: internetpi servicio, negociopa sistemanta, utaq computadorapi programa. Comando siqi binario hinam ruwanki, plugin.json manifiestowantaq willanki. Llamk'aqkunam comandonkunata waqyanku, Nebotaq instalayta, sapa llamk'aqpaq cuentakunata, musuqyachiykunatapas qhawan.

Imaynatam pluginkuna llamk'anku

Pluginqa huk purichikuq manifiestowanmi. Nebo manam waqyaykunapura ima plugin procesotapas purishaqta waqaychanchu. Huk llamk'aq pluginta llamk'achiptin, Nebo binariota huk comandowan argumentokunawan qallarichin, tukunankama suyan, lluqsisqantataq llamk'aqman kutichin.

  • Comandokunaqa argumentokunam. Llamk'aqmi huk comandota akllan, notes search hina, sutiyuq argumentokunatapas. Nebo sapa argumentota --name value hina pasachin. Manam shell kanchu, chayrayku pipekuna redireccionkunapas manam hayk'aqpas llamk'anchu.
  • Lluqsiyqa stdoutmi. Ruwasqakunata stdoutman qillqay. JSONqa allintam llamk'an.
  • Estándar yaykuyqa wichqasqam sapa kuti waqyaykunapaq. Hookkuna, ñankuna, chat proveedorkunapas stdintam llamk'achinku; plugin.json willakuy nisqata qhaway.

Sapa instalasqa hap'ichisqa pluginmi llamk'aqkunapaq plugin__<slug> sutiyuq huk llamk'ana hina rikurin. Huk llamk'aqqa kayhinam waqyan:

{
  "command": "notes search",
  "args": { "query": "quarterly plan", "limit": "5" },
  "display": "Search notes for the quarterly plan"
}

Nebo kayta purichin:

notes-sync notes search --query "quarterly plan" --limit 5
ParámetroTipoNinan
commandstring, mañakunPlugin comando hinaspa mayqin posicional simikunapas.
argsstring objetoSutiyuq argumentokuna. Sapankam --key value tukun.
timeoutintegerSuyana segundokuna. Ñawpaqmanta 120, manifiestopa permissions.maxTimeoutSeconds-ninwan k'atasqa.
displaystringWaqyay aprobacionta necesitaptin dueño rikusqan rimay.

Ñawpaq pluginniykita ruway

Mayqin simipipas huk binariota qillqay, argumentokunamanta comandonta ñawinchaspa huk ruwasqata qillqaq. Chaymanta huk botpa usuario plugin carpetanpi huk plugin.json-pa waqtanpi churay.

<data>/user/plugins/notes-sync/
├── plugin.json      # runtime manifest
├── notes-sync       # your binary, named after the slug
└── skills/          # optional: skills that teach employees to use it
    └── notes-sync/
        └── SKILL.md
{
  "id": "notes-sync",
  "slug": "notes-sync",
  "name": "Notes Sync",
  "version": "0.1.0",
  "description": "Search, read and create notes in Example Notes.",
  "platforms": {}
}

id, slug, name, version hinaspa platforms mañakunku. Usuario plugin carpetapiqa platforms mapaqa ch'usaqmi kanman: Nebo slugpa sutinwan binariota plugin.json-pa waqtanpi maskan, chaymanta target/release/ hinaspa target/debug/-pi. Publicaptiykiqa Mercadom cargasqayki sapa binariopaq platforms-ta hunt'an.

<data>-qa macOSpi ~/Library/Application Support/Nebo, Windowspi %APPDATA%\Nebo, Linuxpitaq ~/.local/share/nebo, utaq NEBO_HOME-pa valornin. Usuario carpetapi kaq pluginqa chay kikin slugniyuq Mercado pluginta tikran, chayraykum musuq ruwasqata pruebanapaq allin kaq.

Llamk'aqkunata llamk'achiyta yachachiy

plugin.json-pa waqtanpi huk skills/ carpetata churay. Chaypi kaq sapa atiymi plugin instalasqa kashaptin llapan llamk'aqkunapaq kan, kikinmantataq pluginta dependencia hina sutichan. Atiywan niy mayqin comandokuna kasqanta, ima kutichisqankuta, hayk'aq sapankata llamk'achinankupaqpas. Aswan allin atiykunata entrySkills-pi sutichiy, chhaynapi pluginpa llamk'ana willakuynin ñawpaqta paykunaman qhawachinanpaq.

Mercado willakuyqa sapaq archivom, PLUGIN.md. Nebo manam purishaspa ñawinchanchu; runakuna manaraq instalashaspa rikusqan paginam. Huk pluginta lluqsichiy nisqata qhaway.

Entorno

Sapa waqyaymi botpa entornonta herencian, loader hinaspa shell-injection variablekunata hurquspa, chaymantataq kay valorkunata yapan. Qhipa kaqkunam atipanku.

VariableValor
auth.env llavekunaManifiestomanta ñawpaqmanta valorkuna.
<SLUG>_BINKay pluginpa binarionpa ñannin, dependesqan sapa pluginpapas. Slugqa hatun letrakunapim, guionkunataq subrayado hina.
NEBO_DATA_DIRPluginpa kikin willakuy carpetan, <data>/appdata/plugins/<slug>/. Llamk'ana carpetapas kanmi, desinstalaypipas qhipallanmi.
PATHÑawpaqta plugin carpetakuna, chaymanta herenciamanta ñan.
AjustekunaconfigSchema campokunapaq dueño waqaychasqan valorkuna.
NEBO_AGENT_IDWaqyaq llamk'aq.
profileDirEnvKay llamk'aqpaq cuentapaqpas cuenta carpeta, plugin cuentakunata yanapaptin.

permissions.envAllow hinaspa permissions.envDeny botmanta plugin herenciasqanta k'iklluchanku. Manam hayk'aqpas pluginpa kikin auth variablenkunata hurqunkuchu.

Cuentakuna hinaspa credencialkuna

Huk servicioman yaykuq pluginqa sapa llamk'aqpaq huk cuentatam hap'inan. Contadorqa finanzas yaykuywanmi yaykun, asistentetaq kikinpawan, manataq mayqinpas hukninpa tokenninkunata rikunchu. Kaytaqa manifiestopim willanki; Nebotaq wakinta ruwan.

"auth": {
  "type": "env",
  "label": "Example Notes account",
  "env": { "EXAMPLE_NOTES_TOKEN": "" },
  "commands": { "login": "auth login", "status": "auth status", "logout": "auth logout" },
  "profileDirEnv": "EXAMPLE_NOTES_CONFIG_DIR"
},
"capabilities": {
  "configSchema": [
    { "key": "EXAMPLE_NOTES_TOKEN", "label": "API token", "fieldType": "password", "secret": true, "required": true }
  ]
}
  1. auth.env credencialkunata sutichan. capabilities.configSchema paykunata sutichan t'inkiy formulariopitaq ordenninta churan.
  2. auth.profileDirEnv pluginniyki credencial carpetanpaq ñawinchasqan variableta sutichan. Nebo sapa llamk'aqpaq sapa cuentapaqpas huk carpetata ruwan, sapa waqyaypitaq chay variableta churan.
  3. Dueño huk cuentata t'inkiptin, Nebo login comandoykita dueño qillqasqan valorkunawan, cuenta carpeta churasqawan purichin. Pluginniykim necesitasqanta chay carpetapi waqaychan. Nebo manam valorkunata waqaychanchu.
  4. status comandoykiqa {"authenticated": true} hina JSONtam imprimin. Huk token tukukuptinqa, Neboqa refresh nisqatam purichin huk willasqa kaptin.

Navegadorpi yaykunapaqqa type-ta oauth_cli-man churay, login-taq proveedorpa yaykuy URLninta qillqachun utaq kichachun. Llamk'aqkunaqa manam hayk'aqpas kikillanku yaykunkuchu: huk waqyay yaykuyta necesitaptin, dueñom t'inkiy tarjetata rikun. Achka cuentayuq llamk'aqqa hukninta akllan comandoman --account <label> yapaspa. Nebo manaraq binarioyki rikushaspa chay flagta hurqun.

Serviciota sutichiy, manam formantachu. Huk pluginpa sutinqa maymanchus t'inkikusqantam nin, "Example Notes" hina. Ama hayk'aqpas plugin sutipi "CLI" churaychu; llamk'aqkunapaq dueñokunapaqpas t'inkiymi, manam comando siqichu.

Qhipaman