NeboAI
NeboAI
Comenzar

Paquetes de empleados

Un paquete de empleado describe un puesto que una empresa puede contratar: de qué es responsable 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
ArchivoObligatorioPropósito
AGENT.mdsíLa personalidad: quién es el empleado, cómo trabaja y sus reglas. Consulta Personalidad y memoria.
agent.jsonnoLas 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/noSkills en el formato estándar SKILL.md. Solo este empleado las ve.
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 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:

  1. Lee lo que necesita el paquete sin consultar a un modelo: cada capacidad de requires.interfaces, cada plugin de requires.plugins y cada capacidad o plugin que nombra un disparador de vigilancia.
  2. 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.
  3. Instala las dependencias: los plugins de requires.plugins, las skills de la tienda nombradas en skills y en las actividades, y las dependencias que se declararon al publicar el paquete.
  4. Le 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é 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 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 dinero 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 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