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 contexto e instrucciones a las estadísticas conversacionales para que respondan preguntas de manera más eficaz en casos de uso específicos. Los agentes permiten que los analistas asignen términos empresariales a campos específicos, indiquen 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, debes tener asignado un rol de Looker que tenga los permisos necesarios para los modelos que subyacen en la exploración individual o que consultará el agente de datos. En algunos casos, también necesitarás acceso al agente.

Para obtener más información sobre los permisos y el acceso necesarios para administrar y usar los 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 Administrador de Gemini en Looker:

  • Conversational Analytics:
    • Conversational Analytics (página Conversaciones): Activa este parámetro de configuración para habilitar el acceso a la página Conversaciones para los agentes de datos con exploraciones y chats directos con una exploración.
  • Opciones adicionales:
    • Estadísticas avanzadas: Para permitir que tu agente use las estadísticas avanzadas, que traducen tus preguntas en lenguaje natural a código de Python y ejecutan ese código para proporcionar análisis y visualizaciones avanzados, activa el parámetro de configuración Estadísticas avanzadas. Este parámetro de configuración es opcional
  • Habilitar funciones del verificador de confianza

Crea y edita agentes de datos

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

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

  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 exploraciones de Looker existentes:
      1. En el campo Datos, haz clic en + Seleccionar exploraciones.
      2. En la ventana Buscar exploraciones, 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 el Explorar seleccionado 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 proporcionar respuestas precisas y pertinentes. Para ver ejemplos de los tipos de contexto que puedes proporcionar, consulta Escribe instrucciones para el agente.

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

    • Habilita Advanced Analytics: Activa este parámetro de configuración para habilitar Advanced Analytics en todas las conversaciones con tu agente.
    • Mostrar pensamiento: Activa este botón de activación para permitir que el agente muestre sus pasos de razonamiento, las consultas de Looker generadas y las tablas de datos subyacentes en todas las respuestas de cada conversación.
    • Mostrar información de depuración: Activa este botón de activación para permitir que el agente muestre los pasos que ejecutó para todas las respuestas en cada conversación.

  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 para el agente

Cuando creas un agente de datos, puedes agregar instrucciones de formato libre que definan su comportamiento principal y le proporcionen un contexto básico que deba tener en cuenta 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: Son los campos más importantes para el análisis.
  • Campos excluidos: Son los 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 o una experiencia, un carácter o un tono que le asignas al agente.

Para obtener sugerencias y prácticas recomendadas para escribir instrucciones para el agente, consulta la página de documentación Prácticas recomendadas para configurar las estadísticas conversacionales en Looker.

Cómo definir consultas verificadas

Las consultas verificadas, también conocidas como consultas de referencia en cierta documentación de Google, son pares predefinidos de preguntas en lenguaje natural y sus correspondientes consultas exactas de Explorar de Looker. Estos pares de preguntas y consultas actúan como "estándares de oro" verificados de la verdad que le enseñan a tu agente a manejar solicitudes empresariales 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 consultas verificadas

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

  • Las consultas verificadas solo están disponibles para los agentes de datos de Explorar. No están disponibles para los chats directos con una exploración ni para los 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 consultas verificadas no admiten consultas de Explorar que contengan campos personalizados o tablas dinámicas.
  • 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 consulta verificada a un agente de datos nuevo o existente, sigue estos pasos:

  1. Crea un agente de datos nuevo 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 consulta verificada.
  3. En Agregar consulta verificada, ingresa la pregunta en lenguaje natural y su respuesta correspondiente:
    • Pregunta: Ingresa una pregunta en lenguaje natural que un usuario podría hacer.
    • Respuesta: Pega la URL de la exploración que captura la consulta o visualización correcta.
  4. Para verificar la consulta de 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 compilador de Explorar 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 quieras editar.
  3. Haz clic en Editar consulta verificada.
  4. En el cuadro de 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 Preguntas verificadas, busca la pregunta verificada que quieras borrar.
  3. Haz clic en Borrar consulta verificada.

Prueba un agente

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

Debes hacer clic en Actualizar para que un cambio se refleje 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.

Edita 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 sobre el 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).

Comparte agentes de datos

Compartir permite que otros usuarios chateen con tu agente y sus exploraciones. Para compartir un agente de datos con otros usuarios, otórgales 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, es posible que tarde 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. Abre el menú del agente elegido haciendo clic en su ícono de Más opciones y, luego, en Compartir.
  3. Una vez que hayas agregado a una persona o a 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 incluirlos en la lista compartida.
  4. Si quieres que los usuarios o grupos nuevos reciban una notificación por correo electrónico, 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. Para ello, haz clic en Compartir en la página de configuración del agente y sigue 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 Conversaciones, haz clic en sparkAdministrar agentes en el panel izquierdo.
  2. Abre el menú del agente elegido haciendo clic en su ícono de Más opciones y, luego, haz clic en Compartir.
  3. Haz clic en la X junto al usuario o los 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 quitados 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 tal vez 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 aplicaciones de Google Cloud , lo que les ayuda a encontrar el mejor agente para sus necesidades analíticas.

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 empresarial de Gemini (rol de IAM); usuario de agente de datos (capacidad de Looker): Chatear 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 los parámetros de configuración Habilitar funciones del verificador de confianza y Publicar en Gemini Enterprise, así como el parámetro de configuración Conversational Analytics (página de conversaciones), 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 de 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. Cuando se otorga este rol, se asigna una licencia de Gemini Enterprise a la cuenta cuando se publica el primer agente de datos. Si no hay licencias de Gemini Enterprise disponibles para asignar a la cuenta de servicio de Looker, en la página del motor de Gemini Enterprise de la Google Cloud consola se mostrará el error "No se pudo asignar la cuota de asignación para la creación del agente". 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 de Google Cloud que contiene el motor de Gemini Enterprise.

Para poder chatear con un agente en Gemini Enterprise, un 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 de usuario de Gemini Enterprise para el proyecto de 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 Gemini Enterprise.
  3. Selecciona la página Apps en el panel de navegación principal y, luego, 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 otorgar 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 de usuario empresarial de Gemini Enterprise para el proyecto de 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 seleccionas un agente, se abre una ventana de conversación en la que puedes hacer preguntas sobre tus datos.

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

Vuelve a publicar un agente de datos en Gemini Enterprise

Cuando Looker actualiza las funciones o capacidades del agente de datos, debes actualizar o volver a publicar tu agente para que esos cambios se apliquen en Gemini Enterprise.

Looker 26.12 introdujo la compatibilidad con gráficos en las respuestas de los agentes. Si tu agente se creó antes de Looker 26.12, debes actualizarlo o volver a publicarlo para que use gráficos en sus respuestas.

Para actualizar tu agente, sigue estos pasos:

  1. Edita el agente de datos.
  2. Modificar los metadatos de tu agente
  3. Seleccione Update.

Para volver a publicar tu agente de datos, sigue estos pasos:

  1. Edita el agente de datos.
  2. Selecciona Configuración de publicación para abrir la ventana Configuración de publicación del agente.
  3. Desactiva el botón de activación de Gemini Enterprise y selecciona Actualizar.
  4. Espera a que se quite el agente de Gemini Enterprise.
  5. En Looker, edita el agente de datos para volver a abrir la ventana Configuración de publicación del agente.
  6. Selecciona Configuración de publicación, activa el botón de activación de Gemini Enterprise y selecciona Actualizar.

Borra un agente de datos

Para borrar un agente de datos, sigue estos pasos:

  1. En la página Conversaciones, haz clic en sparkAdministrar agentes en el panel izquierdo.
  2. Para abrir el menú del agente elegido, haz clic en su ícono de Más opciones y, luego, en Borrar.
  3. En la ventana ¿Quieres borrar el 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 de forma permanente 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á de forma permanente después de 30 días automáticamente.

Borra un agente de datos de forma permanente

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

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

Restablece un agente de datos de la papelera

Para restablecer un agente de datos de 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 de y, luego, haz clic en Restablecer.