NeboAI
NeboAI
Začít

Reference agent.json

agent.json obsahuje vše o zaměstnanci, co není prostý text: schopnosti, které vyžaduje, otázky, které klade vlastníkovi, jak se uchovává jeho paměť, které operace vždy vyžadují schválení, a pracovní postupy, které spouští. Každé pole je volitelné.

Příklad

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

Pole

PoleTypVýznam
requires.interfacesseznam řetězcůSchopnosti, které role potřebuje, například mail nebo ledger. Udělují se při přijetí; každá operace podmíněná schválením zůstává položkou ke schválení. Viz Schopnosti a schvalování.
requires.pluginsseznam řetězcůPluginy instalované se zaměstnancem. Použijte jen tehdy, když role na jednom pluginu skutečně závisí; přednost dejte schopnosti.
requires.toolsseznam řetězcůNástroje načtené do relace zaměstnance od jeho prvního tahu. Schvalování se tím nikdy neobchází.
skillsseznam řetězcůDovednosti z obchodu k instalaci a použití: @org/skills/name, volitelně s @version, nebo kód SKIL-. Dovednosti ve vlastní složce skills/ balíčku žádný záznam nepotřebují.
inputslistOtázky, na které vlastník odpoví při přijetí. Viz Vstupy.
memoryobjectJak se uchovávají konverzace a paměť. Viz Persona a paměť.
subscribesseznam řetězcůOblasti firemních faktů, které zaměstnanec při jejich změně znovu načte, například finance.ar.*.
ceilingmapOperace na "approval". Tato operace se u tohoto zaměstnance vždy zeptá vlastníka. Žádná jiná hodnota se nepřijímá.
workflowsmapNázev pracovního postupu na pracovní postup. Viz Pracovní postupy.
toolslistNástroje HTTP obsluhované sidecarem aplikace. Viz Nástroje sidecaru.
scopesmapPojmenované skupiny tools, skills a plugins. Když je rozsah aktivní, jeho plugins se zaměstnanci popíšou.

Vstupy

Vstup je otázka, na kterou vlastník odpovídá při najímání. Odpovědi se zaměstnanci zobrazí v části „Configured Inputs“ a vyplní zástupné symboly {{key}} ve spouštěčích sledování a složek.

{
  "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"
}
PoleVýchozíVýznam
keypovinnéNázev používaný v zástupných symbolech. Jako náhrada se přijímá name.
labelz keyOtázka zobrazená vlastníkovi.
typetexttext, textarea, number, select, checkbox nebo radio.
requiredfalseOznačuje otázku, na kterou vlastník musí odpovědět.
defaultžádnáPředvyplněná odpověď. Není povolena u otázky na peníze.
placeholder, descriptionžádnáText nápovědy.
optionsžádnáPro select a radio: objekty {value, label} nebo prosté řetězce.
idžádnáStálý název faktu s tečkami, například finance.ap.invoice_mailbox, aby ho mohli sdílet i další zaměstnanci.
scopecompanycompany: sdílený firemní fakt. seat: jen pro toto přijetí.
missingžádnáCo zaměstnanec dělá, dokud otázka není zodpovězená.
moneyfalseOznačuje peněžní částku. Otázka na peníze nemůže mít výchozí hodnotu.

Nástroje sidecaru

Aplikace se sidecarem zpřístupňuje svému zaměstnanci koncové body HTTP jako nástroje. Nebo každou položku registruje jako app__<app>__<name> a volání posílá sidecaru na method a path. Viz Sidecar aplikace.

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

Pracovní postupy

Každý klíč v workflows pojmenovává jeden pracovní postup; název je jeho identifikátor. Úplný formát najdete v částech Pracovní postupy, Spouštěče a Aktivity.