NeboAI
NeboAI
શરૂ કરો

SKILL.md સંદર્ભ

આ પેજ Nebo વાંચે છે તે સ્કિલના દરેક ભાગની યાદી આપે છે: ફ્રન્ટમેટર ફીલ્ડ્સ, તે વિસ્તારે છે તે વેરિએબલ્સ, સ્કિલ્સ સાથે કામ કરવા કર્મચારીઓ વાપરે છે તે ટૂલ્સ, અને સ્ક્રિપ્ટ્સ જેમાં ચાલે છે તે એન્વાયર્નમેન્ટ.

ફાઇલ ફોર્મેટ

SKILL.md UTF-8 લખાણ છે. તે ત્રણ હાઇફનની લાઇનથી શરૂ થાય છે, પછી YAML ફ્રન્ટમેટર, પછી ત્રણ હાઇફનની બંધ કરતી લાઇન. તેના પછીનું બધું બૉડી છે: Markdown સૂચનાઓ જે કર્મચારીને સ્કિલ લોડ કરતી વખતે મળે છે. Nebo નાના-મોટા અક્ષરોની પરવા કર્યા વિના ફાઇલને નામથી શોધે છે.

---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
  allowed_domains: [api.example.com]
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
requires:
  - name: receipt-capture
    version: ">=1.0.0"
plugins:
  - name: example-ledger
    version: ">=2.0.0"
    optional: true
---

# Expense review

Follow the policy in references/policy.md ...

ફ્રન્ટમેટર ફીલ્ડ્સ

ફક્ત name અને description જરૂરી છે. ખોટા પ્રકારવાળું ફીલ્ડ આખી ફાઇલને નિષ્ફળ બનાવે છે, તેથી સ્કિલ લોડ થતી નથી. અહીં સૂચિબદ્ધ ન હોય તેવી કીઝ અવગણાય છે.

ફીલ્ડપ્રકારડિફૉલ્ટઅર્થ
namestringજરૂરીઓળખકર્તા. [a-z0-9-], શરૂઆતમાં, અંતમાં કે બેવડો હાઇફન નહીં, વધુમાં વધુ 64 બાઇટ્સ. ફોલ્ડરના નામ સાથે મેળ રાખો.
descriptionstringજરૂરીસ્કિલ શું કરે છે અને ક્યારે વાપરવી. વધુમાં વધુ 1,024 બાઇટ્સ. કર્મચારીની સ્કિલ યાદીમાં બતાવાય છે અને find_skills દ્વારા સ્કોર થાય છે.
versionstring"1.0.0"સિમેન્ટિક વર્ઝન. બીજી સ્કિલ્સની requires રેન્જ દ્વારા તપાસાય છે. તેને અવતરણમાં લખો.
triggersસ્ટ્રિંગ્સની યાદી[]સ્કિલ ક્યારે લાગુ પડે છે તેનું વર્ણન કરતા શબ્દો અને વાક્યાંશો. સ્કિલ યાદીમાં વધુમાં વધુ ત્રણ દેખાય છે; find_skillsમાં બધા ગણાય છે. તેઓ ક્યારેય જાતે સ્કિલ લોડ કરતા નથી.
platformસ્ટ્રિંગ્સની યાદીબધાmacos, linux, windows. સ્કિલ ફક્ત ત્યાં જ લોડ થાય છે જ્યાં કોઈ એક મેળ ખાય.
capabilitiesસ્ટ્રિંગ્સની યાદી[]network અને storage સ્ક્રિપ્ટ સેન્ડબૉક્સને વિસ્તારે છે. સ્ક્રિપ્ટ સેન્ડબૉક્સ જુઓ.
metadatamap{}secrets અને allowed_domains ધરાવે છે. નીચે જુઓ.
requires{name, version}ની યાદી[]આ સ્કિલ જેના પર આધારિત છે તે બીજી સ્કિલ્સ. name સ્કિલનું ટૂંકું નામ છે; version semver રેન્જ છે, ડિફૉલ્ટ "*".
plugins{name, version, optional}ની યાદી[]આ સ્કિલ વાપરે છે તે પ્લગઇન્સ. versionનું ડિફૉલ્ટ "*" છે, optionalનું false.
dependenciesસ્ટ્રિંગ્સની યાદી[]હાજર હોવી જ જોઈએ તેવી સ્કિલ્સના ટૂંકા નામો.
priorityinteger0મેનેજમેન્ટ યાદીઓમાં સ્કિલ્સનો ક્રમ નક્કી કરે છે. કર્મચારી કઈ સ્કિલ પસંદ કરે તેના પર તેની અસર થતી નથી.
authorstring""બતાવવા માટે સંગ્રહાય છે.
licensestring""બતાવવા માટે સંગ્રહાય છે.
compatibilitystring""મુક્ત લખાણવાળી નોંધ, વધુમાં વધુ 500 બાઇટ્સ.
tagsસ્ટ્રિંગ્સની યાદી[]બતાવવા માટે સંગ્રહાય છે.
allowed-toolsstring""સ્પેસથી અલગ કરેલી સ્ટ્રિંગ. સંગ્રહાય છે; લાગુ કરાતી નથી.

જ્યારે requires અથવા dependenciesમાં નામ આપેલી સ્કિલ ખૂટતી હોય કે રેન્જની બહાર હોય, અથવા જરૂરી પ્લગઇન ઇન્સ્ટોલ ન હોય, ત્યારે પણ સ્કિલ લોડ થાય છે અને ડિગ્રેડેડ તરીકે ચિહ્નિત થાય છે. માલિક જુએ છે કે શું ખૂટે છે.

સિક્રેટ્સ

સ્કિલની સ્ક્રિપ્ટ્સને જરૂરી ક્રેડેન્શિયલ્સ metadata.secrets હેઠળ જાહેર કરો. માલિક કિંમતો આપે છે, અને Nebo તેમને તે સ્કિલ માટે એન્ક્રિપ્ટ કરીને સંગ્રહે છે.

metadata:
  secrets:
    - key: EXAMPLE_API_KEY
      label: Example API key
      hint: Create one at https://example.com/settings/keys
      required: true
કીઅર્થ
keyસ્ક્રિપ્ટને મળતા એન્વાયર્નમેન્ટ વેરિએબલનું નામ. જરૂરી.
labelમાલિકને બતાવાતું નામ.
hintકિંમત ક્યાંથી મેળવવી.
requiredtrue હોય ત્યારે, કિંમત સેટ ન થાય ત્યાં સુધી execute સ્કિલની સ્ક્રિપ્ટ્સ ચલાવવાનો ઇનકાર કરે છે. ડિફૉલ્ટ false.

કર્મચારી configure_skill વડે કિંમત સેટ કરે છે. તમે બૉડીમાં સિક્રેટનો ઉલ્લેખ ${secret.KEY} તરીકે કરી શકો છો, જોકે સ્ક્રિપ્ટે તેના બદલે એન્વાયરનમેન્ટ વેરિએબલ વાંચવું જોઈએ.

ટેમ્પ્લેટ વેરિએબલ્સ

કર્મચારી સ્કિલ લોડ કરે ત્યારે Nebo બૉડીમાં આ વેરિએબલ્સ બદલે છે. બીજી ફાઇલોની અંદર તે બદલાતા નથી; સ્ક્રિપ્ટ્સ તેના બદલે એન્વાયર્નમેન્ટ વેરિએબલ્સ વાંચે છે.

વેરિએબલકિંમત
${NEBO_SKILL_DIR}સ્કિલના ફોલ્ડરનો સંપૂર્ણ પાથ.
${NEBO_DATA_DIR}આ સ્કિલ માટે લખી શકાય તેવું ફોલ્ડર: <data>/appdata/skills/<name>. પહેલા ઉપયોગ વખતે બને છે.
${NEBO_USER_NAME}માલિકનું નામ.
${NEBO_OS}ઑપરેટિંગ સિસ્ટમ.
${NEBO_ARCH}પ્રોસેસરનું આર્કિટેક્ચર.
${plugin.SLUG_BIN}જાહેર કરેલા પ્લગઇનની બાઇનરીનો પાથ. સ્લગ મોટા અક્ષરોમાં, હાઇફનને અન્ડરસ્કોર બનાવીને લખાય છે: example-ledger ${plugin.EXAMPLE_LEDGER_BIN} બને છે.
${secret.KEY}જાહેર કરેલા સિક્રેટની કિંમત.
$ARGUMENTSuse_skillને આપેલા args. બૉડીમાં $ARGUMENTS ન હોય ત્યારે, આર્ગ્યુમેન્ટ્સ તેના પછી ઉમેરાય છે.

સ્કિલ ટૂલ્સ

કર્મચારીઓ આ ટૂલ્સ દ્વારા સ્કિલ્સ સાથે કામ કરે છે. use_skill હંમેશાં ઉપલબ્ધ છે; બાકીના કર્મચારીને જરૂર પડે ત્યારે લોડ થાય છે.

ટૂલપેરામીટર્સતે શું કરે છે
use_skillname, argsસ્કિલ લોડ કરે છે. વિસ્તારેલું બૉડી, ફોલ્ડર પાથ અને પહેલા 20 ફાઇલ નામો પાછા આપે છે. બંધ કરેલી સ્કિલને ફરી ચાલુ કરે છે.
find_skillsqueryનામ, ટ્રિગર અને વર્ણનના મેળ પ્રમાણે ક્રમ આપેલી વધુમાં વધુ 10 સ્કિલ્સ પાછી આપે છે.
read_skill_filename, pathસ્કિલના ફોલ્ડરમાંની ફાઇલ વાંચે છે. path વિના, ફાઇલો અને તેમની સાઇઝની યાદી આપે છે.
save_skillname, contentસંપૂર્ણ SKILL.md યુઝર સ્કિલ્સ ફોલ્ડરમાં લખે છે. માર્કેટપ્લેસ સ્કિલ્સ પર ઓવરરાઇટ કરી શકાતું નથી.
delete_skillnameયુઝર સ્કિલ ડિલીટ કરે છે.
install_skillcodeમાર્કેટપ્લેસ સ્કિલને તેના SKIL- ઇન્સ્ટોલ કોડથી ઇન્સ્ટોલ કરે છે.
configure_skillname, key, valueસિક્રેટ સેટ કરે છે. key વિના, સ્કિલને શું જોઈએ છે તે બતાવે છે.
rate_skillname, rating, reviewમાર્કેટપ્લેસ સ્કિલને 1થી 5 રેટિંગ આપે છે.
read_skill_reviewsnameમાર્કેટપ્લેસ સ્કિલના રિવ્યૂ વાંચે છે.
executeskill, script, args, timeoutસ્કિલના ફોલ્ડરમાંથી સ્ક્રિપ્ટ ચલાવે છે. સ્ક્રિપ્ટ સેન્ડબૉક્સ જુઓ.

સ્ક્રિપ્ટ સેન્ડબૉક્સ

execute ટૂલ સ્કિલના ફોલ્ડરમાંથી એક સ્ક્રિપ્ટ ચલાવે છે. તે ફાઇલ પરથી રનટાઇમ પસંદ કરે છે.

સ્ક્રિપ્ટરનટાઇમ
.pyPython, હાજર હોય ત્યારે Neboના બંડલ કરેલા uv દ્વારા, નહીં તો python3.
.ts, .jsહાજર હોય ત્યારે Neboનું બંડલ કરેલું Bun, નહીં તો node.
bin/<file> અથવા binaryસીધું ચલાવાય છે.
.shસપોર્ટેડ નથી.

દરેક રન ખાલી એન્વાયર્નમેન્ટ અને આ વેરિએબલ્સ સાથે શરૂ થાય છે:

વેરિએબલકિંમત
SKILL_ARGSJSON તરીકે args ઑબ્જેક્ટ.
દરેક સિક્રેટ keyડિક્રિપ્ટ કરેલી સિક્રેટ કિંમત.
<PLUGIN>_BINજાહેર કરેલા દરેક પ્લગઇનની બાઇનરીનો પાથ. પ્લગઇન ફોલ્ડર્સ PATHમાં પણ ઉમેરાય છે.
import json, os

args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))}))

સ્ક્રિપ્ટ સ્કિલ ફોલ્ડરની કામચલાઉ કૉપિમાં ચાલે છે, 30 સેકન્ડના ડિફૉલ્ટ ટાઇમઆઉટ સાથે. macOS અને Linux પર તે ઑપરેટિંગ-સિસ્ટમ સેન્ડબૉક્સમાં ચાલે છે:

  • તે ક્રેડેન્શિયલ સ્ટોર્સ, બ્રાઉઝર અને કીચેન ડેટા, અથવા Neboના પોતાના સેટિંગ્સ અને ડેટાબેઝ વાંચી શકતી નથી.
  • તે ફક્ત પોતાના વર્કિંગ ફોલ્ડર અને /tmp/neboમાં જ લખી શકે છે. storage ક્ષમતા Neboનું ડેટા ફોલ્ડર ઉમેરે છે.
  • તેને નેટવર્ક ઍક્સેસ નથી. network ક્ષમતા પૅકેજ રજિસ્ટ્રીઝ અને metadata.allowed_domainsમાં સૂચિબદ્ધ ડોમેન્સને મંજૂરી આપે છે.

ફાઇલો અને મર્યાદાઓ

આઇટમનિયમ
રિસોર્સિસSKILL.md, manifest.json, signatures.json અને ડૉટફાઇલ્સ સિવાયની દરેક ફાઇલ.
એક્ઝિક્યુટેબલ્સscripts/ અથવા bin/ હેઠળની ફાઇલો, અને binary નામની રૂટ ફાઇલ.
પાથસ્કિલ ફોલ્ડરની સાપેક્ષે. ..વાળા કે ફોલ્ડરની બહાર જતા પાથ નકારાય છે.
બંધ કરેલી સ્કિલSKILL.mdના બદલે SKILL.md.disabledવાળું ફોલ્ડર.
સ્કિલ યાદીદરેક એન્ટ્રી 250 અક્ષરે કાપવામાં આવે છે. આખી યાદી 8,000 અક્ષરોથી વધી જાય ત્યારે, પહેલાં શેર કરેલી સ્કિલ્સ ટૂંકી કરાય છે; કર્મચારીની પોતાની સ્કિલ્સ પોતાની પૂરી એન્ટ્રીઓ રાખે છે.

તમે માર્કેટપ્લેસ પર પ્રકાશિત કરો તે ફાઇલોની મર્યાદાઓ પ્રકાશન પેજ પર છે.