ምሳሌ
{
"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/ አቃፊ ውስጥ ያሉ ክህሎቶች ግቤት አያስፈልጋቸውም። |
inputs | list | ባለቤቱ በቅጥር ጊዜ የሚመልሳቸው ጥያቄዎች። ግብዓቶችን ይመልከቱ። |
memory | object | ውይይቶችና ትውስታ እንዴት እንደሚጠበቁ። ስብዕና እና ትውስታን ይመልከቱ። |
subscribes | የሕብረ ቁምፊዎች ዝርዝር | ሰራተኛው ሲለወጡ እንደገና የሚያነባቸው የድርጅት እውነታ ዘርፎች፣ ለምሳሌ finance.ar.*። |
ceiling | map | ክዋኔ ወደ "approval"። ያ ክዋኔ ለዚህ ሰራተኛ ሁልጊዜ ባለቤቱን ይጠይቃል። ሌላ እሴት ተቀባይነት የለውም። |
workflows | map | የሥራ ፍሰት ስም ወደ የሥራ ፍሰት። የሥራ ፍሰቶችን ይመልከቱ። |
tools | list | በመተግበሪያ sidecar የሚቀርቡ የHTTP መሣሪያዎች። የSidecar መሣሪያዎችን ይመልከቱ። |
scopes | map | የተሰየሙ የ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 | ለባለቤቱ የሚታየው ጥያቄ። |
type | text | text፣ textarea፣ number፣ select፣ checkbox ወይም radio። |
required | false | ጥያቄውን ባለቤቱ የግድ መመለስ ያለበት እንደሆነ ምልክት ያደርጋል። |
default | የለም | አስቀድሞ የተሞላ መልስ። በገንዘብ ጥያቄ ላይ አይፈቀድም። |
placeholder, description | የለም | የእገዛ ጽሑፍ። |
options | የለም | ለselect እና ለradio፡ የ{value, label} ነገሮች ወይም ቀላል ሕብረ ቁምፊዎች። |
id | የለም | ሌሎች ሰራተኞች እንዲጋሩት ለእውነታው የሚሰጥ ቋሚ፣ በነጥብ የተለየ ስም፣ ለምሳሌ finance.ap.invoice_mailbox። |
scope | company | company፡ የጋራ የድርጅት እውነታ። seat፡ ለዚህ ቅጥር ብቻ። |
missing | የለም | ጥያቄው ሳይመለስ ሳለ ሰራተኛው የሚያደርገው። |
money | false | የገንዘብ መጠንን ምልክት ያደርጋል። የገንዘብ ጥያቄ ነባሪ ሊኖረው አይችልም። |
የ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 ስር ያለ እያንዳንዱ ቁልፍ አንድ የሥራ ፍሰትን ይሰይማል፤ ስሙ መለያው ነው። ሙሉው ቅርጸት በየሥራ ፍሰቶች፣ በቀስቃሾች እና በተግባራት ላይ ይገኛል።