El paquete
support-coordinator/
├── AGENT.md # required: who the employee is and how it works
├── agent.json # optional: capabilities, inputs, workflows, memory
└── skills/ # optional: skills only this employee uses
└── reply-drafting/
└── SKILL.md | Archivo | Obligatorio | Finalidad |
|---|---|---|
AGENT.md | sí | La personalidad: quién es el empleado, cómo trabaja y sus normas. Consulta Personalidad y memoria. |
agent.json | no | Las capacidades que necesita, las preguntas para el propietario, los flujos de trabajo, la configuración de la memoria y los límites de aprobación. Consulta la referencia de agent.json. |
skills/ | no | Skills en el formato estándar SKILL.md. Solo las ve este empleado. |
manifest.json | solo apps | Identidad con "type": "app". La tienda escribe su propio manifiesto cuando empaqueta un empleado. |
ui/ | solo apps | La página de la app. Consulta Apps. |
Escribe un paquete
Empieza por la personalidad. El frontmatter da nombre al empleado y una descripción de una línea; el cuerpo son instrucciones en prosa sencilla.
--- name: Support Coordinator description: Answers every customer message the day it arrives and escalates what it cannot settle. --- # Support Coordinator You answer customer email for the company. Reply within the configured window, in the company's voice, and keep every thread moving until the customer has an answer. ## How you work - Read the whole thread before you reply. - Use the reply-drafting skill for every customer reply. - When a message is about money, draft a proposal for the owner instead of promising anything. ## Rules - Never promise a refund, a discount or a date you cannot confirm.
Añade agent.json cuando el puesto necesite un sistema, un ajuste del propietario o trabajo que haga sin que se lo pidan. Este requiere la capacidad mail, hace una pregunta al contratarlo y responde a cada mensaje nuevo en cuanto llega.
{
"requires": { "interfaces": ["mail"] },
"inputs": [
{
"key": "reply_window_hours",
"label": "Reply within (hours)",
"type": "number",
"id": "support.reply_window_hours",
"scope": "company",
"default": 24
}
],
"workflows": {
"new-mail": {
"trigger": { "type": "watch", "plugin": "mail", "event": "email.new" },
"description": "Handle each customer message as it arrives.",
"activities": [
{
"id": "reply",
"intent": "Read the message in _watch_payload, draft a reply within reply_window_hours, and escalate anything about money to the owner."
}
]
}
}
} La vigilancia nombra la capacidad mail, no un producto. En tiempo de ejecución se resuelve en el plugin que el propietario haya conectado para el correo. Consulta Flujos de trabajo para los activadores y las actividades.
Cárgalo en un bot
Coloca la carpeta en <data>/user/agents/<name>/. Nebo vigila AGENT.md, agent.json y manifest.json y vuelve a cargar el empleado aproximadamente un segundo después de cada cambio. Quitar la carpeta desactiva el empleado, pero conserva su registro.
Nebo carga empleados de tres orígenes, y los posteriores tienen prioridad: los empleados integrados en Nebo, los paquetes sellados de la tienda en <data>/nebo/agents/ y las carpetas de <data>/user/agents/. Un empleado también puede crear o cambiar un paquete por ti con sus herramientas create_employee y update_employee, que escriben esa misma carpeta.
Qué pasa al contratarlo
Cuando un propietario contrata a tu empleado desde la tienda o con un código AGNT-, Nebo:
- Lee las necesidades del paquete sin consultar a ningún modelo: cada capacidad de
requires.interfaces, cada plugin derequires.pluginsy cada capacidad o plugin que nombre un activador de vigilancia. - Muestra al propietario una sola frase de consentimiento para esas necesidades y, al contratarlo, se las concede a este empleado como permisos permanentes. Las operaciones que requieren aprobación la siguen requiriendo. Consulta Capacidades y aprobaciones.
- Instala las dependencias: los plugins de
requires.plugins, las skills de la tienda nombradas enskillsy en las actividades, y las dependencias declaradas cuando se publicó el paquete. - Hace al propietario las preguntas de
inputsy le avisa a través de la bandeja de entrada de cualquier capacidad que todavía no tenga conexión.
Un flujo de trabajo cuya capacidad no tiene conexión se conserva y se marca como degradado, con el motivo. Empieza a funcionar en cuanto el propietario conecta un sistema.
Qué comprueba Nebo
Nebo lee agent.json de forma flexible. Las claves desconocidas se ignoran. Un flujo de trabajo que no cumple el esquema se omite, y el propietario recibe un aviso en la bandeja de entrada de que no se ejecutará; el resto del empleado se carga igualmente. Estos problemas rechazan el archivo entero:
- Un activador
eventcon una listasourcesvacía. - Dos actividades con el mismo
iden un mismo flujo de trabajo. - Una entrada con un
scopedistinto decompanyoseat, o una pregunta de importe con un valor predeterminado. - Un valor de
ceilingdistinto de"approval". - Un árbol de llamadas telefónicas que no tenga exactamente un saludo y al menos una intención con nombre.
Algunas comprobaciones se hacen cuando un flujo de trabajo se inicia y no cuando se carga, como los parámetros que requiere cada tipo de actividad. Consulta Actividades.
Escribe responsabilidades, no herramientas. Un paquete de empleado nombra capacidades, como ledger o mail, y nunca un producto, una empresa o un sector concretos. El propietario decide qué sistema cubre cada capacidad, así que un mismo paquete sirve a todas las empresas que lo contratan.
Siguiente
- Referencia de agent.json
- Personalidad y memoria
- Publicación: publica el empleado en la tienda.