¿Cómo podemos ayudar?

Este documento describe las mejores prácticas para crear y optimizar AI Agent Orchestration en la AI Agent Platform.

• Mejores prácticas generales
  • Escriba instrucciones claras y específicas, sin conflictos
  • Facilite ejemplos relevantes en las instrucciones
  • Divida tareas complejas en subtareas más sencillas
  • Utilice skills para tareas estructuradas
  • Utilice variables para facilitar contexto
  • Deje la assignment de variables en skills
  • Comparta solo la información relevante de las variables
  • Pruebe los cambios de forma sistemática
  • Monitorice e itere en función del uso real
• Mejores prácticas para el diseño de múltiples AI Agent
  • Defina roles y responsabilidades claras
  • No utilice un Routing Agent con solo un Action Agent
  • Evite reutilizar la misma herramienta en varios Agentes
  • La estructuración de la respuesta debe llevarla a cabo el Supervisor
  • Utilice una transferencia estructurada entre Agentes
  • Pruebe los escenarios de colaboración entre AI Agent

Antes de construir en la AI Agent Platform, asegúrese de comprender sus conceptos básicos. Esto incluye cómo se comunican los Agentes, cómo se estructuran y cómo afecta la configuración de nodos al comportamiento. Una buena comprensión le ayudará a diseñar flujos más eficaces y predecibles.
 

Mejores prácticas generales

Estas prácticas se aplican de manera general a las instrucciones de los AI Agents y al diseño del flujo, tanto en escenarios de un solo Agente como de varios Agentes.

Escriba instrucciones claras y específicas, sin conflictos

• Evite instrucciones contradictorias, utilice un lenguaje directo y sin ambigüedades. Indique exactamente lo que espera que haga el Agente (por ejemplo: "Resuma los puntos clave…" en lugar de "Lea esto").
• Mantenga el mismo idioma en las instrucciones. Por ejemplo, si comienza la instrucción en inglés, continúe en inglés.
• Consejo: Pregúntese: Si le diera esta instrucción a una persona, ¿entendería claramente lo que debe hacer? Si la respuesta es no, revísela.

Facilite ejemplos relevantes en las instrucciones

• Añada ejemplos que muestren el formato ideal de entrada/salida o el tono esperado.
• Utilice afirmaciones como "Usted es…" para ayudar al Agente a adoptar una determinada personalidad o enfoque.

Divida tareas complejas en subtareas más sencillas

• Divida los objetivos grandes o de varios pasos en partes más pequeñas y manejables.
• Siga los pasos secuenciales para gestionar cada subtarea, introduciendo los resultados de los pasos anteriores a los siguientes.
• Si la tarea es demasiado compleja, considere dividirla añadiendo un nuevo AI Agent dedicado a manejar esa tarea.

Utilice skills para tareas estructuradas

Utilice una skill que pueda reutilizarse: Para funciones de utilidad, lógica basada en números, generación de números aleatorios, gestión de datos sensibles o flujos de trabajo estrictos.

Utilice variables para facilitar contexto

• Utilice la Application Input u Output de una skill para introducir datos del cliente o el Conversation History anterior a través de variables, creando así conversaciones más dinámicas.
• Asegúrese de que las variables tengan una descripción clara en la lista de variables para que los AI Agents sepan qué representa cada variable.
• Utilice skills para completar el valor de las variables. Evite utilizar las instrucciones de los AI Agents para completar los valores de las variables.

Deje la assignment de variables en skills

• Las instrucciones del Agente no deben utilizarse para manipular o asignar valores a las variables.
• Utilice una skill, como una Integration o un Workflow, para rellenar o actualizar variables.
• La gestión de variables debe realizarse mediante pasos estructurados, no a través de instrucciones de razonamiento.

Comparta solo la información relevante de las variables

Evite pasar objetos completos o estructuras de variables grandes, a menos que sea necesario. En lugar de eso, extraiga y comparta únicamente la información específica que el AI Agent necesita para completar su tarea.

Facilitar demasiados datos irrelevantes, especialmente sin contexto adecuado, puede confundir al Agente y provocar respuestas menos precisas o fuera de tema.

Pruebe los cambios de forma sistemática

Pruebe una modificación a la vez y observe los resultados antes de hacer más cambios. Asegúrese de utilizar ejemplos de entrada consistentes para comparar el comportamiento del Agente entre versiones.

Monitorice e itere en función del uso real

Revise los registros de interacción para comprender cómo los usuarios interactúan con los Agentes. Perfeccione las instrucciones y la lógica del Agente basándose en los patrones de conversación reales y en los puntos problemáticos.

Mejores prácticas para el diseño de múltiples AI Agent

Esta sección aborda el diseño y la orquestación de múltiples AI Agents dentro de un mismo flujo, garantizando una colaboración eficaz, una división de tareas adecuada y un buen rendimiento del sistema.

Defina roles y responsabilidades claras

• Asigne a cada Agente un rol diferente en función de las tareas que deba realizar.
• Evite la superposición de funcionalidades para reducir la redundancia y la confusión.
• Utilice nombres y descripciones claros y específicos que reflejen el rol de cada Agente para mantener la claridad.
• Evite utilizar siglas en los AI Agents.
• No le indique a un Agente que haga algo que no le corresponde.

No utilice un Routing Agent con solo un Action Agent

Un Routing Agent debe tener más de un Action Agent subordinado para justificar su rol en la jerarquía. Crear un Routing Agent con un solo Action Agent introduce una complejidad y Latency innecesarias y no cumple una función de enrutamiento.

Evite reutilizar la misma herramienta en varios Agentes

Al diseñar AI Agents, es importante que sus responsabilidades estén claramente definidas y no se solapen de forma significativa. Aunque varios Agentes puedan utilizar las mismas herramientas, la ambigüedad en su ámbito de trabajo puede dificultar al Supervisor determinar qué Agente debe encargarse de una tarea concreta.

Si varios Agentes necesitan acceder a funcionalidades similares, considere consolidar esa lógica en un solo Agente o utilizar variables compartidas para la coordinación.

La estructuración de la respuesta debe llevarla a cabo el Supervisor

El Supervisor Agent es quien recibe el mensaje y es el último Agente encargado de preparar la respuesta que se enviará al usuario. Si es necesario modificar de algún modo la respuesta, esas instrucciones deben incluirse en el Supervisor Agent.

Utilice una transferencia estructurada entre Agentes

Defina de forma explícita qué salida de un Agente servirá como entrada para el siguiente. Utilice un lenguaje claro en las instrucciones de transferencia para especificar qué debe hacer el siguiente Agente con los datos recibidos.

Pruebe los escenarios de colaboración entre AI Agent

Simule diferentes caminos dentro del flujo de múltiples agentes para detectar interacciones inesperadas. Asegúrese de monitorizar cómo responden los Agentes a casos límite y entradas ambiguas.