NeboAI
NeboAI
Kom igång

agent.json-referens

agent.json innehåller allt om en medarbetare som inte är prosa: de funktioner den kräver, frågorna den ställer till ägaren, hur dess minne sparas, vilka åtgärder som alltid kräver godkännande och vilka arbetsflöden den kör. Alla fält är valfria.

Exempel

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

Fält

FältTypBetydelse
requires.interfaceslista med strängarFunktioner som rollen behöver, till exempel mail eller ledger. Beviljas vid anställningen; varje åtgärd som kräver godkännande förblir ett godkännandeärende. Se Funktioner och godkännanden.
requires.pluginslista med strängarPlugins som installeras med medarbetaren. Använd bara när rollen verkligen är beroende av ett visst plugin; föredra en funktion.
requires.toolslista med strängarVerktyg som läses in i medarbetarens session från första turen. Det kringgår aldrig godkännanden.
skillslista med strängarFärdigheter från marknadsplatsen att installera och använda: @org/skills/name, eventuellt @version, eller en SKIL--kod. Färdigheter i paketets egen skills/-mapp behöver ingen post.
inputslistFrågor som ägaren besvarar vid anställningen. Se Indata.
memoryobjectHur konversationer och minne sparas. Se Persona och minne.
subscribeslista med strängarOmråden med företagsfakta som medarbetaren läser om när de ändras, till exempel finance.ar.*.
ceilingmapÅtgärd mappad till "approval". Den åtgärden frågar alltid ägaren för den här medarbetaren. Inget annat värde accepteras.
workflowsmapArbetsflödets namn mappat till arbetsflödet. Se Arbetsflöden.
toolslistHTTP-verktyg som serveras av en apps sidecar. Se Sidecar-verktyg.
scopesmapNamngivna grupper av tools, skills och plugins. Ett omfångs plugins beskrivs för medarbetaren när omfånget är aktivt.

Indata

En indata är en fråga som ägaren svarar på vid anställningen. Svaren visas för medarbetaren under ”Configured Inputs” och fyller i platshållarna {{key}} i bevaknings- och mapputlösare.

{
  "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"
}
FältStandardBetydelse
keyobligatorisktNamn som används i platshållare. name accepteras som reserv.
labelfrån keyFrågan som visas för ägaren.
typetexttext, textarea, number, select, checkbox eller radio.
requiredfalseMarkerar frågan som en som ägaren måste besvara.
defaultingetFörifyllt svar. Inte tillåtet för en fråga om pengar.
placeholder, descriptioningetHjälptext.
optionsingetFör select och radio: {value, label}-objekt eller vanliga strängar.
idingetEtt stabilt namn med punkter för faktumet, till exempel finance.ap.invoice_mailbox, så att andra medarbetare kan dela det.
scopecompanycompany: ett gemensamt faktum för företaget. seat: bara den här anställningen.
missingingetVad medarbetaren gör medan frågan är obesvarad.
moneyfalseMarkerar ett belopp. En fråga om pengar kan inte ha ett standardvärde.

Sidecar-verktyg

En app med en sidecar exponerar HTTP-slutpunkter för sin medarbetare som verktyg. Nebo registrerar varje post som app__<app>__<name> och skickar anrop till sidecaren på method och 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" } } }
  }
]

Arbetsflöden

Varje nyckel under workflows namnger ett arbetsflöde; namnet är dess identifierare. Det fullständiga formatet finns under Arbetsflöden, Utlösare och Aktiviteter.