NeboAI
NeboAI
Magsimula

Reference ng agent.json

Hawak ng agent.json ang lahat tungkol sa empleyado na hindi prosa: ang mga capability na kailangan nito, ang mga tanong nito sa may-ari, paano iniingatan ang memory nito, aling mga operasyon ang laging nangangailangan ng pag-apruba, at ang mga workflow na pinapatakbo nito. Opsyonal ang bawat field.

Halimbawa

{
  "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." }
      ]
    }
  }
}

Mga Field

FieldUriKahulugan
requires.interfaceslistahan ng mga stringMga capability na kailangan ng tungkulin, gaya ng mail o ledger. Ibinibigay sa pag-hire; nananatiling approval item ang bawat operasyong nangangailangan ng pag-apruba. Tingnan ang Mga Kakayahan at Pag-apruba.
requires.pluginslistahan ng mga stringMga plugin na ini-install kasama ng empleyado. Gamitin lang kapag talagang nakasalalay ang tungkulin sa iisang plugin; mas mainam ang capability.
requires.toolslistahan ng mga stringMga tool na nilo-load sa session ng empleyado mula sa unang turn nito. Hindi kailanman nilalampasan nito ang pag-apruba.
skillslistahan ng mga stringMga marketplace skill na ii-install at gagamitin: @org/skills/name, opsyonal na may @version, o isang SKIL- code. Hindi kailangan ng entry ang mga skill sa sariling skills/ folder ng package.
inputslistMga tanong na sinasagot ng may-ari sa pag-hire. Tingnan ang Inputs.
memoryobjectKung paano iniingatan ang mga usapan at memory. Tingnan ang Persona at Memory.
subscribeslistahan ng mga stringMga larangan ng impormasyon ng kumpanya na binabasa ulit ng empleyado kapag nagbago ang mga ito, gaya ng finance.ar.*.
ceilingmapOperasyon papunta sa "approval". Laging nagtatanong sa may-ari ang operasyong iyon para sa empleyadong ito. Walang ibang value na tinatanggap.
workflowsmapPangalan ng workflow papunta sa workflow. Tingnan ang Workflows.
toolslistMga HTTP tool na inihahain ng sidecar ng isang app. Tingnan ang Sidecar tools.
scopesmapMga may-pangalang grupo ng tools, skills at plugins. Inilalarawan sa empleyado ang plugins ng isang scope kapag aktibo ang scope na iyon.

Mga Input

Ang input ay isang tanong na sinasagot ng may-ari kapag kumukuha ng empleyado. Lumalabas sa empleyado ang mga sagot sa ilalim ng "Configured Inputs" at pinupunan nito ang mga placeholder na {{key}} sa mga watch at folder trigger.

{
  "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"
}
FieldDefaultKahulugan
keykailanganPangalang ginagamit sa mga placeholder. Tinatanggap ang name bilang fallback.
labelmula sa keyAng tanong na ipinapakita sa may-ari.
typetexttext, textarea, number, select, checkbox o radio.
requiredfalseMinamarkahan ang tanong bilang dapat sagutin ng may-ari.
defaultwalaPaunang sagot. Hindi pinapayagan sa tanong tungkol sa pera.
placeholder, descriptionwalaHelp text.
optionswalaPara sa select at radio: mga {value, label} object o simpleng string.
idwalaIsang matatag at may tuldok na pangalan para sa impormasyon, gaya ng finance.ap.invoice_mailbox, para maibahagi ito ng ibang empleyado.
scopecompanycompany: isang shared na impormasyon ng kumpanya. seat: para sa hire na ito lang.
missingwalaAng ginagawa ng empleyado habang hindi pa nasasagot ang tanong.
moneyfalseMinamarkahan ang halaga ng pera. Hindi puwedeng magkaroon ng default ang tanong tungkol sa pera.

Mga Sidecar tool

Inilalantad ng isang app na may sidecar ang mga HTTP endpoint sa empleyado nito bilang mga tool. Nire-register ng Nebo ang bawat entry bilang app__<app>__<name> at ipinapadala ang mga tawag sa sidecar sa method at path. Tingnan ang App 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" } } }
  }
]

Mga Workflow

Bawat key sa ilalim ng workflows ay pangalan ng isang workflow; ang pangalan ang identifier nito. Nasa Workflows, Triggers at Activities ang buong format.