Mba'éichapa omba'apo plugin-kuéra
Peteĩ plugin ha'e peteĩ ejecutable ha peteĩ manifiesto. Nebo nomomba'apói proceso plugin rehegua ñehenói pa'ũme. Peteĩ mba'apohára oipuru jave plugin, Nebo omoñepyrũ binario peteĩ tembiapoukapy ha argumento ndive, oha'arõ opa peve ha ome'ẽjey salida mba'apohárape.
- Tembiapoukapy ha'e argumento. Mba'apohára oiporavo peteĩ tembiapoukapy, ha'eháicha
notes search, ha argumento héravape. Nebo omondo peteĩteĩ argumento--name valueramo. Ndaipóri shell, upévare pipe ha redirección araka'eve ndojeporúi. - Salida ha'e stdout. Ehai mba'e osẽva stdout-pe. JSON omba'apo porã.
- Entrada estándar oñemboty ñehenói ojepivépe g̃uarã. Hook, ruta ha proveedor ñomongeta rehegua oipuru stdin; ehecha mba'ekuaarã plugin.json rehegua.
Opa plugin oñemohenda ha oñemyendýva ojehechauka mba'apoharakuérape peteĩ tembiporu ramo, héra plugin__<slug>. Peteĩ mba'apohára ohenói péicha:
{
"command": "notes search",
"args": { "query": "quarterly plan", "limit": "5" },
"display": "Search notes for the quarterly plan"
} Nebo omomba'apo:
notes-sync notes search --query "quarterly plan" --limit 5
| Parámetro | Mba'éichagua | He'iséva |
|---|---|---|
command | ñe'ẽjoaju, tekotevẽ | Plugin tembiapoukapy ha oimeraẽ ñe'ẽ posicional. |
args | ñe'ẽjoaju objeto | Argumento héravape. Peteĩteĩ oiko --key value. |
timeout | integer | Segundo oha'arõ hag̃ua. Ijypykuéva 120, manifiesto permissions.maxTimeoutSeconds omboguapýva. |
display | string | Ñe'ẽjoaju jára ohecháva ñehenói oikotevẽ jave ñemoneĩ. |
Ejapo ne plugin peteĩha
Ehai peteĩ binario oimeraẽ ñe'ẽme omoñe'ẽva itembiapoukapy argumento-kuéragui ha ohaíva peteĩ mba'e osẽva. Upéi emoĩ peteĩ plugin.json ykére peteĩ bot puruhára plugin ñongatuhápe.
<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 ha platforms tekotevẽ. Puruhára plugin ñongatuhápe mapa platforms ikatu nandi: Nebo oheka peteĩ binario slug rérava plugin.json ykére, upéi target/release/ ha target/debug/-pe. Removerakuã jave, ñemuha omyenyhẽ platforms opa binario rembohupívape g̃uarã.
<data> ha'e ~/Library/Application Support/Nebo macOS-pe, %APPDATA%\Nebo Windows-pe ha ~/.local/share/nebo Linux-pe, térã NEBO_HOME valor. Peteĩ plugin oĩva puruhára ñongatuhápe omyengovia peteĩ plugin ñemuhagua slug peteĩchagua reheguáva, upévare upépe reha'ãkuaa peteĩ build pyahu.
Embo'e mba'apoharakuérape oipuru hag̃ua
Emoĩ peteĩ ñongatuha skills/ plugin.json ykére. Peteĩteĩ katupyry oĩva ipype oĩ opa mba'apohárape g̃uarã plugin oñemohenda aja, ha ohechauka plugin dependencia ramo ijupe. Eiporu katupyry ere hag̃ua mba'e tembiapoukapýpa oĩ, mba'épa ome'ẽjey ha araka'épa ojeporu peteĩteĩ. Embohéra katupyry iporãvéva entrySkills-pe plugin tembiporu ñemyesakã ohechauka hag̃ua chupekuéra raẽ.
Ñemuha listado ha'e peteĩ marandurenda iñambuéva, PLUGIN.md. Nebo nomoñe'ẽi omba'apo jave; ha'e kuatiarogue yvypóra ohecháva omohenda mboyve. Ehecha Plugin ñemondo.
Entorno
Peteĩteĩ ñehenói ohupyty bot entorno, variable loader ha shell-injection rehegua ojeipe'ápe, upéi omoĩ ko'ã valor. Umi ipahaguéva ipu'akave.
| Variable | Valor |
|---|---|
Clave auth.env | Ijypykuéva manifiesto-gui. |
<SLUG>_BIN | Ko plugin binario rape, ha peteĩteĩ plugin oikotevẽvagui. Slug ojehai letra tuichávape ha guion oiko guion guýpe. |
NEBO_DATA_DIR | Plugin datos ñongatuha tee, <data>/appdata/plugins/<slug>/. Ha'e avei ñongatuha omba'apohápe, ha opyta oñenohẽ rire. |
PATH | Plugin ñongatuha raẽ, upéi rape oñepyhýva ypykuégui. |
| Ñemboheko | Valor jára oñongatúva kora configSchema-pe g̃uarã. |
NEBO_AGENT_ID | Mba'apohára ojapóva ñehenói. |
profileDirEnv | Kuénta ñongatuha ko mba'apohára ha kuéntape g̃uarã, plugin oipytyvõ jave kuénta-kuéra. |
permissions.envAllow ha permissions.envDeny omomichĩ mba'épa plugin ohupyty bot-gui. Araka'eve nonohẽi plugin variable jeike rehegua tee.
Kuénta ha credencial-kuéra
Peteĩ plugin oikéva peteĩ servicio-pe oguerekova'erã peteĩ kuénta peteĩteĩ mba'apohárape g̃uarã. Contador oike finanzas jeike ndive ha asistente ijeike tee ndive, ha mavave ndohechái ambue token. Remombe'u kóva manifiesto-pe; Nebo ojapo ambue.
"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 }
]
} auth.envombohéra credencial-kuéra.capabilities.configSchemaombohéra ha omoĩ hendápe formulario joaju reheguápe.auth.profileDirEnvombohéra variable ne plugin omoñe'ẽva iñongatuha credencial-pe g̃uarã. Nebo ojapo peteĩ ñongatuha peteĩteĩ mba'apohára ha kuéntape g̃uarã ha omoĩ upe variable opa ñehenóime.- Jára ombojoaju jave peteĩ kuénta, Nebo omomba'apo ne tembiapoukapy
loginumi valor jára ohaíva ha kuénta ñongatuha ndive. Ne plugin oñongatu upe ñongatuhápe oikotevẽva. Nebo noñongatúi umi valor. - Ne comando
statusohai JSON ha'eháicha{"authenticated": true}. Peteĩ token opa jave, Nebo omongu'erefreshremoĩramo peteĩ.
Jeike navegador rupi g̃uarã, emoĩ type oauth_cli-pe ha login ohai térã oipe'a proveedor jeike URL. Mba'apoharakuéra araka'eve ndoikéi ijeheguíne: peteĩ ñehenói oikotevẽ jave jeike, jára ohecha peteĩ tarjeta joaju rehegua. Peteĩ mba'apohára oguerekóva heta kuénta oiporavo peteĩ omoĩvo --account <label> peteĩ tembiapoukapýpe. Nebo onohẽ upe flag ne binario ohecha mboyve.
Embohéra servicio, ndaha'éi iforma. Peteĩ plugin réra he'i mba'épe ojoaju, ha'eháicha "Example Notes". Araka'eve ani emoĩ "CLI" peteĩ plugin rérape; mba'apohára ha járape g̃uarã ha'e peteĩ joaju, ndaha'éi peteĩ línea de comando.
Upéi
- Mba'ekuaarã plugin.json rehegua: opa kora, oikehápe jehu, hook ha tembiapo tipo reheguáva.
- Plugin ñemondo: plataforma, binario, firma ha ñembohekopyahu.
- Ñemoherakuã: ñemuha rape opa mba'e apopyrãme g̃uarã.