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ల పేరున్న సమూహాలు. ఒక scope యాక్టివ్‌గా ఉన్నప్పుడు దాని 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 వద్ద సైడ్‌కార్‌కు పంపుతుంది. App సైడ్‌కార్ చూడండి.

"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 కింద ప్రతి కీ ఒక వర్క్‌ఫ్లోకు పేరు పెడుతుంది; ఆ పేరే దాని ఐడెంటిఫైయర్. పూర్తి ఫార్మాట్ వర్క్‌ఫ్లోలు, ట్రిగ్గర్‌లు, యాక్టివిటీలు పేజీలలో ఉంది.