NeboAI
NeboAI
Începe

Referință agent.json

agent.json conține tot ce ține de un angajat și nu e proză: capabilitățile de care are nevoie, întrebările pe care i le pune proprietarului, cum îi e păstrată memoria, ce operațiuni necesită întotdeauna aprobare și fluxurile de lucru pe care le rulează. Fiecare câmp e opțional.

Exemplu

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

Câmpuri

CâmpTipSemnificație
requires.interfaceslistă de șiruriCapabilitățile de care are nevoie rolul, precum mail sau ledger. Acordate la angajare; fiecare operațiune care necesită aprobare rămâne un element de aprobat. Vezi Capabilități și aprobări.
requires.pluginslistă de șiruriPluginuri instalate odată cu angajatul. Folosește doar când rolul depinde cu adevărat de un anumit plugin; preferă o capabilitate.
requires.toolslistă de șiruriInstrumente încărcate în sesiunea angajatului de la prima tură. Asta nu ocolește niciodată aprobarea.
skillslistă de șiruriAbilități din magazin de instalat și folosit: @org/skills/name, opțional @version, sau un cod SKIL-. Abilitățile din folderul skills/ al pachetului nu au nevoie de intrare.
inputslistÎntrebări la care proprietarul răspunde la angajare. Vezi Date de intrare.
memoryobjectCum sunt păstrate conversațiile și memoria. Vezi Persona și memorie.
subscribeslistă de șiruriDomenii de informații ale companiei pe care angajatul le recitește când se schimbă, de exemplu finance.ar.*.
ceilingmapOperațiune asociată cu "approval". Pentru acest angajat, operațiunea respectivă îl întreabă întotdeauna pe proprietar. Nicio altă valoare nu e acceptată.
workflowsmapAsociere între numele fluxului de lucru și fluxul de lucru. Vezi Fluxuri de lucru.
toolslistInstrumente HTTP servite de sidecarul unei aplicații. Vezi Instrumente sidecar.
scopesmapGrupuri cu nume de tools, skills și plugins. Pluginurile (plugins) unui domeniu îi sunt descrise angajatului când acel domeniu e activ.

Date de intrare

Un câmp de intrare este o întrebare la care proprietarul răspunde când angajează. Răspunsurile îi apar angajatului la „Configured Inputs” și completează substituenții {{key}} din declanșatoarele de tip watch și folder.

{
  "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"
}
CâmpImplicitSemnificație
keyobligatoriuNumele folosit în substituenți. name e acceptat ca alternativă.
labeldin keyÎntrebarea afișată proprietarului.
typetexttext, textarea, number, select, checkbox sau radio.
requiredfalseMarchează întrebarea ca fiind una la care proprietarul trebuie să răspundă.
defaultniciunulRăspuns precompletat. Nu e permis la o întrebare despre bani.
placeholder, descriptionniciunulText de ajutor.
optionsniciunulPentru select și radio: obiecte {value, label} sau șiruri simple.
idniciunulUn nume stabil, cu puncte, pentru informație, de exemplu finance.ap.invoice_mailbox, ca alți angajați să o poată folosi în comun.
scopecompanycompany: o informație comună a companiei. seat: doar pentru această angajare.
missingniciunulCe face angajatul cât timp întrebarea nu are răspuns.
moneyfalseMarchează o sumă de bani. O întrebare despre bani nu poate avea valoare implicită.

Instrumente sidecar

O aplicație cu sidecar îi expune angajatului ei endpointuri HTTP ca instrumente. Nebo înregistrează fiecare intrare ca app__<app>__<name> și trimite apelurile către sidecar la method și path. Vezi Sidecar pentru aplicații.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

Fluxuri de lucru

Fiecare cheie din workflows numește un flux de lucru; numele este identificatorul lui. Formatul complet e descris în Fluxuri de lucru, Declanșatoare și Activități.