Skills y Agents: separar capacidades en un asistente empresarial

Un asistente crece mal cuando herramientas, políticas y tono viven en un único prompt. La solución no es añadir más instrucciones, sino separar responsabilidades y hacer que cada ejecución sea observable.

Qué representa una Skill

Una Skill es una capacidad concreta con entrada, resultado, validaciones y herramientas permitidas. Debe poder probarse sin iniciar una conversación completa.

name: create-follow-up-task
input:
  contact_id: string
  due_at: datetime
permissions:
  - crm.tasks.write
requires_confirmation: true

El contrato limita lo que el modelo puede solicitar. La implementación del servidor vuelve a validar cada campo y permiso.

Qué representa un Agent

Un Agent combina objetivo, tono, límites y un conjunto reducido de Skills. Un agente comercial puede consultar contactos y proponer seguimientos; no necesita editar facturación ni administrar usuarios.

{
  "agent": "sales-assistant",
  "skills": ["find-contact", "summarize-thread", "create-follow-up-task"],
  "connection": "ghl_location_42"
}

Las conexiones pertenecen al servidor. El Agent conoce una referencia autorizada, nunca el token real.

Orquestación sin saltar permisos

Una capa de orquestación selecciona agente, prepara contexto y registra la ejecución. Si un agente delega a otro, la nueva llamada vuelve a comprobar identidad y alcance. Delegar trabajo no delega automáticamente autoridad.

Los resultados de herramientas se consideran datos no confiables. Una descripción obtenida del CRM no puede ordenar al sistema que ignore sus políticas.

Estado y memoria

Separo historial visible, memoria resumida y estado de ejecución. La memoria almacena hechos útiles con procedencia y fecha; no transforma una suposición del modelo en verdad permanente.

{
  "fact": "El cliente prefiere contacto por correo",
  "source": "message_981",
  "recorded_at": "2026-08-01T15:20:00Z"
}

Versiones y evaluación

Prompts, esquemas y Skills tienen versión. Antes de publicar ejecuto casos conocidos: solicitud normal, datos incompletos, herramienta caída, intento de exceder permisos y contenido malicioso. Comparo utilidad, seguridad, costo y latencia.

Separar Skills, Agents, conexiones y orquestación reduce prompts gigantes. Más importante aún, convierte el asistente en un sistema que puede revisarse, probarse y mejorar sin depender de una conversación impredecible.