Crear y gestionar agentes de datos

Los agentes de datos te permiten seleccionar la experiencia de Análisis conversacional para tus datos. Con los agentes, puedes proporcionar a Conversational Analytics contexto e instrucciones para que pueda responder a preguntas de forma más eficaz en casos prácticos específicos. Los agentes permiten a los analistas asignar términos empresariales a campos específicos, especificar los mejores campos para filtrar y definir cálculos personalizados.

En esta página se explica cómo hacer lo siguiente:

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

Antes de empezar

Un agente de datos es otro tipo de contenido de Looker, como un panel de control, un Look o una carpeta.

El uso de un agente de datos se gestiona mediante una combinación de acceso al contenido, acceso a los datos y acceso a las funciones. Para llevar a cabo 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 propio agente.

Tarea Permisos de Looker necesarios Nivel de acceso necesario del agente de datos
Crear, editar, compartir y eliminar agentes Añadido el 25/18 admin_agents No se debe conceder acceso al contenido
Crear, editar, compartir* y eliminar agentes

* Esta función está disponible para los usuarios cuyas instancias de Looker tengan la versión 25.18.10 o posterior.		 Añadido el 25/18 save_agents Gestionar acceso; Editar (este acceso se concede automáticamente si el usuario crea el agente; de lo contrario, el creador del agente debe conceder el acceso Gestionar acceso; Editar compartiendo el agente)
Chatear con un agente de datos desde la pestaña Agentes de Analíticas conversacional access_data (en cada modelo que contenga las Exploraciones que use el agente de datos)

Añadido el 25/18 chat_with_agent		 Acceso de lectura
Chatear con una exploración de Looker desde la pestaña Exploraciones de Análisis conversacional access_data (en cada modelo que contenga las Exploraciones que use el agente de datos)

Añadido 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:

  • Gestor de agentes de analíticas conversacionales: con este rol, un usuario puede crear, editar, compartir, eliminar y chatear con agentes para los que tenga acceso de gestión y edición, así como chatear con Exploraciones.
  • Usuario de analíticas conversacionales: con este rol, un usuario puede chatear con un agente al que tenga acceso de lectura.
  • Administrador: de forma predeterminada, este rol (administrador de Looker) tiene todos los permisos y acceso al contenido de la instancia.

Un administrador de Looker puede conceder estos roles y permisos en la página Roles de la sección Administrar 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 gestionar el acceso de los usuarios al agente compartiéndolo.

Crear y editar agentes de datos

Para crear un agente de datos, sigue estos pasos:

  1. Vaya a la página Conversaciones.
  2. En la pestaña Agentes, selecciona + Nuevo agente. También puedes seleccionar sparkGestionar agentes en el panel de la izquierda y, a continuación, + Nuevo agente.

  3. En la página Nuevo agente, proporcione la siguiente información sobre su agente de datos.

    • Nombre del agente: introduce 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 utiliza. 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:
      1. En el campo Datos, haz clic en + Seleccionar Exploraciones.
      2. En la ventana Buscar Exploraciones, haga clic en las Exploraciones que quiera incluir en el agente de datos. Estos Exploraciones aparecerán en el panel Exploraciones seleccionadas de la ventana.
      3. Para añadir la Exploración seleccionada al agente de datos, haz clic en Guardar.

  4. Instrucciones: proporciona contexto para ayudar a Análisis conversacional a entender cómo interactuar con tus datos y ofrecer respuestas precisas y relevantes. Para ver ejemplos de los tipos de contexto que puedes proporcionar, consulta el artículo Escribir instrucciones para agentes.

  5. Si quieres habilitar Intérprete de código en todas las conversaciones con tu agente, selecciona Habilitar analíticas avanzadas.

  6. También puedes probar tu agente para perfeccionar las instrucciones y los ajustes.

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

Una vez que hayas guardado el agente de datos, podrás compartirlo con otros usuarios y iniciar una conversación con él.

Escribir 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

Aquí tienes algunas instrucciones de ejemplo para ajustar y probar con tu agente:

  • A menos que se indique lo contrario, filtre siempre los datos por Order Items Created Year = 2024
  • Consideramos que los clientes "fieles" son aquellos que tienen Order Items Count > 5
  • Si alguien dice algo sobre "Ubicación", significa que se refiere a User City
  • Si la pregunta menciona a "personas mayores", se refiere a usuarios con User Age > 65
  • Si la pregunta es sobre los ingresos, usa Ventas totales
  • Cuando alguien diga "por producto", a menos que especifique "nombre", agrupa por product category
  • Los pedidos "Completados" son aquellos cuyo estado de los artículos es "Completado".
  • Siempre que haya una cronología o un periodo, usa Order Item Created Date como campo para agrupar los datos.

Probar un agente

Cuando creas o editas un agente, la página de detalles del agente incluye el panel Vista previa del agente. Puedes probar los ajustes 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, los cambios que hagas en los ajustes no se reflejarán en la vista previa.

Editar un agente de datos

Para editar un agente de datos, sigue estos pasos:

  1. En la página Conversaciones, selecciona sparkGestionar agentes.
  2. En la página Gestionar agentes, selecciona el agente de datos que quieras editar.
  3. Actualiza los detalles del agente según sea necesario. Puedes modificar los detalles que especificaste al crear el agente, incluidos los campos Nombre del agente, Descripción del agente, Datos e Instrucciones. También puedes habilitar la función Intérprete de código en tu agente.
  4. Para guardar los cambios, haz clic en Actualizar.

Compartir agentes de datos

La función de compartir permite que otros usuarios chateen con tu agente y sus Exploraciones. Puedes compartir un agente de datos con otros usuarios dándoles acceso al contenido del agente. Solo los usuarios que tengan los permisos y el acceso al contenido adecuados pueden compartir un agente. Una vez que se haya creado 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 sparkGestionar agentes en el panel de la izquierda.
  2. Abre el menú del agente elegido haciendo clic en el icono Más opciones y, a continuación, en Compartir.
  3. Una vez que hayas añadido 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 Añadir para incluirlos en la lista compartida.
  4. Si quieres que los nuevos usuarios o grupos reciban una notificación por correo, marca la casilla Enviar un correo a las personas que acabas de añadir.
  5. Cuando hayas hecho todos los cambios, haz clic en Guardar.

También puedes compartir un agente que acabes 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 que se han indicado anteriormente.

Revocar 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 sparkGestionar agentes en el panel de la izquierda.
  2. Abre el menú del agente elegido haciendo clic en el icono Más opciones y, a continuación, en Compartir.
  3. Haz clic en la X que aparece junto al usuario o los grupos a los que quieras quitar el acceso.
  4. Cuando hayas hecho todos los cambios, haz clic en Guardar.

Si los usuarios eliminados 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 le ha retirado 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..

Eliminar un agente de datos

Para eliminar un agente de datos, sigue estos pasos:

1.En la página Conversaciones, haz clic en sparkGestionar agentes en el panel de la izquierda. 1. Abre el menú del agente que quieras eliminar haciendo clic en el icono Más opciones y, a continuación, en Eliminar. 1. En la ventana ¿Eliminar agente?, haz clic en Mover a la papelera para eliminar el agente de datos.

Los agentes que se muevan a la papelera se eliminarán definitivamente al cabo de 30 días. Puedes eliminar permanentemente un agente de datos manualmente o restaurar un agente de datos de la papelera antes de que se elimine permanentemente. Si no haces nada, el agente se eliminará automáticamente de forma permanente al cabo de 30 días.

Eliminar un agente de datos de forma permanente

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

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

Restaurar un agente de datos de la papelera

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

  1. Ve a la página Conversaciones.
  2. En el panel de navegación de la izquierda, despliega la sección Papelera.
  3. Para abrir el menú del agente elegido, selecciona su icono y, a continuación, haz clic en Restaurar.