NeboAI
NeboAI
Loslegen

agent.json-Referenz

agent.json enthält alles an einem Mitarbeiter, was keine Prosa ist: die Fähigkeiten, die er braucht, die Fragen, die er dem Inhaber stellt, wie sein Gedächtnis geführt wird, welche Operationen immer eine Freigabe brauchen, und die Workflows, die er ausführt. Jedes Feld ist optional.

Beispiel

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

Felder

FeldTypBedeutung
requires.interfacesListe von StringsFähigkeiten, die die Rolle braucht, etwa mail oder ledger. Werden beim Einstellen erteilt; jede freigabepflichtige Operation bleibt ein Freigabe-Eintrag. Siehe Fähigkeiten und Freigaben.
requires.pluginsListe von StringsPlugins, die mit dem Mitarbeiter installiert werden. Nur verwenden, wenn die Rolle wirklich von einem Plugin abhängt; eine Fähigkeit ist vorzuziehen.
requires.toolsListe von StringsTools, die ab der ersten Runde in die Sitzung des Mitarbeiters geladen werden. Das umgeht nie eine Freigabe.
skillsListe von StringsMarktplatz-Skills zum Installieren und Nutzen: @org/skills/name, optional @version, oder ein SKIL--Code. Skills im eigenen Ordner skills/ des Pakets brauchen keinen Eintrag.
inputslistFragen, die der Inhaber beim Einstellen beantwortet. Siehe Eingaben.
memoryobjectWie Gespräche und Gedächtnis geführt werden. Siehe Persona und Gedächtnis.
subscribesListe von StringsBereiche mit Unternehmensfakten, die der Mitarbeiter bei Änderungen erneut liest, etwa finance.ar.*.
ceilingmapOperation zu "approval". Diese Operation fragt bei diesem Mitarbeiter immer den Inhaber. Kein anderer Wert wird akzeptiert.
workflowsmapWorkflow-Name zu Workflow. Siehe Workflows.
toolslistHTTP-Tools, die vom Sidecar einer App bereitgestellt werden. Siehe Sidecar-Tools.
scopesmapBenannte Gruppen von tools, skills und plugins. Die plugins eines Bereichs werden dem Mitarbeiter beschrieben, wenn dieser Bereich aktiv ist.

Eingaben

Ein Input ist eine Frage, die der Inhaber bei der Einstellung beantwortet. Die Antworten erscheinen für den Mitarbeiter unter „Configured Inputs“ und füllen {{key}}-Platzhalter in Watch- und Ordner-Triggern.

{
  "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"
}
FeldStandardBedeutung
keyerforderlichName, der in Platzhaltern verwendet wird. name wird als Ausweichlösung akzeptiert.
labelaus keyDie Frage, die dem Inhaber angezeigt wird.
typetexttext, textarea, number, select, checkbox oder radio.
requiredfalseKennzeichnet die Frage als eine, die der Inhaber beantworten muss.
defaultkeinerVorausgefüllte Antwort. Bei einer Geldfrage nicht erlaubt.
placeholder, descriptionkeinerHilfetext.
optionskeinerFür select und radio: {value, label}-Objekte oder einfache Strings.
idkeinerEin stabiler Name in Punktnotation für den Fakt, etwa finance.ap.invoice_mailbox, damit andere Mitarbeiter ihn teilen können.
scopecompanycompany: ein gemeinsamer Unternehmensfakt. seat: nur diese Einstellung.
missingkeinerWas der Mitarbeiter tut, solange die Frage unbeantwortet ist.
moneyfalseKennzeichnet einen Geldbetrag. Eine Geldfrage darf keinen Standardwert haben.

Sidecar-Tools

Eine App mit Sidecar stellt ihrem Mitarbeiter HTTP-Endpunkte als Tools bereit. Nebo registriert jeden Eintrag als app__<app>__<name> und schickt Aufrufe an den Sidecar unter method und path. Siehe 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" } } }
  }
]

Workflows

Jeder Schlüssel unter workflows benennt einen Workflow; der Name ist seine Kennung. Das vollständige Format findest du unter Workflows, Trigger und Aktivitäten.