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
| Campo | Tipo | Significado |
|---|---|---|
requires.interfaces | lista de cadenas | Capacidades 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.plugins | lista de cadenas | Plugins que se instalan con el empleado. Úsalo solo cuando el puesto dependa de verdad de un plugin concreto; es preferible una capacidad. |
requires.tools | lista de cadenas | Herramientas que se cargan en la sesión del empleado desde su primer turno. Esto nunca se salta la aprobación. |
skills | lista de cadenas | Skills 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. |
inputs | list | Preguntas que el propietario responde al contratarlo. Consulta Entradas. |
memory | object | Cómo se guardan las conversaciones y la memoria. Consulta Personalidad y memoria. |
subscribes | lista de cadenas | Áreas de datos de la empresa que el empleado vuelve a leer cuando cambian, como finance.ar.*. |
ceiling | map | Operación y "approval". Esa operación siempre pide permiso al propietario para este empleado. No se acepta ningún otro valor. |
workflows | map | Nombre del flujo de trabajo y su flujo. Consulta Flujos de trabajo. |
tools | list | Herramientas HTTP servidas por el sidecar de una app. Consulta Herramientas del sidecar. |
scopes | map | Grupos 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"
} | Campo | Valor predeterminado | Significado |
|---|---|---|
key | obligatorio | Nombre que se usa en los marcadores de posición. Como alternativa se acepta name. |
label | a partir de key | La pregunta que se muestra al propietario. |
type | text | text, textarea, number, select, checkbox o radio. |
required | false | Marca la pregunta como una que el propietario debe responder. |
default | ninguno | Respuesta rellenada de antemano. No se permite en una pregunta de importe. |
placeholder, description | ninguno | Texto de ayuda. |
options | ninguno | Para select y radio: objetos {value, label} o cadenas simples. |
id | ninguno | Un nombre estable con puntos para el dato, como finance.ap.invoice_mailbox, para que otros empleados puedan compartirlo. |
scope | company | company: un dato compartido de la empresa. seat: solo para esta contratación. |
missing | ninguno | Lo que hace el empleado mientras la pregunta está sin responder. |
money | false | Indica 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.