उदाहरण
{
"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 का वर्णन कर्मचारी को दिया जाता है। |
इनपुट
इनपुट एक सवाल है जिसका जवाब मालिक नियुक्ति के समय देता है। जवाब कर्मचारी को "Configured Inputs" के तहत दिखते हैं और वॉच व फ़ोल्डर ट्रिगर में {{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 एंडपॉइंट टूल के रूप में देता है। Nebo हर एंट्री को app__<app>__<name> के रूप में रजिस्टर करता है और कॉल को method और path पर sidecar तक भेजता है। ऐप 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 के नीचे हर कुंजी एक वर्कफ़्लो का नाम है; यही नाम उसका पहचानकर्ता है। पूरा फ़ॉर्मेट वर्कफ़्लो, ट्रिगर और एक्टिविटी पर है।