उदाहरण
{
"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 | ॲपच्या साइडकारने दिलेली HTTP साधने. साइडकार साधने पहा. |
scopes | map | tools, skills आणि plugins यांचे नाव असलेले गट. स्कोप सक्रिय असताना त्याच्या plugins चे वर्णन कर्मचाऱ्याला दिले जाते. |
इनपुट
इनपुट म्हणजे नेमणूक करताना मालक उत्तर देतो असा प्रश्न. उत्तरे कर्मचाऱ्याला "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 | पैशांची रक्कम दर्शवते. पैशांच्या प्रश्नाला डिफॉल्ट असू शकत नाही. |
साइडकार साधने
साइडकार असलेले ॲप त्याच्या कर्मचाऱ्याला HTTP एंडपॉइंट साधने म्हणून उपलब्ध करते. Nebo प्रत्येक नोंद app__<app>__<name> म्हणून नोंदवतो आणि कॉल साइडकारकडे method आणि path वर पाठवतो. ॲप साइडकार पहा.
"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 खालील प्रत्येक की एका वर्कफ्लोचे नाव देते; ते नावच त्याचा ओळखकर्ता असतो. संपूर्ण फॉरमॅट वर्कफ्लो, ट्रिगर आणि ॲक्टिव्हिटी वर आहे.