Guía el comportamiento del agente con contexto creado

En esta página, se describe cómo proporcionar el mejor contexto creado a tus agentes de datos de la API de Conversational Analytics escribiendo instrucciones eficaces a través de instrucciones del sistema y, para algunas fuentes de datos, proporcionando contexto estructurado adicional. Si bien proporcionar contexto creado por el usuario es opcional, un contexto bien estructurado puede mejorar la exactitud y la relevancia de las respuestas que proporciona la API.

¿Qué es el contexto creado?

El contexto creado es una guía que los desarrolladores pueden proporcionar para dar forma al comportamiento de un agente de datos y definir mejor las respuestas de la API. Esta orientación incluye instrucciones del sistema de formato libre y, para algunas fuentes de datos, campos de contexto estructurados con información como descripciones de tablas y consultas de ejemplo. Para responder preguntas, el agente combina este contexto creado con información de fuentes de datos, como tablas de BigQuery, exploraciones de Looker, Data Studio y fuentes de datos de bases de datos, y con el historial de conversaciones (para conversaciones de varios turnos).

Si proporcionas orientación clara a través de campos contextuales estructurados y de instrucciones del sistema de formato libre, puedes mejorar la capacidad del agente para interpretar las preguntas de los usuarios y generar respuestas útiles y precisas. Un contexto bien definido es especialmente útil si te conectas a datos como tablas de BigQuery. Por ejemplo, puedes usar el contexto creado para proporcionar los siguientes tipos de orientación a un agente:

  • Lógica específica del negocio: Define a un cliente "leal" como aquel que realizó más de cinco compras en un período determinado.
  • Formato de respuesta: Resume todas las respuestas de tu agente de datos en 20 palabras o menos para ahorrar tiempo a los usuarios.
  • Presentación de datos: Aplica formato a todos los números para que coincidan con la guía de estilo de la empresa.

Proporciona contexto creado por el usuario

La información específica que puedes proporcionar depende de tu fuente de datos. Para los datos de BigQuery, los datos de Looker y los datos de la base de datos, puedes definir el contexto estructurado y las instrucciones del sistema. Para obtener mejores resultados, primero proporciona contexto al agente a través de los campos estructurados disponibles. Luego, puedes proporcionar orientación complementaria definiendo instrucciones del sistema.

Proporcionas contexto estructurado en los campos de la API para obtener detalles, como descripciones de tablas y consultas de ejemplo. Proporciona instrucciones del sistema como una cadena con formato YAML con el parámetro system_instruction.

Después de definir el contexto creado, puedes proporcionarlo a la API en una de las siguientes llamadas:

Práctica recomendada para compilar agentes: Usa el control de versión para el contexto creado

Usa los campos stagingContext, publishedContext y lastPublishedContext para controlar las versiones de contexto cuando crees agentes con la API de Conversational Analytics. En el siguiente caso de uso, se muestra cómo usar estos campos para crear una versión de etapa de pruebas y de producción del contexto del agente.

Supongamos que usas un agente existente con el campo publishedContext, pero necesitas actualizarlo (por ejemplo, hacer que todos los gráficos sean verdes en lugar de azules).

Para realizar los cambios y probarlos antes de publicarlos, sigue estos pasos:

  • Realiza los cambios en el agente en el campo stagingContext y pruébalo con los cambios.
  • Cuando los cambios estén listos, actualiza el campo publishedContext con los cambios de stagingContext.
  • Puedes volver al agente anterior según sea necesario actualizando publishedContext a lastPublishedContext.