Patrón de Agente que Usa Herramientas

What It Is

En este patrón, los agentes no “hacen cosas” de forma implícita. Actúan únicamente a través de herramientas explícitas con entradas y salidas definidas.

Las herramientas son capacidades con permisos: llamadas a API, acciones sobre bases de datos, operaciones con archivos, disparadores de flujos de trabajo, notificaciones y aprobaciones.

Esto convierte las acciones del agente en operaciones observables, comprobables y auditables.

Why It Matters in Enterprise

Las herramientas explícitas marcan la diferencia entre autonomía de demostración y autonomía de producción.

Permiten el mínimo privilegio, los registros de auditoría y modos de fallo seguros (reintentos, reversiones, aprobaciones) por cada herramienta.

También mejoran la evaluación: se pueden medir tasas de éxito, latencia, categorías de error y cumplimiento de política por herramienta.

Common Mistakes

  • Permitir acciones “libres” (por ejemplo, que el agente escriba directamente en los sistemas sin límites de herramienta).
  • Herramientas demasiado potentes (“actualizarCualquierCosa(id, payload)”) en lugar de operaciones acotadas y bien delimitadas.
  • No validar las entradas y salidas de las herramientas ni aplicar comprobaciones de política antes de la ejecución.
  • Ausencia de observabilidad: sin registros, sin identificadores de correlación ni atribución a usuario o agente.

How Copyl Supports This Pattern

  • El enfoque de plataforma de Copyl favorece que las acciones de los agentes pasen por herramientas y flujos de trabajo integrados, en lugar de efectos secundarios ocultos.
  • Los permisos, los registros de auditoría y la aplicación de políticas actúan en el límite de la herramienta para mantener las acciones gobernables.
  • Esto crea un marco operativo más seguro para las integraciones y la automatización empresariales.

Related Patterns