NeboAI
NeboAI
Začať

Referencia agent.json

agent.json obsahuje všetko o zamestnancovi, čo nie je próza: schopnosti, ktoré vyžaduje, otázky, ktoré kladie vlastníkovi, ako sa uchováva jeho pamäť, ktoré operácie vždy vyžadujú schválenie a pracovné postupy, ktoré spúšťa. Každé pole je voliteľné.

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

Polia

PoleTypVýznam
requires.interfaceszoznam reťazcovSchopnosti, ktoré rola potrebuje, napríklad mail alebo ledger. Udeľujú sa pri prijatí; každá operácia podliehajúca schváleniu zostáva položkou na schválenie. Pozri Schopnosti a schválenia.
requires.pluginszoznam reťazcovDoplnky nainštalované spolu so zamestnancom. Použite len vtedy, keď rola naozaj závisí od jedného doplnku; uprednostnite schopnosť.
requires.toolszoznam reťazcovNástroje načítané do relácie zamestnanca od jeho prvého ťahu. Nikdy to neobchádza schválenie.
skillszoznam reťazcovZručnosti z obchodu na inštaláciu a použitie: @org/skills/name, voliteľne @version, alebo kód SKIL-. Zručnosti vo vlastnom priečinku skills/ balíka nepotrebujú záznam.
inputslistOtázky, na ktoré vlastník odpovedá pri prijatí. Pozri Vstupy.
memoryobjectAko sa uchovávajú konverzácie a pamäť. Pozri Persona a pamäť.
subscribeszoznam reťazcovOblasti firemných faktov, ktoré si zamestnanec znova prečíta, keď sa zmenia, napríklad finance.ar.*.
ceilingmapOperácia na "approval". Táto operácia sa pri tomto zamestnancovi vždy pýta vlastníka. Iná hodnota sa neprijíma.
workflowsmapNázov pracovného postupu na pracovný postup. Pozri Pracovné postupy.
toolslistNástroje HTTP poskytované sidecarom aplikácie. Pozri Nástroje sidecaru.
scopesmapPomenované skupiny tools, skills a plugins. Doplnky plugins danej oblasti sa zamestnancovi opíšu, keď je táto oblasť aktívna.

Vstupy

Vstup je otázka, na ktorú vlastník odpovedá pri prijímaní zamestnanca. Odpovede sa zamestnancovi zobrazia v časti „Configured Inputs“ a vypĺňajú zástupné symboly {{key}} v spúšťačoch sledovania a priečinkov.

{
  "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"
}
PolePredvolenéVýznam
keypovinnéNázov používaný v zástupných symboloch. Ako náhrada sa prijíma aj name.
labelz keyOtázka zobrazená vlastníkovi.
typetexttext, textarea, number, select, checkbox alebo radio.
requiredfalseOznačí otázku ako takú, na ktorú musí vlastník odpovedať.
defaultžiadneVopred vyplnená odpoveď. Pri finančnej otázke nie je povolená.
placeholder, descriptionžiadneText pomocníka.
optionsžiadnePre select a radio: objekty {value, label} alebo obyčajné reťazce.
idžiadneStály názov faktu s bodkami, napríklad finance.ap.invoice_mailbox, aby ho mohli zdieľať aj iní zamestnanci.
scopecompanycompany: zdieľaný firemný fakt. seat: len pre toto prijatie.
missingžiadneČo zamestnanec robí, kým otázka nie je zodpovedaná.
moneyfalseOznačuje peňažnú sumu. Finančná otázka nemôže mať predvolenú hodnotu.

Nástroje sidecaru

Aplikácia so sidecarom sprístupňuje svojmu zamestnancovi koncové body HTTP ako nástroje. Nebo zaregistruje každý záznam ako app__<app>__<name> a volania posiela do sidecaru na method a path. Pozri Sidecar aplikácie.

"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ý kľúč pod workflows pomenúva jeden pracovný postup; názov je jeho identifikátor. Úplný formát nájdete v častiach Pracovné postupy, Spúšťače a Aktivity.