Prácticas recomendadas

Sigue estas prácticas recomendadas: puede 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, “Customer Agente del Centro de ayuda" es más descriptivo que “empresa_especialista”, que ayuda Rendimiento de los 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 cumplir con los siguientes requisitos:

  • 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 una 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 genere un comportamiento impredecible. Si tu agente no responde o no se comporta de la manera que esperas, es probable que la causa sean los 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, la calidad y cantidad de tus ejemplos que determinan la exactitud del comportamiento del agente. En otras palabras, dedicar más tiempo a escribir ejemplos exhaustivos que escribir instrucciones perfectamente precisas.

Herramientas de referencia en los ejemplos

Si el agente está diseñado para proporcionar respuestas mediante el uso de herramientas, consulta el en los ejemplos correspondientes a este tipo de solicitud.

Campo del esquema de la herramienta operationId

Cuando definas esquemas para tus herramientas, el valor de 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 operationId descritos 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 la Editor de Swagger para verificar la sintaxis del 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 puede generar un comportamiento impredecible de los agentes. A veces, el LLM del agente información con alucinaciones 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 respuesta por su cuenta.

Algunos casos de uso requieren que las respuestas de los agentes se basen bien en los resultados de las herramientas o los datos proporcionados y debes mitigar las respuestas basadas solo en los LLM del agente conocimientos.

Ejemplos de instrucciones para mitigar las alucinaciones:

  • "Debes usar la herramienta para responder todas las preguntas de los usuarios".
  • "Si no recibes datos de la herramienta, responde que no conoces respuesta a la consulta del usuario"
  • "No inventes una respuesta si no obtienes datos de la herramienta".

Genera un esquema con Gemini

Gemini 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 desglosarla 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 agente debes proporcionar esta información a los ejemplos. Esto se proporciona a un ejemplo del Ejemplo final con información de salida. de la clase Input & Output.

Por ejemplo: la última oración de este campo podría ser “Redirige al agente predeterminado para realizar más consultas”.

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

Cuando uses Dialogflow CX Messenger, las siguientes funciones son útiles para enviar la personalización del usuario de la interfaz web al agente: