Buenas prácticas para redactar guías

Las interacciones del Agente AI no son deterministas, lo que significa que pueden responder de forma diferente a la misma consulta en diferentes sesiones, incluso cuando se utiliza la misma guía. Sin embargo, puede modelar su comportamiento y mejorar la coherencia siguiendo las mejores prácticas cuando escriba las instrucciones de una guía.

Planifique sus guías

Cuando planifique su guía, asegúrese de no pasarse de la meta y de que sus guías no sean largas.

Mantener la guía centrada en una sola tarea

Se recomienda diseñar cada guía para gestionar una única intención de cliente bien definida, como "modificar fecha de entrega" o "consultar saldo de cuenta". Limitar cada guía a una sola intención restringe el alcance del LLM para garantizar la previsibilidad y la precisión. Para las conversaciones con varias intenciones, conecte varios bloques de guía dentro de un único flujo de arquitectura.

La guía debe ser breve

Para construir una guía de éxito, empiece primero por los pasos esenciales, valídelos con usuarios y datos reales y amplíe poco a poco las capacidades hasta conseguir el resultado deseado. Con las bases adecuadas y un enfoque iterativo, los agentes de IA pueden aportar un valor empresarial real, automatizando no sólo tareas, sino flujos de trabajo completos con inteligencia y adaptabilidad. 

Mantener un tono profesional y conversacional

Aunque las instrucciones del guía sean técnicas, la interacción resultante con el agente de IA debe ser natural. Formule sus instrucciones de manera que creen un tono profesional, útil y conversacional.

Construye tus guías

Siga estas directrices para estructurar, dar formato y crear tareas sencillas y manejables.

Estructuración y formato de la guía 

  • Numere el primer paso manualmente. El editor continúa la numeración mientras usted pulsa Intro. 
  • Utilice la sangría para representar una forma de jerarquía, de modo que su agente de IA pueda interpretar bien la estructura. 
  • Utiliza comillas cuando quieras que tu agente de IA diga una frase o mensaje específico. Por ejemplo: "¿Puede describir las luces de estado de su router?".
  • Mencione las unidades o monedas que forman parte de la guía. Por ejemplo, "Todos los valores de los productos están en euros".
  • Utilice formatos específicos para las fechas. Por ejemplo, "dd/mm/aaaa".

Divida su tarea en pasos sencillos

Divida una tarea compleja en pasos más sencillos y manejables. Este proceso garantiza que su Agente Virtual pueda seguir las instrucciones con precisión sin sentirse abrumado.

  • Numere cada paso en el orden en que desea que su agente de IA ejecute la tarea. La numeración de los pasos también le permite ordenar a su agente de IA que rompa la ejecución secuencial y salte a cualquiera de los pasos de la guía.
  • Como medida adicional, segregue su guía en pasos principales y subpasos. Con este enfoque, puede asignar un nombre único a sus pasos principales, permitiendo a su agente de IA saltar a cualquiera de los pasos principales según sea necesario.
1. Basic checks
   ...
2. AB Refund
   ...
3. Refund
   ...
4. Troubleshooting
  - If customer has a model type A or B:
    - Go to: [AB Refund]
  - else if customer has any other type:
    - Go to: [Refund]

Activar una acción o consulta del cliente al final de cada paso

  • Asegúrese de que cada paso de la guía hace que su agente de IA anticipe una acción o respuesta del cliente.
  • Si el paso actual no tiene tal consulta, combínelo con el siguiente paso que sí requiera una respuesta del cliente. 
  • Utilice un único mensaje cuando desee que su agente de IA diga varios mensajes de forma secuencial, sin esperar una respuesta del cliente. 

Buen ejemplo

Mal ejemplo
  1. Recopilar información sobre pedidos y correos electrónicos de clientes

 - El agente pregunta al cliente por su {{Variable.orderID}}

 - El cliente proporciona {{Variable.orderID}}

 - El agente pregunta al cliente por su {{Variable.email}}

 - El cliente proporciona {{Variable.email}}

 - Llama a {{Action.getOrderStatus}} usando {{Variable.orderID}} y {{Variable.email}}

  1. Recopilar información sobre pedidos y correos electrónicos de clientes

 - El agente pregunta al cliente por su {{Variable.orderID}}

 - El agente pregunta al cliente por su {{Variable.email}}

 - Llama a {{Action.getOrderStatus}} usando {{Variable.orderID}} y {{Variable.email}}

Utilice corchetes para saltar entre pasos

  • Haga referencia a otros pasos utilizando corchetes. 
  • Indique claramente los pasos de destino.

Buen ejemplo

Mal ejemplo

Vaya al paso [Recopilar información del paciente].

Vaya al paso 2.

Reducir la ambigüedad

  • Cuando definas los pasos, sé preciso y específico sobre el resultado o la respuesta que quieres del agente de IA.
  • Absténgase de utilizar instrucciones ambiguas, vagas o amplias. Unas instrucciones claras ayudan a sus agentes de IA a producir mejores resultados.
  • Proporcione tanto contexto como sea posible incluyendo variables, acciones de datos y orientación específica sobre el manejo de diferentes escenarios. Prepare a sus agentes para hacer frente a situaciones imprevistas con un plan de contingencia. Por ejemplo, si un usuario dice "No lo sé", su agente debe reconocer la incertidumbre del usuario y responder con "Lo siento, no puedo ayudarle con su consulta". ¿Desea conectar con un agente humano?". Puede añadir un subpaso bajo el paso principal para gestionar estos escenarios inesperados.

    Previsualizar e iterar

    • Pruebe su guía conectándola a un flujo de bots de Architect y perfeccione sus instrucciones hasta que esté satisfecho con el rendimiento de su agente de IA. Para más información, consulte Guías de prueba y solución de problemas.