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 | Propósito |
|---|---|---|
AGENT.md | sí | La personalidad: quién es el empleado, cómo trabaja y sus reglas. Consulta Personalidad y memoria. |
agent.json | no | Las capacidades que requiere, las preguntas para el propietario, los flujos de trabajo, la configuración de 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 este empleado las ve. |
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 le pone nombre al empleado y le da 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.
Agrega agent.json cuando el puesto necesite un sistema, un dato de configuración del propietario o un trabajo que haga sin que se lo pidan. Este requiere la capacidad mail, hace una pregunta al contratarlo y responde 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. Al ejecutarse, se resuelve en el plugin que el propietario conectó para el correo. Consulta Flujos de trabajo para ver los disparadores 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 al empleado alrededor de un segundo después de un cambio. Si quitas la carpeta, el empleado se desactiva, pero se conserva su registro.
Nebo carga empleados desde 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 en <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 en 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 lo que necesita el paquete sin consultar a un modelo: cada capacidad de
requires.interfaces, cada plugin derequires.pluginsy cada capacidad o plugin que nombra un disparador de vigilancia. - Le 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 necesitan aprobación siguen necesitándola. 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 que se declararon al publicar el paquete. - Le 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é revisa Nebo
Nebo lee agent.json con tolerancia. Las claves desconocidas se ignoran. Un flujo de trabajo que no coincide con 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 de todos modos. Estos problemas hacen que se rechace el archivo completo:
- Un disparador
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 dinero 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 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, empresa o industria específicos. El propietario decide qué sistema cubre cada capacidad, así que un solo paquete sirve para cualquier empresa que lo contrate.
Siguiente
- Referencia de agent.json
- Personalidad y memoria
- Publicación: pon al empleado en la tienda.