مثال
{
"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" وتملأ العناصر النائبة {{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 يسمّي سير عمل واحدًا، والاسم هو معرّفه. الصيغة الكاملة موجودة في سير العمل والمُشغِّلات والأنشطة.