NeboAI
NeboAI
ይጀምሩ

የagent.json ማጣቀሻ

agent.json ስድ ንባብ ያልሆነውን ስለ ሰራተኛ ሁሉንም ነገር ይይዛል፤ የሚፈልጋቸውን ችሎታዎች፣ ለባለቤቱ የሚጠይቃቸውን ጥያቄዎች፣ ትውስታው እንዴት እንደሚጠበቅ፣ የትኞቹ ክዋኔዎች ሁልጊዜ ማጽደቅ እንደሚያስፈልጋቸው፣ እና የሚያስኬዳቸውን የሥራ ፍሰቶች። እያንዳንዱ መስክ አማራጭ ነው።

ምሳሌ

{
  "requires": {
    "interfaces": ["ledger", "mail"],
    "plugins": [],
    "tools": []
  },
  "skills": ["@example/skills/receipt-capture"],
  "inputs": [
    {
      "key": "invoice_mailbox",
      "label": "Mailbox that receives vendor invoices",
      "type": "text",
      "id": "finance.ap.invoice_mailbox",
      "scope": "company",
      "required": true,
      "missing": "Ask the owner which mailbox to watch before processing invoices."
    }
  ],
  "memory": {
    "mode": "separate",
    "topics": [
      { "slug": "vendor", "description": "A supplier: terms, usual amounts, contacts, open disputes" }
    ]
  },
  "subscribes": ["finance.ap.*"],
  "ceiling": { "ledger.bill.create": "approval" },
  "workflows": {
    "invoice-intake": {
      "trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
      "activities": [
        { "id": "record", "intent": "If the message in _watch_payload is a vendor invoice, record it as a bill." }
      ]
    }
  }
}

መስኮች

መስክዓይነትትርጉም
requires.interfacesየሕብረ ቁምፊዎች ዝርዝርሚናው የሚያስፈልጉት ችሎታዎች፣ ለምሳሌ mail ወይም ledger። በቅጥር ጊዜ ይሰጣሉ፤ ማጽደቅ የሚያስፈልገው እያንዳንዱ ክዋኔ የማጽደቂያ ንጥል ሆኖ ይቆያል። ችሎታዎች እና ማጽደቂያዎችን ይመልከቱ።
requires.pluginsየሕብረ ቁምፊዎች ዝርዝርከሰራተኛው ጋር የሚጫኑ ተሰኪዎች። ሚናው በእርግጥ በአንድ ተሰኪ ላይ ሲመረኮዝ ብቻ ይጠቀሙ፤ ችሎታን ይምረጡ።
requires.toolsየሕብረ ቁምፊዎች ዝርዝርከመጀመሪያው ዙር ጀምሮ ወደ ሰራተኛው ክፍለ ጊዜ የሚጫኑ መሣሪያዎች። ይህ በፍጹም ማጽደቅን አያልፍም።
skillsየሕብረ ቁምፊዎች ዝርዝርየሚጫኑና ጥቅም ላይ የሚውሉ የገበያ ቦታ ክህሎቶች፡ @org/skills/name፣ እንደ አማራጭ @version፣ ወይም የSKIL- ኮድ። በጥቅሉ የራሱ skills/ አቃፊ ውስጥ ያሉ ክህሎቶች ግቤት አያስፈልጋቸውም።
inputslistባለቤቱ በቅጥር ጊዜ የሚመልሳቸው ጥያቄዎች። ግብዓቶችን ይመልከቱ።
memoryobjectውይይቶችና ትውስታ እንዴት እንደሚጠበቁ። ስብዕና እና ትውስታን ይመልከቱ።
subscribesየሕብረ ቁምፊዎች ዝርዝርሰራተኛው ሲለወጡ እንደገና የሚያነባቸው የድርጅት እውነታ ዘርፎች፣ ለምሳሌ finance.ar.*።
ceilingmapክዋኔ ወደ "approval"። ያ ክዋኔ ለዚህ ሰራተኛ ሁልጊዜ ባለቤቱን ይጠይቃል። ሌላ እሴት ተቀባይነት የለውም።
workflowsmapየሥራ ፍሰት ስም ወደ የሥራ ፍሰት። የሥራ ፍሰቶችን ይመልከቱ።
toolslistበመተግበሪያ sidecar የሚቀርቡ የHTTP መሣሪያዎች። የSidecar መሣሪያዎችን ይመልከቱ።
scopesmapየተሰየሙ የtools፣ skills እና plugins ቡድኖች። የአንድ scope plugins ያ scope ንቁ ሲሆን ለሰራተኛው ይገለጻሉ።

ግብዓቶች

ግብዓት ባለቤቱ ሲቀጥር የሚመልሰው ጥያቄ ነው። መልሶቹ ለሰራተኛው በ«Configured Inputs» ስር ይታያሉ፣ በwatch እና በfolder ቀስቅሴዎች ውስጥ ያሉ {{key}} ቦታ ያዢዎችንም ይሞላሉ።

{
  "key": "close_day",
  "label": "Business day to finish the close",
  "type": "select",
  "options": [
    { "value": "3", "label": "Third business day" },
    { "value": "5", "label": "Fifth business day" }
  ],
  "default": "5",
  "scope": "company",
  "id": "finance.close.day"
}
መስክነባሪትርጉም
keyየሚያስፈልግበቦታ ያዢዎች ውስጥ የሚጠቀመው ስም። name እንደ ምትክ ተቀባይነት አለው።
labelከkeyለባለቤቱ የሚታየው ጥያቄ።
typetexttext፣ textarea፣ number፣ select፣ checkbox ወይም radio።
requiredfalseጥያቄውን ባለቤቱ የግድ መመለስ ያለበት እንደሆነ ምልክት ያደርጋል።
defaultየለምአስቀድሞ የተሞላ መልስ። በገንዘብ ጥያቄ ላይ አይፈቀድም።
placeholder, descriptionየለምየእገዛ ጽሑፍ።
optionsየለምለselect እና ለradio፡ የ{value, label} ነገሮች ወይም ቀላል ሕብረ ቁምፊዎች።
idየለምሌሎች ሰራተኞች እንዲጋሩት ለእውነታው የሚሰጥ ቋሚ፣ በነጥብ የተለየ ስም፣ ለምሳሌ finance.ap.invoice_mailbox።
scopecompanycompany፡ የጋራ የድርጅት እውነታ። seat፡ ለዚህ ቅጥር ብቻ።
missingየለምጥያቄው ሳይመለስ ሳለ ሰራተኛው የሚያደርገው።
moneyfalseየገንዘብ መጠንን ምልክት ያደርጋል። የገንዘብ ጥያቄ ነባሪ ሊኖረው አይችልም።

የSidecar መሣሪያዎች

sidecar ያለው መተግበሪያ የHTTP endpointsን ለሰራተኛው እንደ መሣሪያዎች ያቀርባል። Nebo እያንዳንዱን ግቤት እንደ app__<app>__<name> ያስመዘግባል፣ ጥሪዎችንም በmethod እና በpath ወደ sidecarው ይልካል። የመተግበሪያ ተጓዳኝ ሂደትን ይመልከቱ።

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

የሥራ ፍሰቶች

በworkflows ስር ያለ እያንዳንዱ ቁልፍ አንድ የሥራ ፍሰትን ይሰይማል፤ ስሙ መለያው ነው። ሙሉው ቅርጸት በየሥራ ፍሰቶች፣ በቀስቃሾች እና በተግባራት ላይ ይገኛል።