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किसी ऐप के sidecar से दिए जाने वाले HTTP टूल। Sidecar टूल देखें।
scopesmaptools, 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 भी स्वीकार है।
labelkey सेमालिक को दिखाया जाने वाला सवाल।
typetexttext, textarea, number, select, checkbox या radio।
requiredfalseसवाल को ऐसा चिह्नित करता है जिसका जवाब मालिक को देना ही होगा।
defaultकोई नहींपहले से भरा जवाब। पैसे के सवाल पर इसकी अनुमति नहीं।
placeholder, descriptionकोई नहींसहायता टेक्स्ट।
optionsकोई नहींselect और radio के लिए: {value, label} ऑब्जेक्ट या सादी स्ट्रिंग।
idकोई नहींजानकारी का एक स्थिर, डॉट वाला नाम, जैसे finance.ap.invoice_mailbox, ताकि दूसरे कर्मचारी उसे साझा कर सकें।
scopecompanycompany: कंपनी की साझा जानकारी। seat: सिर्फ़ यह नियुक्ति।
missingकोई नहींजब तक सवाल का जवाब नहीं मिलता, कर्मचारी क्या करता है।
moneyfalseपैसे की रकम को चिह्नित करता है। पैसे के सवाल का कोई डिफ़ॉल्ट नहीं हो सकता।

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 के नीचे हर कुंजी एक वर्कफ़्लो का नाम है; यही नाम उसका पहचानकर्ता है। पूरा फ़ॉर्मेट वर्कफ़्लो, ट्रिगर और एक्टिविटी पर है।