NeboAI
NeboAI
Empezar

Paquetes de empleados

Un paquete de empleado describe un puesto que una empresa puede contratar: de qué se encarga el empleado, cómo trabaja, qué tipos de sistemas necesita y qué hace por su cuenta. Lo escribes como una carpeta con un AGENT.md y, cuando el puesto necesita algo más que chat, un agent.json.

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
ArchivoObligatorioFinalidad
AGENT.mdsíLa personalidad: quién es el empleado, cómo trabaja y sus normas. Consulta Personalidad y memoria.
agent.jsonnoLas 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/noSkills en el formato estándar SKILL.md. Solo las ve este empleado.
manifest.jsonsolo appsIdentidad con "type": "app". La tienda escribe su propio manifiesto cuando empaqueta un empleado.
ui/solo appsLa 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:

  1. Lee las necesidades del paquete sin consultar a ningún modelo: cada capacidad de requires.interfaces, cada plugin de requires.plugins y cada capacidad o plugin que nombre un activador de vigilancia.
  2. 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.
  3. Instala las dependencias: los plugins de requires.plugins, las skills de la tienda nombradas en skills y en las actividades, y las dependencias declaradas cuando se publicó el paquete.
  4. Hace al propietario las preguntas de inputs y 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 event con una lista sources vacía.
  • Dos actividades con el mismo id en un mismo flujo de trabajo.
  • Una entrada con un scope distinto de company o seat, o una pregunta de importe con un valor predeterminado.
  • Un valor de ceiling distinto 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