Prácticas recomendadas de la guía

Nota: El Generative AI App Builder todavía se refiere a las guías como agentes. Este término se actualiza a guía en la consola.

Estas prácticas recomendadas pueden ayudarte a crear agentes sólidos.

Nombre de la guía en lenguaje natural

Los nombres de las guías deben ser claros, descriptivos y estar en inglés natural. Esto ayuda al rendimiento del generador de IA durante el tiempo de ejecución. Por ejemplo, "Guía del Centro de ayuda para clientes" es mejor que "especialista_empresa".

Todos los nombres deben tener menos de 64 caracteres, incluidas las letras en inglés y los espacios.

Objetivos concisos

Los objetivos deben describir de forma concisa el propósito de la guía.

Proporciona instrucciones de calidad

Usa instrucciones para lo siguiente:

• Reflejan el enfoque paso a paso para resolver un problema del usuario final.
• Proporciona oraciones concisas en lenguaje natural con instrucciones de alto nivel.
• Especifica las situaciones en las que se usan las herramientas de forma directa.

Al menos un ejemplo para cada guía

Incluye al menos un ejemplo para cada guía y busca al menos cuatro ejemplos. Incluye situaciones de ruta feliz.

Sin suficientes ejemplos, una guía puede dar como resultado un comportamiento impredecible. Si tu guía no responde o no se comporta como esperas, es probable que la causa sean ejemplos faltantes o mal definidos. Intenta mejorar tus ejemplos o agregar otros nuevos.

Precisión de las instrucciones y los ejemplos

Si bien ayuda a escribir instrucciones claras y descriptivas, la calidad y la cantidad de tus ejemplos son las que determinan la exactitud del comportamiento de la guía. En otras palabras, dedica más tiempo a escribir ejemplos exhaustivos que a escribir instrucciones perfectamente precisas.

Haz referencia a las herramientas en los ejemplos

Si la guía está diseñada para proporcionar respuestas con herramientas, haz referencia a las herramientas en los ejemplos correspondientes a este tipo de solicitud.

Campo operationId del esquema de la herramienta

Cuando defines esquemas para tus herramientas, el valor operationId es importante. Las instrucciones de tu guía harán referencia a este valor.

Usa estas recomendaciones de nombres para este campo:

• Puedes utilizar letras, números y guiones bajos,
• Asegúrate de que el nombre sea único entre todos los operationId descritos en el esquema.
• Elige un nombre significativo que refleje la capacidad proporcionada.

Validación del esquema de la herramienta

Valida el esquema de tu herramienta. Puedes usar el editor de Swagger para verificar la sintaxis del esquema de OpenAPI 3.0.

Cómo controlar los resultados de herramientas vacíos

Cuando tu guía se basa en una herramienta para fundamentar su respuesta, un resultado de herramienta vacío puede generar un comportamiento impredecible de la guía. A veces, el generador de IA de la guía alucinará información en una respuesta en lugar de un resultado de la herramienta. Para evitar comportamientos impredecibles, agrega instrucciones específicas que ayuden a garantizar que el generador de IA de la guía no intente responder por su cuenta.

Algunos casos de uso requieren que bases las respuestas de la guía en los resultados de las herramientas o en los datos proporcionados, y que mitiges las respuestas basadas solo en el conocimiento del generador de IA de la guía.

Estos son algunos ejemplos de instrucciones para mitigar las alucinaciones:

• "Debes usar la herramienta para responder todas las preguntas de los usuarios".
• "Si no obtienes ningún dato de la herramienta, responde que no sabes la respuesta a la consulta del usuario".
• "No inventes una respuesta si no obtienes datos de la herramienta. En cambio, pídele al usuario que reformule su consulta o que la aclare".

Genera un esquema con Gemini

Gemini puede generar un esquema por ti. Por ejemplo, pídele que cree un esquema de OpenAPI 3.0 de ejemplo para el Calendario de Google.

Guías enfocadas

No crees guías muy grandes y complejas. Cada guía debe realizar una tarea específica y clara. Si tienes una guía compleja, considera dividirla en guías secundarias más pequeñas.

Evita los bucles y la recursividad

No crees bucles ni recursiones cuando vincules agentes en tus instrucciones. Se puede producir un bucle si intentas enrutar a una guía principal que, de forma directa o indirecta, llamó a la actual.

Proporciona información de enrutamiento a los ejemplos

Cuando una guía se enruta a otra, proporciona esta información a los ejemplos. Proporciona esta información a un ejemplo del campo Finalizar el ejemplo con información del resultado de la sección de ejemplo Entrada y salida.

Por ejemplo, la oración final de este campo podría ser "Vuelve a enrutar a la guía predeterminada para realizar más consultas".

Usa las funciones de JavaScript de Dialogflow CX Messenger para la personalización

Cuando usas Dialogflow CX Messenger, las siguientes funciones de JavaScript te permiten enviar información de personalización del usuario desde la interfaz web a la guía:

• setQueryParameters
• setContext

Planificación del rendimiento

Las funciones generativas suelen requerir varios segundos o incluso decenas de segundos para generar una respuesta. Si bien las guías mejoran la naturalidad de las conversaciones, es importante administrar los tiempos de respuesta para mantener una experiencia positiva para el usuario final.

Para optimizar el rendimiento, usa estas estrategias:

• Equilibra el uso de las funciones generativas: Considera con cuidado la compensación entre el tiempo necesario para ejecutar varias funciones generativas y el valor que aportan a la conversación. Evita usar estas funciones en exceso si no contribuyen de manera significativa al objetivo del usuario.
• Minimiza la entrada de funciones generativas: Intenta recopilar y procesar la cantidad mínima de información necesaria para que un generador de IA genere una respuesta útil. Esto puede reducir significativamente el tiempo de procesamiento.
• Usa el almacenamiento en caché de contexto: Si usas Gemini a través de una herramienta y tienes un contexto inicial grande, explora la información de almacenamiento en caché con el almacenamiento en caché de contexto de Vertex AI para evitar solicitudes repetitivas de los mismos datos.
• Implementa respuestas fijas para aumentar la velocidad: Si tu aplicación no requiere contenido dinámico y único, considera almacenar las respuestas de uso frecuente en una base de datos tradicional, como Firebase. Como están predefinidas y disponibles, estas respuestas fijas proporcionan tiempos de respuesta mucho más rápidos que una función generativa que necesita calcular una respuesta sobre la marcha.
• Indica al generador de IA que produzca respuestas concisas de la guía: Para la entrada y salida de texto, el tiempo de respuesta del generador de IA depende en gran medida del modelo que se use y de la longitud de la salida. Las respuestas breves pueden mejorar significativamente el rendimiento. Si bien la longitud de la entrada también influye, la longitud de la salida tiene un impacto mayor.