NeboAI
NeboAI
Kezdés

agent.json referencia

Az agent.json mindent tartalmaz a munkatársról, ami nem próza: a szükséges képességeit, a tulajdonosnak feltett kérdéseit, a memóriája kezelésének módját, mely műveletekhez kell mindig jóváhagyás, és az általa futtatott munkafolyamatokat. Minden mező opcionális.

Példa

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

Mezők

MezőTípusJelentés
requires.interfaceskarakterláncok listájaA szerepkörhöz szükséges képességek, például mail vagy ledger. Felvételkor kerülnek megadásra; minden jóváhagyáshoz kötött művelet jóváhagyási tétel marad. Lásd: Képességek és jóváhagyások.
requires.pluginskarakterláncok listájaA munkatárssal együtt telepített bővítmények. Csak akkor használja, ha a szerepkör tényleg egyetlen bővítménytől függ; inkább képességet adjon meg.
requires.toolskarakterláncok listájaEszközök, amelyek az első körtől betöltődnek a munkatárs munkamenetébe. Ez soha nem kerüli meg a jóváhagyást.
skillskarakterláncok listájaTelepítendő és használandó piactéri készségek: @org/skills/name, opcionálisan @version, vagy egy SKIL- kód. A csomag saját skills/ mappájában lévő készségekhez nem kell bejegyzés.
inputslistKérdések, amelyekre a tulajdonos felvételkor válaszol. Lásd: Bemenetek.
memoryobjectHogyan kezeli a beszélgetéseket és a memóriát. Lásd: Személyiség és memória.
subscribeskarakterláncok listájaCéges ténykörök, amelyeket a munkatárs változáskor újraolvas, például finance.ar.*.
ceilingmapMűvelet → "approval". Ennél a munkatársnál az adott művelet mindig megkérdezi a tulajdonost. Más érték nem fogadható el.
workflowsmapMunkafolyamat neve → munkafolyamat. Lásd: Munkafolyamatok.
toolslistEgy alkalmazás sidecarja által kiszolgált HTTP-eszközök. Lásd: Sidecar-eszközök.
scopesmapA tools, skills és plugins elnevezett csoportjai. Egy hatókör plugins elemeit a munkatárs akkor kapja meg leírásként, amikor az a hatókör aktív.

Bemenetek

A bemenet egy kérdés, amelyre a tulajdonos a felvételkor válaszol. A válaszok a munkatárs számára a „Configured Inputs” alatt jelennek meg, és kitöltik a {{key}} helyőrzőket a figyelő- és mappaindítókban.

{
  "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"
}
MezőAlapértelmezésJelentés
keykötelezőA helyőrzőkben használt név. Tartalékként a name is elfogadott.
labela key alapjánA tulajdonosnak megjelenített kérdés.
typetexttext, textarea, number, select, checkbox vagy radio.
requiredfalseMegjelöli a kérdést, amelyre a tulajdonosnak kötelező válaszolnia.
defaultnincsElőre kitöltött válasz. Pénzösszegre vonatkozó kérdésnél nem engedélyezett.
placeholder, descriptionnincsSúgószöveg.
optionsnincsA select és a radio esetén: {value, label} objektumok vagy egyszerű karakterláncok.
idnincsStabil, pontokkal tagolt név a ténynek, például finance.ap.invoice_mailbox, hogy más munkatársak is megoszthassák.
scopecompanycompany: közös céges tény. seat: csak ez a felvétel.
missingnincsMit csinál a munkatárs, amíg a kérdés megválaszolatlan.
moneyfalsePénzösszeget jelöl. Egy pénzösszegre vonatkozó kérdésnek nem lehet alapértelmezett értéke.

Sidecar-eszközök

A sidecarral rendelkező alkalmazás HTTP-végpontokat tesz elérhetővé eszközként a munkatársa számára. A Nebo minden bejegyzést app__<app>__<name> néven regisztrál, és a hívásokat a sidecarhoz küldi a method és a path szerint. Lásd: Alkalmazás-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" } } }
  }
]

Munkafolyamatok

A workflows alatti minden kulcs egy munkafolyamatot nevez meg; a név az azonosítója. A teljes formátumot lásd: Munkafolyamatok, Indítók és Tevékenységek.