NeboAI
NeboAI
ይጀምሩ

ተሰኪዎች

ተሰኪ ለሰራተኞች የሚሠሩበትን ነገር ይሰጣቸዋል፦ የመስመር ላይ አገልግሎት፣ የንግድ ሥርዓት ወይም በኮምፒውተሩ ላይ ያለ ፕሮግራም። እንደ የትዕዛዝ መስመር ባይነሪ ይገነቡታል፣ በplugin.json ማኒፌስትም ይገልጹታል። ሰራተኞች ትዕዛዞቹን ይጠራሉ፣ Nebo ደግሞ መጫንን፣ የእያንዳንዱን ሰራተኛ መለያዎች እና ዝማኔዎችን ይንከባከባል።

ተሰኪዎች እንዴት እንደሚሠሩ

ተሰኪ የሚተገበር ፋይል እና ማኒፌስት ነው። 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 ይሆናል።
timeoutintegerየሚጠበቁ ሰከንዶች። ነባሪው 120 ነው፣ በማኒፌስቱ permissions.maxTimeoutSeconds የተገደበ።
displaystringጥሪው ማጽደቅ ሲያስፈልገው ባለቤቱ የሚያየው ዓረፍተ ነገር።

የመጀመሪያ ተሰኪዎን ይገንቡ

ትዕዛዙን ከነጋሪ እሴቶቹ የሚያነብ እና ውጤት የሚያትም ባይነሪ በማንኛውም ቋንቋ ይጻፉ። ከዚያ በአንድ ቦት የተጠቃሚ ተሰኪዎች አቃፊ ውስጥ ከ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 }
  ]
}
  1. auth.env የመግቢያ መረጃዎችን ይሰይማል። capabilities.configSchema ስያሜ ይሰጣቸዋል፣ በማገናኛ ቅጹ ውስጥ ያላቸውን ቅደም ተከተልም ያዘጋጃል።
  2. auth.profileDirEnv ተሰኪዎ ለመግቢያ መረጃ አቃፊው የሚያነበውን ተለዋዋጭ ይሰይማል። Nebo ለእያንዳንዱ ሰራተኛ እና መለያ አንድ አቃፊ ይፈጥራል፣ ያንንም ተለዋዋጭ በእያንዳንዱ ጥሪ ላይ ያዘጋጃል።
  3. ባለቤቱ መለያን ሲያገናኝ Nebo የእርስዎን login ትዕዛዝ ባለቤቱ በተየባቸው እሴቶች እና በተዘጋጀው የመለያ አቃፊ ያሄዳል። ተሰኪዎ የሚያስፈልገውን በዚያ አቃፊ ውስጥ ያስቀምጣል። Nebo እሴቶቹን አያቆይም።
  4. የእርስዎ status ትዕዛዝ እንደ {"authenticated": true} ያለ JSON ያትማል። ቶከን ጊዜው ሲያልፍ፣ refresh ካወጁ Nebo ያሂደዋል።

ለአሳሽ መግቢያ typeን ወደ oauth_cli ያዘጋጁ፣ loginም የአቅራቢውን የመግቢያ URL እንዲያትም ወይም እንዲከፍት ያድርጉ። ሰራተኞች በራሳቸው በጭራሽ አይገቡም፦ ጥሪ መግቢያ ሲያስፈልገው ባለቤቱ የማገናኛ ካርድ ያያል። በርካታ መለያዎች ያሉት ሰራተኛ በትዕዛዝ ላይ --account <label> በማከል አንዱን ይመርጣል። Nebo ባይነሪዎ ከማየቱ በፊት ያንን ባንዲራ ያስወግዳል።

ቅርጹን ሳይሆን አገልግሎቱን ይሰይሙ። የተሰኪ ስም የሚገናኝበትን ነገር ይናገራል፣ ለምሳሌ "Example Notes"። በተሰኪ ስም ውስጥ "CLI" በጭራሽ አያስገቡ፤ ለሰራተኞች እና ለባለቤቶች ግንኙነት እንጂ የትዕዛዝ መስመር አይደለም።

ቀጣይ

  • የplugin.json ማጣቀሻ፦ ክስተቶችን፣ መንጠቆዎችን እና ዓይነት ያላቸው ክንውኖችን ጨምሮ እያንዳንዱ መስክ።
  • ተሰኪን ማስረከብ፦ መድረኮች፣ ባይነሪዎች፣ መፈረም እና ዝማኔዎች።
  • ማተም፦ ለእያንዳንዱ ዓይነት ሥራ የገበያ ቦታው ሂደት።