Las siguientes prácticas recomendadas pueden ayudarte a compilar apps de agente sólidas.
Nombre del agente en lenguaje natural
Usa un lenguaje natural con significados claros para los nombres de los agentes. Por ejemplo, “Agente del Centro de ayuda al cliente” es más descriptivo que “especialista_empresarial”, que ayuda al rendimiento del LLM en el tiempo de ejecución.
Objetivos concisos
Los objetivos deben ser una descripción concisa del propósito del agente.
Proporcionar instrucciones de calidad
Las instrucciones deben:
- reflejar el enfoque paso a paso para resolver un problema del usuario final
- ser oraciones concisas en lenguaje natural de instrucciones de alto nivel
- Ser claro y especificar las situaciones para los usos de las herramientas
Al menos un ejemplo para cada agente
Debes tener al menos un ejemplo para cada agente, pero se recomienda tener al menos cuatro. Los ejemplos deben incluir situaciones de camino feliz.
Sin suficientes ejemplos, es probable que un agente dé como resultado un comportamiento impredecible. Si tu agente no responde o no se comporta de la manera esperada, es probable que la causa sea ejemplos faltantes o mal definidos. Intenta mejorar tus ejemplos o agregar otros nuevos.
Precisión de instrucciones y ejemplos
Si bien es útil escribir instrucciones claras y descriptivas, lo que determina la exactitud del comportamiento del agente es la calidad y la cantidad de tus ejemplos. En otras palabras, dedica más tiempo a escribir ejemplos exhaustivos que a escribir instrucciones perfectamente precisas.
Herramientas de referencia en los ejemplos
Si el agente está diseñado para proporcionar respuestas mediante el uso de herramientas, haz referencia a las herramientas en los ejemplos correspondientes a este tipo de solicitud.
Campo del esquema de la herramienta operationId
Cuando defines esquemas para tus herramientas, el valor operationId es importante.
Las instrucciones de tu agente harán referencia a este valor.
Las siguientes son recomendaciones de nombres para este campo:
- Solo letras, números y guiones bajos.
- Debe ser único entre todos los
operationIddescritos en el esquema. - Debe ser un nombre significativo que refleje la capacidad proporcionada.
Validación del esquema de la herramienta
Debes validar el esquema de tu herramienta. Puedes usar el editor de Swagger para verificar la sintaxis de tu esquema de OpenAPI 3.0.
Cómo controlar resultados de herramientas vacíos
Cuando tu agente depende de una herramienta para informar su respuesta, el resultado de una herramienta vacía puede generar un comportamiento impredecible. A veces, el LLM del agente alucinará la información en una respuesta en lugar del resultado de una herramienta. Para evitar esto, puedes agregar instrucciones específicas para garantizar que el LLM del agente no intente responder por su cuenta.
Algunos casos de uso requieren que las respuestas del agente se basen bien en los resultados de las herramientas o los datos proporcionados, y deben mitigar las respuestas solo en función del conocimiento del LLM del agente.
Ejemplos de instrucciones para mitigar las alucinaciones:
- "Debes usar la herramienta para responder todas las preguntas de los usuarios".
- "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 por ti. Por ejemplo, intenta crear un ejemplo de esquema de openAPI 3.0 para el Calendario de Google.
Agentes enfocados
Evita crear agentes muy grandes y complejos. Cada agente debe realizar una tarea específica y clara. Si tienes un agente complejo, considera dividirlo en agentes secundarios más pequeños.
Cómo evitar los bucles y la recursividad
No crees bucles o recursividad cuando vincules apps de agente en tus instrucciones.
Proporciona información de enrutamiento a los ejemplos
Cuando un agente debe enrutar a otro, debes proporcionar esta información a los ejemplos. Esto se proporciona a un ejemplo del campo Finalizar ejemplo con información de salida de la sección de ejemplo Entrada y salida.
Por ejemplo, la última oración de este campo podría ser “Redirigir al agente predeterminado para realizar más consultas”.
Usa las funciones de JavaScript de Dialogflow CX Messenger para la personalización
Cuando se usa Dialogflow CX Messenger, las siguientes funciones son útiles para enviar información de personalización del usuario desde la interfaz web al agente: