NeboAI
NeboAI
Empezar

Referencia de agent.json

agent.json contiene todo lo que no es prosa en un empleado: las capacidades que necesita, las preguntas que hace al propietario, cómo se guarda su memoria, qué operaciones necesitan siempre aprobación y los flujos de trabajo que ejecuta. Todos los campos son opcionales.

Ejemplo

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

Campos

CampoTipoSignificado
requires.interfaceslista de cadenasCapacidades que necesita el puesto, como mail o ledger. Se conceden al contratarlo; cada operación sujeta a aprobación sigue siendo un elemento de aprobación. Consulta Capacidades y aprobaciones.
requires.pluginslista de cadenasPlugins que se instalan con el empleado. Úsalo solo cuando el puesto dependa de verdad de un plugin concreto; es preferible una capacidad.
requires.toolslista de cadenasHerramientas que se cargan en la sesión del empleado desde su primer turno. Esto nunca se salta la aprobación.
skillslista de cadenasSkills de la tienda que se instalan y usan: @org/skills/name, opcionalmente con @version, o un código SKIL-. Las skills de la carpeta skills/ del propio paquete no necesitan entrada.
inputslistPreguntas que el propietario responde al contratarlo. Consulta Entradas.
memoryobjectCómo se guardan las conversaciones y la memoria. Consulta Personalidad y memoria.
subscribeslista de cadenasÁreas de datos de la empresa que el empleado vuelve a leer cuando cambian, como finance.ar.*.
ceilingmapOperación y "approval". Esa operación siempre pide permiso al propietario para este empleado. No se acepta ningún otro valor.
workflowsmapNombre del flujo de trabajo y su flujo. Consulta Flujos de trabajo.
toolslistHerramientas HTTP servidas por el sidecar de una app. Consulta Herramientas del sidecar.
scopesmapGrupos con nombre de tools, skills y plugins. Los plugins de un ámbito se le describen al empleado cuando ese ámbito está activo.

Entradas

Una entrada es una pregunta que responde el propietario al contratar. Las respuestas le aparecen al empleado en «Configured Inputs» y rellenan los marcadores {{key}} de los disparadores de vigilancia y de carpeta.

{
  "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"
}
CampoValor predeterminadoSignificado
keyobligatorioNombre que se usa en los marcadores de posición. Como alternativa se acepta name.
labela partir de keyLa pregunta que se muestra al propietario.
typetexttext, textarea, number, select, checkbox o radio.
requiredfalseMarca la pregunta como una que el propietario debe responder.
defaultningunoRespuesta rellenada de antemano. No se permite en una pregunta de importe.
placeholder, descriptionningunoTexto de ayuda.
optionsningunoPara select y radio: objetos {value, label} o cadenas simples.
idningunoUn nombre estable con puntos para el dato, como finance.ap.invoice_mailbox, para que otros empleados puedan compartirlo.
scopecompanycompany: un dato compartido de la empresa. seat: solo para esta contratación.
missingningunoLo que hace el empleado mientras la pregunta está sin responder.
moneyfalseIndica un importe. Una pregunta de importe no puede tener valor predeterminado.

Herramientas del sidecar

Una app con sidecar expone endpoints HTTP a su empleado como herramientas. Nebo registra cada entrada como app__<app>__<name> y envía las llamadas al sidecar en method y path. Consulta Sidecar de la 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" } } }
  }
]

Flujos de trabajo

Cada clave de workflows da nombre a un flujo de trabajo; el nombre es su identificador. El formato completo está en Flujos de trabajo, Activadores y Actividades.