NeboAI
NeboAI
Aan de slag

agent.json-referentie

agent.json bevat alles over een medewerker wat geen gewone tekst is: de capabilities die hij nodig heeft, de vragen die hij de eigenaar stelt, hoe zijn geheugen wordt bewaard, welke bewerkingen altijd goedkeuring nodig hebben en de workflows die hij draait. Elk veld is optioneel.

Voorbeeld

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

Velden

VeldTypeBetekenis
requires.interfaceslijst met stringsCapabilities die de functie nodig heeft, zoals mail of ledger. Toegekend bij het aannemen; elke bewerking waarvoor goedkeuring nodig is, blijft een goedkeuringsitem. Zie Capabilities en goedkeuringen.
requires.pluginslijst met stringsPlug-ins die met de medewerker worden geïnstalleerd. Gebruik dit alleen als de functie echt van één plug-in afhangt; geef de voorkeur aan een capability.
requires.toolslijst met stringsTools die vanaf de eerste beurt in de sessie van de medewerker worden geladen. Dit omzeilt nooit een goedkeuring.
skillslijst met stringsMarktplaatsskills om te installeren en te gebruiken: @org/skills/name, optioneel @version, of een SKIL--code. Skills in de eigen map skills/ van het pakket hebben geen vermelding nodig.
inputslistVragen die de eigenaar bij het aannemen beantwoordt. Zie Invoer.
memoryobjectHoe gesprekken en geheugen worden bewaard. Zie Persona en geheugen.
subscribeslijst met stringsGebieden met bedrijfsfeiten die de medewerker opnieuw leest wanneer ze veranderen, zoals finance.ar.*.
ceilingmapBewerking naar "approval". Voor deze medewerker vraagt die bewerking altijd de eigenaar om goedkeuring. Geen andere waarde wordt geaccepteerd.
workflowsmapWorkflownaam naar workflow. Zie Workflows.
toolslistHTTP-tools die worden geleverd door de sidecar van een app. Zie Sidecar-tools.
scopesmapBenoemde groepen van tools, skills en plugins. De plugins van een scope worden aan de medewerker beschreven wanneer die scope actief is.

Invoer

Een invoer is een vraag die de eigenaar beantwoordt bij het aannemen. De antwoorden verschijnen voor de medewerker onder "Configured Inputs" en vullen de placeholders {{key}} in watch- en maptriggers.

{
  "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"
}
VeldStandaardBetekenis
keyverplichtNaam die in placeholders wordt gebruikt. name wordt als alternatief geaccepteerd.
labeluit keyDe vraag die aan de eigenaar wordt getoond.
typetexttext, textarea, number, select, checkbox of radio.
requiredfalseMarkeert de vraag als een vraag die de eigenaar moet beantwoorden.
defaultgeenVooraf ingevuld antwoord. Niet toegestaan bij een geldvraag.
placeholder, descriptiongeenHelptekst.
optionsgeenVoor select en radio: {value, label}-objecten of gewone strings.
idgeenEen vaste naam met punten voor het feit, zoals finance.ap.invoice_mailbox, zodat andere medewerkers het kunnen delen.
scopecompanycompany: een gedeeld bedrijfsfeit. seat: alleen voor deze aanstelling.
missinggeenWat de medewerker doet zolang de vraag niet is beantwoord.
moneyfalseMarkeert een geldbedrag. Een geldvraag kan geen standaardwaarde hebben.

Sidecar-tools

Een app met een sidecar stelt HTTP-endpoints als tools beschikbaar aan zijn medewerker. Nebo registreert elke vermelding als app__<app>__<name> en stuurt aanroepen naar de sidecar op method en path. Zie 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

Elke sleutel onder workflows geeft één workflow een naam; de naam is zijn identificatie. Het volledige formaat staat op Workflows, Triggers en Activiteiten.