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أدوات HTTP يقدّمها المكوّن المرافق للتطبيق. انظر أدوات المكوّن المرافق.
scopesmapمجموعات مسمّاة من 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السؤال الذي يُعرض على المالك.
typetexttext أو textarea أو number أو select أو checkbox أو radio.
requiredfalseيعلّم السؤال بأنه سؤال يجب على المالك الإجابة عنه.
defaultلا شيءإجابة معبّأة مسبقًا. غير مسموح بها في السؤال المالي.
placeholder, descriptionلا شيءنص المساعدة.
optionsلا شيءلـ select وradio: كائنات {value, label} أو نصوص بسيطة.
idلا شيءاسم ثابت بالترميز النقطي للحقيقة، مثل finance.ap.invoice_mailbox، ليتمكن الموظفون الآخرون من مشاركتها.
scopecompanycompany: حقيقة مشتركة للشركة. seat: لهذا التوظيف فقط.
missingلا شيءما يفعله الموظف ما دام السؤال بلا إجابة.
moneyfalseيعلّم مبلغًا ماليًا. لا يمكن أن تكون للسؤال المالي قيمة افتراضية.

أدوات المكوّن المرافق

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