Crea y administra agentes de datos

Los agentes de datos te permiten seleccionar la experiencia de Conversational Analytics para tus usuarios. Con los agentes, puedes proporcionar a Conversational Analytics contexto e instrucciones para que pueda responder preguntas de manera más eficaz en casos de uso específicos. Los agentes permiten que los analistas asignen términos comerciales a campos específicos, especifiquen los mejores campos para filtrar y definan cálculos personalizados.

En esta página, se te guiará por los siguientes procesos:

• Cómo crear y editar agentes de datos
• Comparte agentes de datos con otros usuarios
• Borrar agentes de datos

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Antes de comenzar

El uso de Conversational Analytics se administra a través de una combinación de acceso al contenido, acceso a los datos y acceso a las funciones. Piensa en un agente de datos como otro tipo de contenido de Looker, como un panel, una vista o una carpeta. Para interactuar con los agentes de datos, se te debe asignar un rol de Looker que tenga los permisos necesarios para los modelos que subyacen en la función Explorar individual o que el agente de datos consultará. En algunos casos, también necesitarás acceder al agente. Para obtener más información sobre los permisos y el acceso necesarios para administrar y usar agentes de datos del usuario, consulta la tabla de permisos en la página de documentación Configura Conversational Analytics en Looker.

Crea y edita agentes de datos

Como tecnología en etapa inicial, los productos de Gemini para Google Cloud pueden generar resultados que parecen posibles, pero que no son correctos. Te recomendamos que valides todos los resultados de Gemini para los productos de Google Cloud antes de usarlos. Para obtener más información, consulta Gemini para Google Cloud y la IA responsable.

Para crear un nuevo agente de datos, sigue estos pasos:

1. Navega a la página Conversaciones.
2. En la pestaña Agentes, selecciona + Agente nuevo. O bien, en el panel izquierdo, selecciona sparkAdministrar agentes y, luego, + Nuevo agente.

3. En la página Agente nuevo, proporciona la siguiente información sobre tu agente de datos.

   • Nombre del agente: Ingresa un nombre para el agente. El nombre debe ser único y descriptivo.
   • Descripción del agente: Describe brevemente lo que puede hacer este agente y los datos que usa. Los usuarios verán esta descripción cuando seleccionen el agente para iniciar una conversación o cuando compartas el agente con ellos, así que asegúrate de que la descripción explique claramente el propósito del agente y cómo puede ser útil.
   • Datos: Sigue estos pasos para conectarte a un máximo de cinco Explorar existentes de Looker:
     1. En el campo Datos, haz clic en + Seleccionar Explores.
     2. En la ventana Search Explores, haz clic en las Exploraciones que deseas incluir en el agente de datos. Estas exploraciones aparecerán en el panel Exploraciones seleccionadas de la ventana.
     3. Para agregar la función Explorar seleccionada al agente de datos, haz clic en Guardar.

4. Instrucciones: Proporciona contexto para ayudar a Conversational Analytics a comprender cómo interactuar con tus datos y brindar respuestas precisas y pertinentes. Para ver ejemplos de los tipos de contexto que puedes proporcionar, consulta Cómo escribir instrucciones para el agente.

5. De manera opcional, para habilitar el Intérprete de código para todas las conversaciones con tu agente, selecciona Habilitar Advanced Analytics.

6. De manera opcional, puedes probar tu agente para definir mejor sus instrucciones y configuración.

7. Para guardar tu nuevo agente de datos, haz clic en Guardar.

Después de guardar el agente de datos, puedes compartirlo con otros usuarios y iniciar una conversación con él.

Escribe instrucciones del agente

Cuando creas un agente de datos, puedes agregar instrucciones de formato libre que definan el comportamiento principal del agente y le proporcionen contexto fundamental para que lo considere antes de procesar la instrucción de un usuario.

Importante: Si bien el campo Instrucciones es opcional y la estructura depende de tu criterio, te recomendamos que proporciones instrucciones bien estructuradas para permitir que el agente brinde respuestas más precisas y pertinentes.

Estos son algunos ejemplos de los tipos de contexto que puedes proporcionar en el campo Instrucciones:

• Campos clave: Los campos más importantes para el análisis
• Campos excluidos: Campos que el agente de datos debe evitar
• Filtrado y agrupación: Campos que el agente debe usar para filtrar y agrupar datos
• Preguntas de oro: Pares de preguntas en lenguaje natural y sus correspondientes preguntas de Explorar
• Personificación: Es un rol, una experiencia, un personaje o un tono que le asignas al agente.

Nota: Los tipos de contexto creado que puedes proporcionar a un agente de datos en Looker difieren ligeramente de los que puedes proporcionar a un agente que creas con la API de Conversational Analytics. Parte de lo que proporcionas en el campo Instrucciones en Looker, como las consultas de referencia, se puede proporcionar a un agente como contexto estructurado con la API de Conversational Analytics.

Si quieres obtener sugerencias y conocer las prácticas recomendadas para escribir instrucciones del agente, consulta Prácticas recomendadas para configurar Conversational Analytics en Looker.

Cómo definir una consulta de referencia de Looker

Para definir cada consulta de referencia de Looker para un Explorar determinado, proporciona valores para los siguientes campos:

• natural_language_questions: La pregunta en lenguaje natural que podría hacer un usuario
• looker_query: Es la consulta de referencia de Looker que corresponde a la pregunta en lenguaje natural.

Sugerencias para definir consultas de referencia de Looker:

Incluye diferentes tipos de preguntas y búsquedas que tengan una variedad de filtros y valores de filtro.

Si bien no hay límite en la cantidad de preguntas de referencia que puedes incluir en looker_golden_queries, te recomendamos que no incluyas más de 30 a 50 pares de preguntas y búsquedas.

Para el campo natural_language_questions, considera las preguntas que podría hacer un usuario sobre esa exploración y escríbelas en lenguaje natural. Puedes incluir más de una pregunta en el valor de este campo. Puedes obtener el valor del campo looker_query de los metadatos de la búsqueda de Explorar.

Las preguntas de referencia admiten los siguientes campos:

• model (cadena): Es el modelo de LookML que se usó para generar la consulta. Este es un campo obligatorio.
• explore (cadena): Es la función Explorar que se usó para generar la consulta. Este campo es obligatorio.
• fields[] (cadena): Son los campos que se recuperarán de la exploración, incluidas las dimensiones y las métricas. Este paso es opcional,
• filters[] (cadena): Son los filtros que se aplicarán a la exploración. Este paso es opcional,
• sorts[] (cadena): Es el ordenamiento que se aplicará a la exploración. Este es un campo opcional.
• limit (cadena): Es el límite de filas de datos que se aplicará a la exploración. Este campo es opcional.

Nota: Conversational Analytics no admite las preguntas de referencia que contienen pivots ni campos personalizados.

Para recuperar los metadatos de la consulta de Explorar directamente desde Explorar, sigue estos pasos:

1. En el Explorador, selecciona el menú Acciones de Explore y, luego, Obtener LookML.
2. Selecciona la pestaña Panel.
3. Copia los detalles de la consulta de LookML. Por ejemplo, la siguiente imagen muestra el LookML de una exploración llamada Order Items:

Copia los metadatos seleccionados para usarlos en tu consulta de referencia de Looker:

  model: thelook
  explore: order_items
  fields: [order_items.order_id, orders.status]
  sorts: [orders.status, order_items.order_id]
  limit: 500

Cómo probar un agente

Cuando creas o editas un agente, la página de detalles del agente incluye el panel Preview your agent. Puedes probar la configuración y las instrucciones del agente iniciando una conversación con él.

Debes hacer clic en Actualizar para que se refleje un cambio en la vista previa. Si el estado de guardado es Not saved, no se reflejarán en la vista previa las actualizaciones de la configuración.

Cómo editar un agente de datos existente

Para editar un agente de datos existente, sigue estos pasos:

1. En la página Conversaciones, selecciona sparkAdministrar agentes.
2. En la página Administrar agentes, selecciona el agente de datos que deseas editar.
3. Actualiza los detalles del agente según sea necesario. Puedes modificar los detalles que especificaste cuando creaste el agente, incluidos los campos Nombre del agente, Descripción del agente, Datos y Instrucciones. También puedes habilitar el Intérprete de código para tu agente.
4. Para guardar los cambios, haz clic en Update (Actualizar).

Compartir agentes de datos

Compartir permite que otros usuarios chateen con tu agente y sus Explorar. Puedes compartir un agente de datos con otros usuarios otorgándoles acceso al contenido del agente. Solo un usuario con los permisos y el acceso al contenido adecuados puede compartir un agente. Una vez que se crea un agente, puede tardar unos minutos en poder compartirse.

Nota: Otorgar a un usuario acceso al contenido de un agente no también le otorga acceso a la función Explorar que usa el agente. Cuando compartas un agente, asegúrate de que los usuarios también tengan los permisos necesarios para usar Conversational Analytics con el modelo en el que se basa la Exploración. Es posible que tu administrador de Looker deba otorgarte estos permisos.

Para compartir un agente de datos, sigue estos pasos:

1. En la página Conversaciones, selecciona sparkAdministrar agentes en el panel izquierdo.
2. Para abrir el menú del agente elegido, haz clic en el ícono de Más opciones y, luego, en Compartir.
3. Una vez que hayas agregado personas o grupos a la sección Quién puede acceder a este agente y hayas elegido el nivel de permisos que deben tener, haz clic en Agregar para colocarlos en la lista compartida.
4. Si quieres que los usuarios o grupos nuevos reciban un correo electrónico de notificación, selecciona la casilla de verificación Enviar un correo electrónico a las personas que acabas de agregar.
5. Después de realizar todos los cambios, haz clic en Guardar.

También puedes compartir un agente que acabas de crear o uno que estás editando haciendo clic en Compartir en la página de configuración del agente y siguiendo los pasos mencionados anteriormente.

Revoca el acceso a un agente de datos

Para revocar el acceso a un agente, sigue estos pasos:

1. En la página Conversations, haz clic en sparkAdministrar agentes en el panel izquierdo.
2. Para abrir el menú del agente elegido, haz clic en el ícono de Más opciones y, luego, en Compartir.
3. Haz clic en la X junto a los usuarios o grupos a los que se les debe quitar el acceso.
4. Después de realizar todos los cambios, haz clic en Guardar.

Si los usuarios que se quitaron tienen una conversación en curso, seguirán teniendo acceso durante uno o dos minutos mientras se propagan los cambios.

Si un usuario intenta hacer más preguntas una vez que se quita el acceso a un agente, verá el mensaje The agent in this conversation may not be shared with you, or may have been deleted. You can view any past conversations with the agent, but can't ask new questions..

Borra un agente de datos

Precaución: Los usuarios con los que hayas compartido este agente de datos no podrán hacer preguntas nuevas después de que lo borres. Sin embargo, se conservarán las conversaciones existentes con el agente de datos.

Si borras un agente, también lo borrarás y anularás su publicación en Gemini Enterprise.

Para borrar un agente de datos, sigue estos pasos:

1.En la página Conversaciones, haz clic en sparkAdministrar agentes en el panel izquierdo. 1. Para abrir el menú del agente elegido, haz clic en el ícono de Más opciones y, luego, en Borrar. 1. En la ventana ¿Borrar agente?, haz clic en Mover a la papelera para borrar el agente de datos.

Los agentes que se muevan a la papelera se borrarán definitivamente después de 30 días. Puedes borrar un agente de datos de forma permanente de forma manual o restablecer un agente de datos de la papelera antes de que se borre de forma permanente. Si no realizas ninguna acción, el agente se borrará automáticamente de forma permanente después de 30 días.

Cómo borrar de forma permanente un agente de datos

Para borrar de forma permanente un agente de datos, sigue estos pasos:

1. Navega a la página Conversaciones.
2. En el panel de navegación de la izquierda, expande la sección Papelera.
3. Para abrir el menú del agente elegido, selecciona su ícono y, luego, haz clic en Borrar definitivamente.
4. En la ventana ¿Seguro?, haz clic en Eliminar definitivamente.

Cómo restablecer un agente de datos desde la papelera

Para restablecer un agente de datos desde la papelera, sigue estos pasos:

1. Navega a la página Conversaciones.
2. En el panel de navegación de la izquierda, expande la sección Papelera.
3. Para abrir el menú del agente elegido, selecciona su ícono y, luego, haz clic en Restablecer.

Recursos relacionados

• Descripción general de Conversational Analytics en Looker: Es la página de destino de Conversational Analytics con una lista de funciones clave que vinculan a toda la documentación de Conversational Analytics.

• Prácticas recomendadas para configurar Conversational Analytics en Looker: Estrategias y prácticas recomendadas para ayudar a los administradores de Looker y a los desarrolladores de LookML a configurar y optimizar Conversational Analytics de forma exitosa.

• Habilita el análisis avanzado con el intérprete de código: El intérprete de código de Conversational Analytics traduce tus preguntas en lenguaje natural a código de Python y ejecuta ese código. En comparación con las consultas estándar basadas en SQL, el uso de Python por parte del intérprete de código permite análisis y visualizaciones más complejos.