NeboAI
NeboAI
Inizia

Riferimento agent.json

agent.json contiene tutto ciò che riguarda un dipendente e non è prosa: le capability che richiede, le domande che fa al titolare, come viene conservata la sua memoria, quali operazioni richiedono sempre approvazione e i flussi di lavoro che esegue. Ogni campo è facoltativo.

Esempio

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

Campi

CampoTipoSignificato
requires.interfaceselenco di stringheCapability di cui il ruolo ha bisogno, come mail o ledger. Concesse all’assunzione; ogni operazione soggetta ad approvazione resta una voce da approvare. Vedi Capability e approvazioni.
requires.pluginselenco di stringhePlugin installati insieme al dipendente. Usalo solo quando il ruolo dipende davvero da un plugin; preferisci una capability.
requires.toolselenco di stringheStrumenti caricati nella sessione del dipendente fin dal primo turno. Questo non salta mai l’approvazione.
skillselenco di stringheSkill del marketplace da installare e usare: @org/skills/name, facoltativamente @version, oppure un codice SKIL-. Le skill nella cartella skills/ del pacchetto non hanno bisogno di una voce.
inputslistDomande a cui il titolare risponde all’assunzione. Vedi Input.
memoryobjectCome vengono conservate conversazioni e memoria. Vedi Persona e memoria.
subscribeselenco di stringheAree di informazioni aziendali che il dipendente rilegge quando cambiano, come finance.ar.*.
ceilingmapDall’operazione a "approval". Per questo dipendente quell’operazione chiede sempre conferma al titolare. Nessun altro valore è accettato.
workflowsmapDal nome del flusso di lavoro al flusso di lavoro. Vedi Flussi di lavoro.
toolslistStrumenti HTTP serviti dal sidecar di un’app. Vedi Strumenti del sidecar.
scopesmapGruppi con nome di tools, skills e plugins. I plugins di un ambito vengono descritti al dipendente quando quell’ambito è attivo.

Input

Un input è una domanda a cui il proprietario risponde al momento dell’assunzione. Le risposte compaiono al dipendente sotto “Configured Inputs” e riempiono i segnaposto {{key}} nei trigger di monitoraggio e di cartella.

{
  "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"
}
CampoPredefinitoSignificato
keyobbligatorioNome usato nei segnaposto. In alternativa è accettato name.
labelda keyLa domanda mostrata al titolare.
typetexttext, textarea, number, select, checkbox o radio.
requiredfalseIndica che il titolare deve rispondere alla domanda.
defaultnessunoRisposta precompilata. Non consentita per una domanda su un importo.
placeholder, descriptionnessunoTesto di aiuto.
optionsnessunoPer select e radio: oggetti {value, label} o semplici stringhe.
idnessunoUn nome stabile, con punti, per l’informazione, come finance.ap.invoice_mailbox, così che altri dipendenti possano condividerla.
scopecompanycompany: un’informazione condivisa dell’azienda. seat: solo per questa assunzione.
missingnessunoCosa fa il dipendente finché la domanda non ha risposta.
moneyfalseIndica un importo di denaro. Una domanda su un importo non può avere un valore predefinito.

Strumenti del sidecar

Un’app con un sidecar espone endpoint HTTP al proprio dipendente come strumenti. Nebo registra ogni voce come app__<app>__<name> e invia le chiamate al sidecar su method e path. Vedi Sidecar delle app.

"tools": [
  {
    "name": "list_entries",
    "description": "List journal entries for a date range.",
    "method": "GET",
    "path": "/entries",
    "input_schema": { "type": "object", "properties": { "from": { "type": "string" } } }
  }
]

Flussi di lavoro

Ogni chiave sotto workflows indica un flusso di lavoro; il nome è il suo identificatore. Il formato completo è descritto in Flussi di lavoro, Trigger e Attività.