Crea y administra agentes de datos

Los agentes de datos te permiten seleccionar la experiencia de Conversational Analytics para tus datos. 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
• Compartir agentes de datos
• Borra agentes de datos

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

Antes de comenzar

Piensa en un agente de datos como otro tipo de contenido de Looker, como un panel, un Look o una carpeta.

Nota: Para compartir agentes de datos y usar los permisos que se describen en esta sección, actualiza tu instancia de Looker a la versión 25.18.9 o posterior.

El uso de un agente de datos se administra a través de una combinación de acceso al contenido, acceso a los datos y acceso a las funciones. Para realizar las tareas que se describen en la siguiente tabla, debes tener asignado un rol de Looker que tenga los permisos necesarios para los modelos que consultará tu agente de datos y, en algunos casos, acceso al agente en sí.

Tarea	Permisos de Looker necesarios	Nivel de acceso requerido del agente de datos
Crear, editar, compartir y borrar agentes	Se agregó el 25/18 admin_agents	No se debe otorgar acceso al contenido
Crear, editar, compartir^* y borrar agentes ^* Esta capacidad está disponible para los usuarios cuyas instancias de Looker ejecutan Looker 25.18.10 o versiones posteriores.	Se agregó el 25/18 save_agents	Administrar acceso; Editar (este acceso se otorga automáticamente si el usuario crea el agente; de lo contrario, el creador del agente debe otorgar el acceso de Administrar acceso; Editar compartiendo el agente)
Chatea con un agente de datos desde la pestaña Agentes en Conversational Analytics	access_data (en cada modelo que contiene las Exploraciones que usa el agente de datos) Se agregó el 25/18 chat_with_agent	Acceso de visualización
Chatea con un Explorar de Looker desde la pestaña Explorar en Conversational Analytics	access_data (en cada modelo que contiene las Exploraciones que usa el agente de datos) Se agregó el 25/18 chat_with_explore

Looker también tiene los siguientes roles predeterminados que contienen subconjuntos de estos permisos para todos los modelos de la instancia:

• Administrador de agentes de Analytics conversacional: Con este rol, un usuario puede crear, editar, compartir, borrar y chatear con los agentes para los que tiene acceso de Administrar acceso; Editar y chatear con Explorar.
• Usuario de Conversational Analytics: Con este rol, un usuario puede chatear con un agente al que tiene acceso de Visualización.
• Administrador: De forma predeterminada, este rol (administrador de Looker) tiene todos los permisos y acceso al contenido en toda la instancia.

Un administrador de Looker puede otorgar estos roles y permisos en la página Roles de la sección Administrador de la instancia de Looker. Para obtener más información sobre los roles de Looker, consulta la página de documentación Configuración de administrador: Roles.

El creador del agente de datos puede administrar el acceso de los usuarios individuales al agente compartiéndolo.

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, + 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 qué 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 de Looker existentes:
     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 en todas las conversaciones con tu agente, selecciona Habilitar Advanced Analytics.

6. De manera opcional, puedes probar tu agente para definir mejor sus instrucciones y parámetros de 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 proporcionar los siguientes tipos de contexto 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
• Sinónimos: Términos alternativos para los campos clave

Nota: Si tienes un rol de Looker que te permite editar LookML, puedes definir sinónimos para los campos de tu Explorar con el parámetro de LookML synonyms.

Estas son algunas instrucciones de ejemplo para ajustar y probar con tu agente:

• A menos que se indique lo contrario, siempre filtra los datos en Order Items Created Year = 2024.
• Consideramos que los clientes “leales” son aquellos que tienen Order Items Count > 5
• Si alguien dice algo sobre la "ubicación", significa la ciudad del usuario.
• Si la pregunta menciona a "personas mayores", se refiere a los usuarios con User Age > 65.
• Si una pregunta es sobre los ingresos, usa las ventas totales.
• Cuando alguien dice "por producto", a menos que diga específicamente "nombre", agrupa por product category.
• Los pedidos “completados” significan que el estado de los artículos del pedido es “Completado”.
• Siempre que haya una pregunta sobre un período o con el tiempo, usa siempre Order Item Created Date como el campo para agrupar los datos.

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 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 Exploraciones. Puedes compartir un agente de datos con otros usuarios otorgándoles acceso al contenido del agente. Solo un usuario con los permisos adecuados y acceso al contenido 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 le otorga también 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 otorgar 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 su í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. 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. Para abrir el menú del agente elegido, haz clic en su í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 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..

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 con el 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. 1. Para abrir el menú del agente elegido, haz clic en su í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 de forma definitiva 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 permanentemente 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 Borrar 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 vínculos a todas las funciones clave de la documentación de Conversational Analytics.

• Crea y administra agentes de datos: Con los agentes de datos, puedes personalizar el agente de consultas de datos potenciado por IA proporcionando contexto e instrucciones específicos para tus datos, lo que ayuda a Conversational Analytics a generar respuestas más precisas y pertinentes para el contexto.

• 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, implementar 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.