NeboAI
NeboAI
Kom i gang

agent.json-reference

agent.json rummer alt om en medarbejder, der ikke er prosa: de funktioner, den kræver, de spørgsmål, den stiller ejeren, hvordan dens hukommelse holdes, hvilke operationer der altid kræver godkendelse, og de workflows, den kører. Alle felter er valgfrie.

Eksempel

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

Felter

FeltTypeBetydning
requires.interfacesliste af strengeFunktioner, rollen har brug for, f.eks. mail eller ledger. Gives ved ansættelsen; hver operation, der kræver godkendelse, forbliver et godkendelsespunkt. Se Funktioner og godkendelser.
requires.pluginsliste af strengePlugins, der installeres sammen med medarbejderen. Brug det kun, når rollen virkelig afhænger af ét plugin; foretræk en funktion.
requires.toolsliste af strengeVærktøjer, der indlæses i medarbejderens session fra første tur. Det springer aldrig godkendelse over.
skillsliste af strengeFærdigheder fra markedspladsen, der skal installeres og bruges: @org/skills/name, eventuelt @version, eller en SKIL--kode. Færdigheder i pakkens egen skills/-mappe kræver ingen post.
inputslistSpørgsmål, som ejeren besvarer ved ansættelsen. Se Input.
memoryobjectHvordan samtaler og hukommelse holdes. Se Persona og hukommelse.
subscribesliste af strengeOmråder med virksomhedsfakta, som medarbejderen læser igen, når de ændres, f.eks. finance.ar.*.
ceilingmapOperation til "approval". Den operation spørger altid ejeren for denne medarbejder. Ingen anden værdi accepteres.
workflowsmapWorkflownavn til workflow. Se Workflows.
toolslistHTTP-værktøjer, der serveres af en apps sidecar. Se Sidecar-værktøjer.
scopesmapNavngivne grupper af tools, skills og plugins. Et scopes plugins beskrives for medarbejderen, når det scope er aktivt.

Input

Et input er et spørgsmål, som ejeren besvarer ved ansættelsen. Svarene vises for medarbejderen under "Configured Inputs" og udfylder {{key}}-pladsholdere i overvågnings- og mappetriggere.

{
  "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"
}
FeltStandardBetydning
keypåkrævetNavn, der bruges i pladsholdere. name accepteres som reserve.
labelfra keySpørgsmålet, der vises for ejeren.
typetexttext, textarea, number, select, checkbox eller radio.
requiredfalseMarkerer spørgsmålet som et, ejeren skal besvare.
defaultingenForudfyldt svar. Ikke tilladt på et pengespørgsmål.
placeholder, descriptioningenHjælpetekst.
optionsingenFor select og radio: {value, label}-objekter eller almindelige strenge.
idingenEt stabilt navn med punktummer for faktummet, f.eks. finance.ap.invoice_mailbox, så andre medarbejdere kan dele det.
scopecompanycompany: et fælles faktum for virksomheden. seat: kun denne ansættelse.
missingingenHvad medarbejderen gør, mens spørgsmålet er ubesvaret.
moneyfalseMarkerer et pengebeløb. Et pengespørgsmål kan ikke have en standardværdi.

Sidecar-værktøjer

En app med en sidecar eksponerer HTTP-endpoints for sin medarbejder som værktøjer. Nebo registrerer hver post som app__<app>__<name> og sender kald til sidecaren på method og path. Se 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

Hver nøgle under workflows navngiver ét workflow; navnet er dets identifikator. Det fulde format findes under Workflows, Udløsere og Aktiviteter.