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.
Combinación: utiliza un mecanismo de integración comprobado entre agentes, workflows o eventos del CRM. Activar un workflow cambia la ruta del agente; no implica que Legacy y Workflow corran juntos.

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, configuración manual y recomendaciones; agent-spec.json para futuras ediciones; y acceptance-cases.json si se aportan casos. Son auxiliares: el importador no los ejecuta. Las instrucciones se reúnen en un único registro para conservar todos sus bloques durante la importación.

Archivos y ajustes del agente

El generador puede incluir archivos locales reales mediante attachments. Verifica las referencias del manifest, las rutas dentro del ZIP y el límite de tamaño. El spec portable conserva referencias a los archivos dentro del paquete para permitir futuras ediciones.

La skill también revisa empresa, conocimiento, documentos, webs, recursos, roles, estilo, canales, Drive, seguimientos, automatizaciones, modelos, voz, multimedia, RAG, moderación, Jev y conexión Nexus. Distingue lo que el agente permite configurar de lo que su exportador transporta.

RAG, roles/estilos, conexiones y algunas políticas necesitan verificación o configuración posterior. El ZIP no garantiza copiarlos. Las tools requieren un UUID del catálogo del tenant; un UUID con formato válido no demuestra que exista.

En una edición, se parte de la exportación o spec completo para conservar lo no solicitado. El paquete conserva la información disponible y señala las configuraciones que deben reconstruirse manualmente.

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.

Lecturas relacionadas

Calidad de conversación y coordinación

La entrevista pide ejemplos de consultas, objeciones, respuestas ideales, fuentes aprobadas, límites y criterios de escalamiento. Define pruebas para respuestas sustentadas, falta de evidencia, herramientas con error, corrección de datos y traspaso humano.

Si hace falta un proceso más controlado o seguimiento CRM, prepara un prompt para Atendium Workflows o Nexus con el contexto ya resuelto. Si ese trabajo ya fue pedido, continúa dentro del mismo alcance sin volver a solicitarlo. Aprobar la estructura del ZIP no demuestra que las respuestas del agente sean correctas: esas pruebas se informan por separado.

Revisión de contratos: 22 de septiembre de 2026.