ተሰኪዎች እንዴት እንደሚሠሩ
ተሰኪ የሚተገበር ፋይል እና ማኒፌስት ነው። Nebo በጥሪዎች መካከል ምንም የተሰኪ ሂደት እንዲሠራ አያቆይም። አንድ ሰራተኛ ተሰኪውን በተጠቀመ ቁጥር Nebo ባይነሪውን በትዕዛዝ እና በነጋሪ እሴቶች ያስጀምራል፣ እስኪወጣ ይጠብቃል፣ ውፅዓቱንም ለሰራተኛው መልሶ ይሰጣል።
- ትዕዛዞች ነጋሪ እሴቶች ናቸው። ሰራተኛው እንደ
notes searchያለ ትዕዛዝ እና የተሰየሙ ነጋሪ እሴቶችን ይመርጣል። Nebo እያንዳንዱን ነጋሪ እሴት እንደ--name valueያስተላልፋል። ሼል ስለሌለ ፓይፖች እና ማዘዋወሪያዎች በጭራሽ አይሠሩም። - ውፅዓት stdout ነው። ውጤቶችን ወደ stdout ይጻፉ። JSON በደንብ ይሠራል።
- ለተራ ጥሪዎች መደበኛ ግብዓት ዝግ ነው። መንጠቆዎች፣ መስመሮች እና የውይይት አቅራቢዎች stdinን ይጠቀማሉ፤ የplugin.json ማጣቀሻን ይመልከቱ።
እያንዳንዱ የተጫነ እና የነቃ ተሰኪ ለሰራተኞች plugin__<slug> የተባለ አንድ መሣሪያ ሆኖ ይታያል። ሰራተኛ እንዲህ ይጠራዋል፦
{
"command": "notes search",
"args": { "query": "quarterly plan", "limit": "5" },
"display": "Search notes for the quarterly plan"
} Nebo የሚያሄደው፦
notes-sync notes search --query "quarterly plan" --limit 5
| መለኪያ | ዓይነት | ትርጉም |
|---|---|---|
command | ሕብረቁምፊ፣ ግዴታ | የተሰኪው ትዕዛዝ እና ማንኛውም በቦታቸው የሚቀመጡ ቃላት። |
args | የሕብረቁምፊዎች ኦብጀክት | የተሰየሙ ነጋሪ እሴቶች። እያንዳንዱ --key value ይሆናል። |
timeout | integer | የሚጠበቁ ሰከንዶች። ነባሪው 120 ነው፣ በማኒፌስቱ permissions.maxTimeoutSeconds የተገደበ። |
display | string | ጥሪው ማጽደቅ ሲያስፈልገው ባለቤቱ የሚያየው ዓረፍተ ነገር። |
የመጀመሪያ ተሰኪዎን ይገንቡ
ትዕዛዙን ከነጋሪ እሴቶቹ የሚያነብ እና ውጤት የሚያትም ባይነሪ በማንኛውም ቋንቋ ይጻፉ። ከዚያ በአንድ ቦት የተጠቃሚ ተሰኪዎች አቃፊ ውስጥ ከplugin.json አጠገብ ያስቀምጡት።
<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 እና platforms ግዴታ ናቸው። በተጠቃሚ ተሰኪዎች አቃፊ ውስጥ የplatforms ካርታ ባዶ ሊሆን ይችላል፦ Nebo በslugው የተሰየመ ባይነሪ ከplugin.json አጠገብ፣ ከዚያም በtarget/release/ እና በtarget/debug/ ውስጥ ይፈልጋል። ሲያትሙ የገበያ ቦታው ለሚሰቅሉት እያንዳንዱ ባይነሪ platformsን ይሞላል።
<data> በmacOS ላይ ~/Library/Application Support/Nebo፣ በWindows ላይ %APPDATA%\Nebo፣ በLinux ላይ ደግሞ ~/.local/share/nebo ነው፣ ወይም የNEBO_HOME እሴት። በተጠቃሚ አቃፊው ውስጥ ያለ ተሰኪ ተመሳሳይ slug ያለውን የገበያ ቦታ ተሰኪ ይሽራል፣ ስለዚህ አዲስ ግንባታ ለመፈተሽ ትክክለኛው ቦታ እሱ ነው።
ሰራተኞች እንዲጠቀሙበት ያስተምሩ
ከplugin.json አጠገብ የskills/ አቃፊ ያስቀምጡ። በውስጡ ያለ እያንዳንዱ ክህሎት ተሰኪው ተጭኖ እስካለ ድረስ ለእያንዳንዱ ሰራተኛ ይገኛል፣ ተሰኪውንም በራስ-ሰር እንደ ጥገኝነት ይዘረዝራል። ምን ትዕዛዞች እንዳሉ፣ ምን እንደሚመልሱ እና እያንዳንዱን መቼ መጠቀም እንዳለበት ለመናገር ክህሎቱን ይጠቀሙ። የተሰኪው የመሣሪያ መግለጫ መጀመሪያ ወደ እነሱ እንዲጠቁም በጣም ጠቃሚ የሆኑትን ክህሎቶች በentrySkills ውስጥ ይሰይሙ።
የገበያ ቦታ ዝርዝሩ PLUGIN.md የተባለ የተለየ ፋይል ነው። Nebo በሚሄድበት ጊዜ አያነበውም፤ ሰዎች ከመጫናቸው በፊት የሚያዩት ገጽ ነው። ተሰኪን ማስረከብን ይመልከቱ።
አካባቢ
እያንዳንዱ ጥሪ የጫኚ እና የሼል ማስገቢያ ተለዋዋጮች ተወግደው የቦቱን አካባቢ ይወርሳል፣ ከዚያም እነዚህን እሴቶች ያክላል። በኋላ የሚመጡት ግቤቶች ቅድሚያ ያገኛሉ።
| ተለዋዋጭ | እሴት |
|---|---|
የauth.env ቁልፎች | ከማኒፌስቱ የሚመጡ ነባሪዎች። |
<SLUG>_BIN | የዚህ ተሰኪ ባይነሪ ዱካ፣ እንዲሁም የሚደገፍባቸው የእያንዳንዱ ተሰኪ ዱካ። slugው በትልቅ ፊደላት ይጻፋል፣ ሰረዞችም በታችኛው ሰረዝ ይተካሉ። |
NEBO_DATA_DIR | የተሰኪው የራሱ የውሂብ አቃፊ፣ <data>/appdata/plugins/<slug>/። እሱም የሥራ አቃፊው ነው፣ ከማራገፍ በኋላም ይቆያል። |
PATH | መጀመሪያ የተሰኪ አቃፊዎች፣ ከዚያ የተወረሰው ዱካ። |
| ቅንብሮች | ባለቤቱ ለconfigSchema መስኮች ያስቀመጣቸው እሴቶች። |
NEBO_AGENT_ID | ጥሪውን የሚያደርገው ሰራተኛ። |
profileDirEnv | ተሰኪው መለያዎችን ሲደግፍ፣ የዚህ ሰራተኛ እና መለያ የመለያ አቃፊ። |
permissions.envAllow እና permissions.envDeny ተሰኪው ከቦቱ የሚወርሰውን ያጠባሉ። የተሰኪውን የራሱን የማረጋገጫ ተለዋዋጮች በጭራሽ አያስወግዱም።
መለያዎች እና የመግቢያ መረጃዎች
ወደ አገልግሎት የሚገባ ተሰኪ ለእያንዳንዱ ሰራተኛ አንድ መለያ መያዝ አለበት። የሂሳብ ሠራተኛው በፋይናንስ መግቢያው፣ ረዳቱ ደግሞ በራሱ መግቢያ ይገባል፣ አንዳቸውም የሌላውን ቶከኖች አያዩም። ይህን በማኒፌስቱ ውስጥ ያሳውቃሉ፤ የቀረውን Nebo ይሠራል።
"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.envየመግቢያ መረጃዎችን ይሰይማል።capabilities.configSchemaስያሜ ይሰጣቸዋል፣ በማገናኛ ቅጹ ውስጥ ያላቸውን ቅደም ተከተልም ያዘጋጃል።auth.profileDirEnvተሰኪዎ ለመግቢያ መረጃ አቃፊው የሚያነበውን ተለዋዋጭ ይሰይማል። Nebo ለእያንዳንዱ ሰራተኛ እና መለያ አንድ አቃፊ ይፈጥራል፣ ያንንም ተለዋዋጭ በእያንዳንዱ ጥሪ ላይ ያዘጋጃል።- ባለቤቱ መለያን ሲያገናኝ Nebo የእርስዎን
loginትዕዛዝ ባለቤቱ በተየባቸው እሴቶች እና በተዘጋጀው የመለያ አቃፊ ያሄዳል። ተሰኪዎ የሚያስፈልገውን በዚያ አቃፊ ውስጥ ያስቀምጣል። Nebo እሴቶቹን አያቆይም። - የእርስዎ
statusትዕዛዝ እንደ{"authenticated": true}ያለ JSON ያትማል። ቶከን ጊዜው ሲያልፍ፣refreshካወጁ Nebo ያሂደዋል።
ለአሳሽ መግቢያ typeን ወደ oauth_cli ያዘጋጁ፣ loginም የአቅራቢውን የመግቢያ URL እንዲያትም ወይም እንዲከፍት ያድርጉ። ሰራተኞች በራሳቸው በጭራሽ አይገቡም፦ ጥሪ መግቢያ ሲያስፈልገው ባለቤቱ የማገናኛ ካርድ ያያል። በርካታ መለያዎች ያሉት ሰራተኛ በትዕዛዝ ላይ --account <label> በማከል አንዱን ይመርጣል። Nebo ባይነሪዎ ከማየቱ በፊት ያንን ባንዲራ ያስወግዳል።
ቅርጹን ሳይሆን አገልግሎቱን ይሰይሙ። የተሰኪ ስም የሚገናኝበትን ነገር ይናገራል፣ ለምሳሌ "Example Notes"። በተሰኪ ስም ውስጥ "CLI" በጭራሽ አያስገቡ፤ ለሰራተኞች እና ለባለቤቶች ግንኙነት እንጂ የትዕዛዝ መስመር አይደለም።
ቀጣይ
- የplugin.json ማጣቀሻ፦ ክስተቶችን፣ መንጠቆዎችን እና ዓይነት ያላቸው ክንውኖችን ጨምሮ እያንዳንዱ መስክ።
- ተሰኪን ማስረከብ፦ መድረኮች፣ ባይነሪዎች፣ መፈረም እና ዝማኔዎች።
- ማተም፦ ለእያንዳንዱ ዓይነት ሥራ የገበያ ቦታው ሂደት።