Prácticas recomendadas de la guía

Nota: Generative AI App Builder aún se refiere a las guías como agentes. Esta información se actualizará a guía pronto en la consola.

Las siguientes 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 en el tiempo de ejecución. Por ejemplo, "Customer Help Center Playbook" es mejor que "company_specialist".

Mantén todos los nombres con menos de 64 caracteres, incluidos los alfabetos y los espacios en inglés.

Objetivos concisos

Los objetivos deben ser una descripción concisa del propósito de la guía.

Proporciona instrucciones de calidad

Las instrucciones deben cumplir con lo siguiente:

• Reflejan el enfoque paso a paso para resolver un problema del usuario final.
• Deben ser oraciones concisas en lenguaje natural con instrucciones de alto nivel.
• Deben ser directas y especificar las situaciones en las que se usan las herramientas.

Al menos un ejemplo para cada guía

Debes tener al menos un ejemplo para cada guía, pero se recomienda tener al menos cuatro. Los ejemplos deben incluir situaciones de camino ideal.

Sin suficientes ejemplos, es probable que una guía dé como resultado un comportamiento impredecible. Si tu guía no responde o no se comporta de la manera que 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 es útil escribir instrucciones claras y descriptivas, la calidad y la cantidad de tus ejemplos determinan la precisión del comportamiento de la guía. En otras palabras, dedica más tiempo a escribir ejemplos detallados que a escribir instrucciones perfectamente precisas.

Herramientas de referencia en ejemplos

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

Campo operationId del esquema de herramientas

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

Las siguientes son recomendaciones de nombres para este campo:

• Solo letras, números y guiones bajos
• Debe ser exclusivo entre todos los operationId descritos en el esquema.
• Debe ser un nombre significativo que refleje la capacidad proporcionada.

Validación del esquema de herramientas

Debes validar 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 vacíos de las herramientas

Cuando tu guía depende de una herramienta para informar su respuesta, un resultado vacío de la herramienta 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 esto, puedes agregar instrucciones específicas para asegurarte de que el generador de IA de la guía no intente responder por sí solo.

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

Los siguientes son ejemplos de instrucciones para mitigar las alucinaciones:

• "Debes usar la herramienta para responder todas las preguntas del usuario".
• "Si no obtienes datos 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".

Genera un esquema con Gemini

Gemini puede generar un esquema para ti. Por ejemplo, prueba con "can you create an example openAPI 3.0 schema for Google Calendar".

Guías enfocadas

Evita crear 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 recursión

No crees bucles ni recursión cuando vincules agentes en tus instrucciones. Puede ocurrir un bucle si intentas enrutar a una guía superior que, directa o indirectamente, llamó a la actual.

Proporciona información de enrutamiento a los ejemplos

Cuando una guía debe enrutar a otra guía, debes proporcionar esta información a los ejemplos. Esto se proporciona a un ejemplo del campo End example with output information de la sección de ejemplo Input &Output.

Por ejemplo, la oración final de este campo podría ser "Reroute back to the default playbook for further queries".

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

Cuando usas Dialogflow CX Messenger, las siguientes funciones son útiles para enviar información de personalización del usuario desde la interfaz web a la guía:

• setQueryParameters
• setContext

Planificación del rendimiento

Por lo general, las funciones generativas requieren varios segundos o incluso decenas de segundos para generar una respuesta. Si bien las guías mejoran la naturalidad conversacional, es fundamental administrar los tiempos de respuesta para mantener una experiencia positiva del usuario final.

Las siguientes son algunas estrategias para optimizar el rendimiento:

• Equilibra el uso de funciones generativas: Considera cuidadosamente la compensación entre el tiempo necesario para ejecutar varias funciones generativas y el valor que aportan a la conversación. Evita usar en exceso estas funciones 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 el almacenamiento en caché de información 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 que se usan con frecuencia en una base de datos tradicional como Firebase. Debido a que 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 usa y de la longitud de la salida. Las respuestas breves pueden mejorar significativamente el rendimiento. Si bien la longitud de entrada también es un factor, la longitud de salida tiene un impacto mayor.