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 साधने. साइडकार साधने पहा.
scopesmaptools, 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 स्वीकारले जाते.
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पैशांची रक्कम दर्शवते. पैशांच्या प्रश्नाला डिफॉल्ट असू शकत नाही.

साइडकार साधने

साइडकार असलेले ॲप त्याच्या कर्मचाऱ्याला 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 खालील प्रत्येक की एका वर्कफ्लोचे नाव देते; ते नावच त्याचा ओळखकर्ता असतो. संपूर्ण फॉरमॅट वर्कफ्लो, ट्रिगर आणि ॲक्टिव्हिटी वर आहे.