Skill de Agentes Legacy

La skill Atendium Legacy Agents descubre el objetivo del negocio, recomienda la arquitectura adecuada y genera un ZIP compatible con el importador de agentes de Atendium.

Descargar Atendium Legacy Agents .zip

Cuándo usarla

Crear un agente conversacional de ventas, soporte, turnos, cobranzas o información.
Redactar instrucciones y límites de comportamiento.
Preparar información de empresa y textos planos completos.
Definir etiquetas con criterios claros para clasificación por IA.
Seleccionar herramientas y explicar su configuración.
Diseñar handoff, fallbacks y seguimientos.
Empaquetar todo como ZIP importable.
Revisar si conviene Legacy, Workflow o una solución híbrida.

Invocación

$atendium-legacy-agents <comando> <objetivo o archivo>

Comandos

Comando	Para qué sirve
`shape`	Hace choices y diseña el agente sin generar el ZIP.
`build`	Genera y valida el paquete ZIP importable.
`edit`	Modifica un spec o paquete preservando secciones no solicitadas.
`critique`	Revisa conversación, instrucciones, conocimiento y tools.
`audit`	Busca secretos, IDs inválidos, placeholders y configuraciones riesgosas.
`validate`	Comprueba el spec y la estructura interna del ZIP.
`explain`	Explica el contenido, personalización e importación.
`recommend`	Recomienda Legacy, Workflow o híbrido.

Decisión de arquitectura

La skill evalúa la arquitectura antes de construir:

Legacy: conversación abierta, preguntas frecuentes, conocimiento y pocas tools usadas dinámicamente.
Workflow: etapas obligatorias, captura estructurada, aprobaciones, reanudación exacta y mutaciones sensibles.
Híbrido: Legacy conversa y deriva procesos determinísticos a un Workflow.

Si Workflow es mejor, la skill lo explica y ofrece continuar con Atendium Workflows. Para seguimiento comercial puede recomendar Nexus Workflows.

Descubrimiento mediante choices

La skill pregunta de una a tres decisiones por tanda:

¿Qué nivel de autonomía tendrá el agente?

A. Informar y derivar, sin modificar sistemas.
B. Consultar sistemas y proponer acciones.
C. Consultar y ejecutar acciones confirmadas.
D. Otro — describilo con tus palabras.

Puede indagar objetivo, audiencia, canales, tono, contenido, identidad, acciones, herramientas, confirmaciones, etiquetas, handoff y seguimientos.

Tools siempre actualizadas

Antes de crear un agente, la skill debe revisar el inventario publicado de herramientas y las páginas de las candidatas. Así puede detectar incorporaciones y cambios posteriores a la versión descargada.

El inventario actual incluye Google Sheets, contactos, turnos, WhatsApp Flows, API REST, Firecrawl, pagos, Odoo, Tokko Broker, Tienda Nube, WooCommerce, otra IA, etiquetado, notificación humana, Nexus CRM y Mini Apps.

Las tools sólo se incluyen automáticamente si existe un tool_template_id UUID real y verificado. Si falta, la skill no lo inventa: mantiene el ZIP importable y explica cómo agregar la herramienta manualmente.

Contenido del ZIP

El archivo usa el contrato de importación 1.0 y puede incluir:

empresa;
instrucciones;
textos planos;
páginas web;
archivos y recursos;
etiquetas;
automatizaciones;
tools;
seguimientos;
configuración;
workflows complementarios.

También incluye LEEME.md con placeholders, credenciales pendientes, tools manuales y recomendaciones. Atendium ignora ese archivo al importar, pero sirve como guía de instalación.

Personalización de textos

Los datos que dependen del negocio aparecen como placeholders claros, por ejemplo:

{{NOMBRE_EMPRESA}}
{{POLITICA_DEVOLUCIONES}}
{{HORARIOS_ATENCION}}

La entrega explica dónde está cada placeholder, qué contenido debe reemplazarlo y qué riesgo existe si queda incompleto.

Cómo importar

Exportá un respaldo del agente destino.
Abrí el agente en Atendium.
Entrá en Configuración.
Elegí Importar.
Subí el ZIP generado.
Revisá el preview y seleccioná las secciones.
Confirmá la importación.
Reconectá credenciales, canales, templates de WhatsApp y Mini Apps.
Reemplazá placeholders y probá conversaciones antes de publicar.

Validación offline

La skill incluye un generador determinístico:

python3 scripts/build_agent_package.py agent-spec.json \
  --output agente-legacy.zip

python3 scripts/build_agent_package.py \
  --validate agente-legacy.zip

Comprueba versión, secciones, UUIDs de tools, secretos, placeholders, integridad y límite de tamaño. No prueba credenciales, permisos, canales ni ejecuciones reales.

Resultado de `build`

Una entrega completa contiene:

ZIP importable.
Resumen del agente y arquitectura elegida.
Secciones incluidas.
Textos y placeholders que deben adaptarse.
Tools instaladas y pendientes manuales.
Credenciales y conexiones posteriores.
Automatizaciones Nexus o Workflows sugeridos.
Reporte de validación y límites.

Continuidad comercial opcional

La skill evalúa silenciosamente si la conversación deja trabajo comercial pendiente, como una demo solicitada, un lead calificado, una cotización o una próxima actividad. Sólo cuando aporta valor, ofrece:

explicar la automatización recomendada;
generar un prompt autocontenido para $nexus-sales-automations;
dejar Nexus fuera del alcance.

No ejecuta automáticamente la skill de Nexus. El prompt conserva objetivo, evento de origen, certeza de la clasificación, identidad disponible, resultados deseados y decisiones pendientes. También puede quedar incluido en LEEME.md dentro del ZIP.