Mejores prácticas para construir agentes.

Diseña agentes para flujos de trabajo reales

Los agentes efectivos no son bots independientes, están integrados en flujos de trabajo bien definidos. Comienza con un flujo de trabajo que ya exista en tus procesos empresariales e identifica tareas repetibles basadas en reglas. Estos son candidatos ideales para la automatización de agentes.

Antes de construir, realiza un ejercicio de asignación de flujo de trabajo:

• Identifica los puntos de decisión y los formatos de entrada/salida.
• Busca flujos estructurados y predecibles (por ejemplo, triaje de tickets, comprobaciones de cumplimiento).
• Evita diseñar agentes como reemplazo de flujos de trabajo. Los agentes son componentes que permiten la toma de decisiones dentro de los flujos de trabajo.

Consejo: utiliza patrones de agentes fáciles de implementar para escalar rápidamente al tiempo que gestionas el riesgo.

Delimita el ámbito y especialidad

Los agentes funcionan mejor cuando son específicos para una tarea y están limitados por responsabilidad. Evita sobrecargar a los agentes con varios roles. Una buena práctica es mantener a cada agente centrado en una sola responsabilidad (por ejemplo, extraer datos de facturas, clasificar la intención del cliente).

Beneficios de delimitar el ámbito:

• Depuración e iteración más fáciles
• Rendimiento y evaluación más estables
• Menor riesgo de desalineación o alucinación

Diseña solicitudes claras e iterativas.

El diseño de solicitudes está en el corazón del comportamiento del agente. Usa solicitudes agénticas, un estilo evolucionado de solicitudes que incluye:

• Roles y personas definidos
• Desglose claro de tareas e instrucciones de razonamiento
• Formato de salida y guía de gestión de errores

Por ejemplo, en lugar de pedir "Resume este documento", una solicitud agéntica podría ser: "Eres analista de cumplimiento. Divide este documento de política en secciones. Resume cada sección en dos frases y señala los posibles vacíos en la política. Explica cómo segmentaste el documento».

En lugar de codificar muestras de entrada/salida en solicitudes, utiliza conjuntos de evaluación estructurados para probar casos límite y escenarios. Esto hace que tu agente sea más robusto y más fácil de iterar.

Iterar en tus solicitudes de forma sistemática:

• Ajusta la estructura, los roles y las rutas de razonamiento.
• Realiza un seguimiento de los cambios en la precisión, la cobertura y el éxito de la tarea.
• Usa herramientas como la validación de solicitudes y el entorno de prueba de Agent Builder para experimentar.

Consejo: utiliza el inglés como idioma predeterminado. Los agentes funcionan mejor cuando las solicitudes, las definiciones de esquema y las instrucciones de herramientas están escritas en inglés. El uso de caracteres que no son del idioma inglés puede afectar a las llamadas de herramientas o al análisis de funciones.

Aprovechar las entradas estructuradas

Preprocesa los datos antes de que lleguen al agente. Usa tecnologías como Document Understanding y Extracción y procesamiento inteligentes (IXP) para extraer entradas estructuradas. Alimentar con datos sin procesar o ruidosos a un agente degrada la calidad de salida y aumenta la complejidad de la solicitud.

Definir criterios de éxito y estrategias de evaluación

Tus agentes necesitan objetivos claros y medibles para ser fiables. Diseña KPI y mecanismos de evaluación:

• Umbrales de precisión
• Puntuación de confianza
• Consistencia de respuesta
• Transparencia de razonamiento

Ve más allá del «¿funcionó?» y observa cómo funcionó. Usa registros de seguimiento y registros de trabajo para evaluar las llamadas de herramientas, las cadenas de decisiones y el uso del contexto.

Crea conjuntos de datos de evaluación que prueben casos límite, variaciones de contexto y condiciones específicas del dominio. Estos deben incluir:

• Entradas adversariales
• Consultas con bajo contexto
• Formato inesperado
• Pruebas de límite del sistema

Implementar escalada con intervención humana (HITL)

Los agentes deben saber cuándo pedir ayuda. Integra las rutas de escalada HITL para manejar:

• Missing data
• Fallos de herramienta
• Decisiones ambiguas
• Excepciones regulatorias o de reglas empresariales

Usa el bucle interno para escaladas rápidas y el bucle externo para aprobaciones estructuradas. Cada escalada debería:

• Desencadenar actualizaciones de memoria.
• Informar del comportamiento futuro del agente.
• Apoyar el refinamiento del uso de herramientas.

Usar barreras de seguridad y convenciones de nomenclatura

Define herramientas con:

• Nombres alfanuméricos en minúsculas
• Sin caracteres especiales ni espacios
• Etiquetas descriptivas basadas en funciones (por ejemplo, web_search, document_analysis).

Esto garantiza la compatibilidad con la lógica de análisis y llamada del LLM.

Usa barreras de seguridad para aplicar la seguridad y la gobernanza:

• Filtra o bloquea entradas de herramientas no seguras.
• Escala el uso de herramientas a los humanos cuando sea necesario.
• Registra y supervisa las interacciones de herramientas para asegurar el cumplimiento.

Supervisar agentes después de la implementación

Tu agente no termina una vez implementado. Configurar un bucle de supervisión y recalibración:

• Revisa el rendimiento con los datos de runtime.
• Busca desviaciones en el uso de herramientas o en la lógica.
• Compara de forma coherente.
• Usa la interfaz de comentarios en los seguimientos para refinar la memoria del agente y mejorar los comportamientos futuros.

Nota: evita modelar flujos de trabajo largos y deterministas con reglas empresariales estrictas directamente dentro de los agentes. En su lugar, utiliza la automatización estándar o la orquestación BPMN.