NeboAI
NeboAI
Kom i gang

agent.json-referanse

agent.json inneholder alt om en ansatt som ikke er prosa: funksjonene den krever, spørsmålene den stiller eieren, hvordan minnet holdes, hvilke operasjoner som alltid krever godkjenning, og arbeidsflytene den kjører. Alle felt 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." }
      ]
    }
  }
}

Felt

FeltTypeBetydning
requires.interfacesliste med strengerFunksjoner rollen trenger, som mail eller ledger. Gis ved ansettelse; hver operasjon som krever godkjenning, forblir et godkjenningselement. Se Funksjoner og godkjenninger.
requires.pluginsliste med strengerTillegg som installeres sammen med den ansatte. Bruk bare når rollen virkelig er avhengig av ett tillegg; foretrekk en funksjon.
requires.toolsliste med strengerVerktøy som lastes inn i den ansattes økt fra første tur. Dette hopper aldri over godkjenning.
skillsliste med strengerMarkedsplassferdigheter som skal installeres og brukes: @org/skills/name, eventuelt med @version, eller en SKIL--kode. Ferdigheter i pakkens egen skills/-mappe trenger ingen oppføring.
inputslistSpørsmål eieren svarer på ved ansettelse. Se Inndata.
memoryobjectHvordan samtaler og minne holdes. Se Persona og minne.
subscribesliste med strengerOmråder med bedriftsfakta den ansatte leser på nytt når de endres, for eksempel finance.ar.*.
ceilingmapOperasjon til "approval". Den operasjonen spør alltid eieren for denne ansatte. Ingen annen verdi godtas.
workflowsmapNavn på arbeidsflyt til arbeidsflyt. Se Arbeidsflyter.
toolslistHTTP-verktøy servert av en apps sidecar. Se Sidecar-verktøy.
scopesmapNavngitte grupper av tools, skills og plugins. plugins i et omfang beskrives for den ansatte når omfanget er aktivt.

Inndata

En inndata er et spørsmål eieren svarer på ved ansettelse. Svarene vises for den ansatte under «Configured Inputs» og fyller ut plassholderne {{key}} i overvåkings- og mappeutløsere.

{
  "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åkrevdNavnet som brukes i plassholdere. name godtas som reserve.
labelfra keySpørsmålet som vises for eieren.
typetexttext, textarea, number, select, checkbox eller radio.
requiredfalseMerker spørsmålet som et eieren må svare på.
defaultingenForhåndsutfylt svar. Ikke tillatt på et pengespørsmål.
placeholder, descriptioningenHjelpetekst.
optionsingenFor select og radio: {value, label}-objekter eller vanlige strenger.
idingenEt stabilt navn med punktum for faktumet, som finance.ap.invoice_mailbox, slik at andre ansatte kan dele det.
scopecompanycompany: et delt bedriftsfaktum. seat: bare denne ansettelsen.
missingingenHva den ansatte gjør mens spørsmålet er ubesvart.
moneyfalseMerker et pengebeløp. Et pengespørsmål kan ikke ha en standardverdi.

Sidecar-verktøy

En app med en sidecar eksponerer HTTP-endepunkter for sin ansatt som verktøy. Nebo registrerer hver oppføring som app__<app>__<name> og sender kall 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" } } }
  }
]

Arbeidsflyter

Hver nøkkel under workflows navngir én arbeidsflyt; navnet er identifikatoren. Hele formatet finner du under Arbeidsflyter, Utløsere og Aktiviteter.