NeboAI
NeboAI
Comenzar

Referencia de agent.json

agent.json contiene todo lo de un empleado que no es prosa: las capacidades que requiere, las preguntas que le hace al propietario, cómo se guarda su memoria, qué operaciones siempre necesitan 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 que requiere aprobación sigue siendo un elemento por aprobar. Consulta Capacidades y aprobaciones.
requires.pluginslista de cadenasPlugins que se instalan junto con el empleado. Úsalo solo cuando el puesto de verdad depende de un plugin; es mejor usar una capacidad.
requires.toolslista de cadenasHerramientas que se cargan en la sesión del empleado desde su primer turno. Esto nunca evita 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 → "approval". Esa operación siempre le pide aprobación al propietario para este empleado. No se acepta ningún otro valor.
workflowsmapNombre del flujo de trabajo → flujo de trabajo. Consulta Flujos de trabajo.
toolslistHerramientas HTTP que ofrece 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

Un dato de entrada es una pregunta que el dueño responde al contratar. Las respuestas le aparecen al empleado en "Configured Inputs" y completan los marcadores {{key}} de los disparadores de vigilancia y de carpetas.

{
  "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. Se acepta name como alternativa.
labelde keyLa pregunta que se le muestra al propietario.
typetexttext, textarea, number, select, checkbox o radio.
requiredfalseIndica que el propietario debe responder la pregunta.
defaultningunoRespuesta precargada. No se permite en una pregunta de dinero.
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 no tiene respuesta.
moneyfalseIndica una cantidad de dinero. Una pregunta de dinero no puede tener un 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 apps.

"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 dentro de workflows nombra un flujo de trabajo; el nombre es su identificador. El formato completo está en Flujos de trabajo, Disparadores y Actividades.