Crea y administra agentes de Explorar 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:

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, consulta la tabla de permisos en la página de documentación Configura Conversational Analytics en Looker.

Los agentes de Explorar de Conversational Analytics están disponibles cuando un administrador de Looker habilitó las siguientes funciones en la página de administrador de Gemini en Looker:

  • Conversational Analytics
  • Habilita las funciones de Verificador de confianza

Crea y edita agentes de datos

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 Advanced Analytics para todas las conversaciones con tu agente, selecciona Habilitar Advanced Analytics.

  6. De manera opcional, selecciona Opciones avanzadas para expandir la sección y configurar los siguientes parámetros:

    • Mostrar el proceso de pensamiento: Activa este botón de activación para mostrar los pasos de razonamiento del agente, las consultas de Looker generadas y las tablas de datos subyacentes en las respuestas.
    • Mostrar información de depuración: Activa este botón de activación para mostrar los pasos que ejecutó el agente por respuesta y ayudar a solucionar problemas.

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

  8. 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.

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
  • Personificación: Es un rol, una experiencia, un personaje o un tono que le asignas al agente.

Si quieres obtener sugerencias y conocer las prácticas recomendadas para escribir instrucciones del agente, consulta la página de documentación Prácticas recomendadas para configurar Conversational Analytics en Looker.

Cómo definir consultas verificadas

Las búsquedas verificadas (también denominadas búsquedas de referencia en parte de la documentación de Google) son pares predefinidos de preguntas en lenguaje natural y sus correspondientes búsquedas exactas en el Explorador de Looker. Estos pares de preguntas y consultas actúan como "estándares de oro" verificados de verdad que le enseñan a tu agente a manejar solicitudes comerciales complejas sin adivinar. Las preguntas verificadas bien definidas pueden ayudar a mejorar la precisión de las respuestas de tu agente de datos de Explorar.

Límites de las búsquedas verificadas

Cuando uses búsquedas verificadas, ten en cuenta los siguientes límites:

  • Las preguntas verificadas solo están disponibles para los agentes de datos de Explorar. No están disponibles para conversaciones independientes ni para agentes de datos de paneles.
  • Debes usar una exploración que ya esté definida para el agente. Si haces referencia a un Explore que no usa el agente de datos, verás el mensaje de error This query will not be used as it references an Explore that has not been defined in this agent. For best results, make sure that verified queries are based on Explores used in this agent..
  • Las búsquedas verificadas no admiten las búsquedas de Explorar que contienen campos o tablas dinámicas personalizados.
  • Si bien no hay un límite para la cantidad de preguntas verificadas que puedes agregar, te recomendamos que no incluyas más de 30 a 50 pares de preguntas y búsquedas por agente.

Crea una consulta verificada

Para agregar una búsqueda verificada a un agente de datos nuevo o existente, sigue estos pasos:

  1. Crea un nuevo agente de datos o edita uno existente que use al menos una exploración como fuente de datos.
  2. En la página de creación o edición del agente, selecciona + Agregar pregunta verificada.
  3. En Agregar consulta verificada, ingresa la pregunta en lenguaje natural y su respuesta correspondiente:
    • Pregunta: Ingresa una pregunta en lenguaje natural que podría hacer un usuario.
    • Respuesta: Pega la URL de la exploración que captura la consulta o la visualización correctas.
  4. Para verificar la búsqueda en Explorar, haz clic en Vista previa.
    • Como alternativa: Deja el campo Respuesta en blanco y haz clic en Vista previa para crear una consulta desde cero en el Explorador y, luego, guarda la URL resultante para usarla.
  5. Haz clic en Guardar.

Cómo editar una consulta verificada

Para editar una búsqueda verificada existente, sigue estos pasos:

  1. En la conversación con el agente, selecciona Editar agente.
  2. En Consultas verificadas, busca la consulta verificada que deseas editar.
  3. Haz clic en Editar la búsqueda verificada.
  4. En el diálogo Editar consulta verificada, realiza cambios en la pregunta o la respuesta.
  5. Haz clic en Guardar.

Borra una consulta verificada

Para borrar una búsqueda verificada, sigue estos pasos:

  1. En la conversación con el agente, selecciona Editar agente.
  2. En Consultas verificadas, busca la consulta verificada que quieras borrar.
  3. Haz clic en Borrar consulta verificada.

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, las actualizaciones de la configuración no se reflejarán en la vista previa.

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 parámetros de configuración de Nombre del agente, Descripción del agente, Datos, Instrucciones y Opciones avanzadas. 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.

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..

Publica un agente de datos

Puedes publicar tu agente de datos en Gemini Enterprise, lo que hará que el contexto y las estadísticas predefinidos de tu agente estén disponibles para un público más amplio, incluidos los usuarios que no estén familiarizados con la interfaz de Looker. Gemini Enterprise funciona como un centro neurálgico en el que los usuarios pueden administrar los agentes de datos que se crearon en las Google Cloud aplicaciones, lo que les permite encontrar el mejor agente para sus necesidades de análisis.

Antes de comenzar

El procedimiento para crear un agente de datos en Looker y ponerlo a disposición de los usuarios en Gemini Enterprise incluye tareas que se realizan en la instancia de Looker, en la página de Gemini Enterprise en la consola de Google Cloud y en la instancia de Gemini Enterprise.

Los usuarios con los siguientes roles deben seguir los pasos que se describen en las secciones asociadas:

  1. Editores de agentes de datos (capacidad de Looker): Publica el agente en Looker.
  2. Administrador de Discovery Engine (rol de IAM): Otorga acceso al agente en la consola de Google Cloud .
  3. Usuario de Gemini Enterprise (rol de IAM); usuario del agente de datos (capacidad de Looker): Chatea con el agente en la instancia de Gemini Enterprise.

Antes de publicar un agente, se deben cumplir los siguientes requisitos:

  • Un administrador de Looker debe habilitar el parámetro de configuración Publicar en Gemini Enterprise en la página Gemini en Looker del panel Administrador.
  • Un administrador de Looker debe otorgarte un rol que contenga el permiso publish_agent_externally. También debes poder editar un agente de datos.
  • A la cuenta de servicio de Looker en el proyecto Google Cloud que aloja el motor de Gemini Enterprise se le debe otorgar el rol de Identity and Access Management de Administrador de Discovery Engine. Al otorgar este rol, se asigna una licencia de Gemini Enterprise a la cuenta cuando se publique el primer agente de datos. Si no hay licencias de Gemini Enterprise disponibles para asignar a la cuenta de servicio de Looker, la página del motor de Gemini Enterprise en la consola de Google Cloud mostrará el error "Failed to allocate quota for agent creation". Luego, un usuario con el rol de Identity and Access Management de Administrador de Discovery Engine debe aprovisionar una nueva licencia de Gemini Enterprise o reasignar una licencia existente para la cuenta de servicio de Looker.

Publica un agente de datos en Gemini Enterprise

Para completar los pasos que se describen en esta sección, debes tener un rol de Looker que contenga el permiso publish_agent_externally y los permisos y el acceso al contenido adecuados para editar agentes de datos.

Para publicar un agente, sigue estos pasos:

  1. Edita el agente.
  2. Selecciona Configuración de publicación para abrir la ventana Configuración de publicación del agente.
  3. En la ventana Agent publish settings, habilita el parámetro de configuración Gemini Enterprise y selecciona Update. Si habilitas este parámetro de configuración, se publicará el agente en la instancia de Gemini Enterprise que se muestra en la página Gemini en Looker del panel Administrador.
  4. Una vez que publiques tu agente, puedes seleccionar Compartir para otorgar acceso a otros usuarios de Looker a tu agente de datos o seleccionar Iniciar conversación para abrir una conversación nueva con el agente de datos.

Otorga a los usuarios acceso al agente en Gemini Enterprise

Para completar los pasos que se describen en esta sección, debes tener el rol de Identity and Access Management de Administrador de Discovery Engine para el proyecto Google Cloud que contiene el motor de Gemini Enterprise.

Para poder chatear con un agente en Gemini Enterprise, el usuario debe tener acceso a la instancia de Gemini Enterprise y al agente individual.

Para otorgar acceso a un usuario a la instancia de Gemini Enterprise, un administrador de Discovery Engine debe asignarle el rol de IAM Usuario de Gemini Enterprise para el proyecto Google Cloud que contiene el motor de Gemini Enterprise.

Para otorgar acceso a un usuario a un agente individual, el administrador de Discovery Engine debe completar los siguientes pasos en la consola de Google Cloud :

  1. Navega al proyecto Google Cloud que contiene el motor de Gemini Enterprise.
  2. Abre la página del producto de Gemini Enterprise.
  3. Selecciona la página Apps en la navegación principal y, luego, selecciona el nombre de la instancia de Gemini Enterprise.
  4. En el menú de navegación principal, selecciona Agentes.
  5. Selecciona el agente al que quieres otorgarle acceso.
  6. Selecciona la pestaña Permisos del usuario.
  7. Selecciona Agregar usuario.
  8. En la ventana Add user permissions roles to agent, agrega cada usuario y asígnale el rol Agent User.

Chatea con el agente en Gemini Enterprise

Para completar los pasos que se describen en esta sección, debes tener el rol de Identity and Access Management Usuario de Gemini Enterprise para el proyecto Google Cloud que contiene el motor de Gemini Enterprise. También debes tener los permisos y el acceso al contenido adecuados para chatear con el agente en la instancia de Looker.

Para chatear con un agente de datos en una instancia de Gemini Enterprise, sigue estos pasos:

  1. Abre tu instancia de Gemini Enterprise.
  2. Selecciona Agentes en el menú de navegación principal.
  3. En la página Agentes, selecciona el agente con el que quieres chatear. Cuando selecciones un agente, se abrirá una ventana de conversación en la que podrás hacer preguntas sobre tus datos.

La primera vez que chatees con un agente, deberás autorizar su acceso a tu identidad de Looker.

Borra un agente de datos

Para borrar un agente de datos, 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 Borrar.
  3. 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.