Analiza datos con conversaciones

En este documento, se describe cómo crear, editar y borrar conversaciones en BigQuery. Las conversaciones son chats persistentes con un agente de datos o fuentes de datos, como tablas, vistas o gráficos, que seleccionas.

Puedes hacerles a los agentes de datos preguntas de varias partes que usen términos comunes, por ejemplo, "ventas" o "más populares", sin especificar nombres de campos de tabla ni definir condiciones para filtrar los datos. Un agente puede determinar qué fuentes de datos consultar y aprovechar las optimizaciones, como las particiones de tablas, cuando crea una respuesta. La respuesta del chat contiene la respuesta a tu pregunta como texto y código, e incluye el razonamiento detrás de los resultados. La respuesta también puede incluir imágenes y gráficos cuando corresponda.

Puedes crear una conversación con un agente de datos o una conversación directa con una o más fuentes de datos. Cuando creas una conversación directa, la API de Conversational Analytics interpreta tu pregunta sin el contexto y las instrucciones de procesamiento que ofrece un agente de datos.

Antes de comenzar

  1. Verifica que la facturación esté habilitada para tu Google Cloud proyecto.

  2. Habilita las APIs de BigQuery, Gemini Data Analytics y Gemini for Google Cloud .

    Roles necesarios para habilitar las APIs

    Para habilitar las APIs, necesitas el rol de IAM de administrador de Service Usage (roles/serviceusage.serviceUsageAdmin), que contiene el permiso serviceusage.services.enable. Obtén más información para otorgar roles.

    Habilitar las API

Roles obligatorios

Para crear conversaciones, debes tener uno de los siguientes roles de IAM de la API de Conversational Analytics:

  • Para ver y crear conversaciones con cualquier agente de datos que se haya compartido contigo, debes tener el rol de usuario de agente de datos de Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser) y el rol de usuario de Gemini for Google Cloud (roles/cloudaicompanion.user) a nivel del proyecto.
  • Para crear una conversación directa, debes tener el rol de usuario de chat sin estado de Gemini Data Analytics (roles/geminidataanalytics.dataAgentStatelessUser).

Además, en las siguientes situaciones, debes tener los siguientes roles:

Si no tienes los roles adecuados en las tablas de datos de origen que usa el agente de datos, el sistema muestra el siguiente error cuando chateas con el agente de datos:

Schema_Resolution: Access Denied

Prácticas recomendadas

Conversational Analytics ejecuta automáticamente consultas en tu nombre para responder tus preguntas. Ten en cuenta los siguientes factores que podrían aumentar el costo de la consulta:

  • Tamaños de tabla grandes
  • Uso de uniones de datos en consultas
  • Llamadas frecuentes a funciones de IA dentro de las consultas

Crear conversaciones

Puedes crear una conversación con un agente de datos personalizado existente. De forma alternativa, para preguntas rápidas y únicas, puedes crear una conversación directamente con una sola fuente de datos.

Crea una conversación con un agente de datos

Para crear una conversación con un agente de datos, primero debes crear un agente de datos y publicarlo. También puedes iniciar una conversación con los agentes que otros comparten contigo.

Para crear una conversación con un agente de datos existente en la Google Cloud consola, sigue estos pasos:

  1. Ve a la página Agentes de BigQuery.

    Ir a Agentes

  2. Selecciona la pestaña Catálogo de agentes.

  3. En la sección Mis agentes o Compartido por otros en tu organización, haz clic en la tarjeta del agente con el que deseas chatear.

  4. Haz clic en Iniciar una conversación. Se abrirá un nuevo panel de chat.

Crea una conversación directa con una fuente de datos

Para crear una conversación con una fuente de datos en la Google Cloud consola de, selecciona una de las siguientes opciones:

Página Agentes

Para crear una conversación directa con una fuente de datos desde la página Agentes, sigue estos pasos:

  1. Ve a la página Agentes de BigQuery.

    Ir a Agentes

  2. En la pestaña Conversaciones, en el panel Chatea con tus datos, haz clic en Fuentes de datos.

  3. Selecciona una o más fuentes de datos y haz clic en Crear conversación.

Editor de BigQuery

Para crear una conversación directa con una fuente de datos desde la página BigQuery, sigue estos pasos:

  1. En la Google Cloud consola de, ve a la página BigQuery.

    Ir a BigQuery

  2. En el panel de la izquierda, haz clic en Explorador.

  3. En el panel Explorar, expande tu proyecto, haz clic en Conjuntos de datos y luego, selecciona un conjunto de datos. Se abrirá la descripción general del conjunto de datos.

  4. Selecciona una fuente de datos, como una tabla, una vista o un gráfico. Se abrirá el recurso.

  5. En la barra de menú, haz clic en Crear conversación.

  6. Opcional: Para crear una conversación nueva con los resultados de la consulta cuando ejecutas una consulta, haz clic en Crear conversación en el panel Resultados de la consulta. La fuente de datos es la tabla temporal de resultados almacenados en caché que suele persistir durante 24 horas. Una vez que vencen los resultados almacenados en caché, no puedes hacer preguntas sobre los datos.

Crea un agente de datos a partir de una conversación

  1. Desde el panel Datos de una conversación, en la sección Acciones rápidas , haz clic en Crear agente.
  2. Sigue los pasos para crear un agente.

Mantén una conversación

En el campo Haz una pregunta, ingresa una pregunta para el agente de datos. También puedes hacer clic en una de las preguntas sugeridas por Gemini para comenzar.

La API de Conversational Analytics procesa tu pregunta y muestra los resultados. Para ver cada paso que siguió el agente de datos para proporcionar la respuesta a tu pregunta, haz clic en Mostrar razonamiento.

Cómo abrir los resultados de **Mostrar razonamiento**

Para ver información sobre cómo se calcularon los resultados, haz clic en ¿Cómo se calculó esto?

La sección Resumen incluye la consulta generada seguida del resultado de la consulta. De manera opcional, puedes abrir la consulta en el editor de consultas.

Son los detalles del cálculo de la API, incluida la consulta generada y el resultado de la consulta.

Cuando es apropiado para los datos, la respuesta proporciona imágenes, gráficos, tablas y otras visualizaciones.

Administración de conversaciones

Puedes abrir, cambiar el nombre o borrar una conversación en la página Agentes y administrar conversaciones en el Explorador de BigQuery Studio.

Abre una conversación existente

  1. En la Google Cloud consola de, ve a la página Agentes de BigQuery.

    Ir a Agentes

  2. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que deseas abrir.

Cambia el nombre de una conversación

  1. En la Google Cloud consola de, ve a la página Agentes de BigQuery.

    Ir a Agentes

  2. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación a la que deseas cambiar el nombre.

  3. Haz clic en Ver acciones > Cambiar nombre.

  4. En el diálogo Cambiar el nombre de la conversación, ingresa un nombre nuevo para la conversación en el campo Nombre de la conversación.

  5. Haz clic en Cambiar nombre.

Borrar una conversación

Los resultados de las preguntas en una conversación persisten incluso si se borran las fuentes de datos subyacentes. Para borrar una conversación y todos los resultados que contiene, sigue estos pasos:

  1. En la Google Cloud consola de, ve a la página Agentes de BigQuery.

    Ir a Agentes

  2. En la pestaña Conversaciones, en la lista de conversaciones, haz clic en la conversación que deseas borrar.

  3. Haz clic en Ver acciones > Borrar.

  4. En el diálogo ¿Borrar conversación?, haz clic en Borrar.

Si no actualizas una conversación durante 180 días, BigQuery la borrará automáticamente.

Administra conversaciones con el Explorador de BigQuery Studio

Administra conversaciones con el Explorador de BigQuery Studio. Esta lista de conversaciones proporciona un lugar central para buscar, abrir o crear conversaciones. También puedes copiar el ID de la conversación o actualizar la lista de conversaciones.

Para administrar tus conversaciones, sigue estos pasos:

  1. Ve a la página Explorador de BigQuery Studio.

    Ir al Explorador

  2. En el panel Explorador, expande el nombre de un proyecto.

  3. Haz clic en Conversaciones.

    1. Para filtrar la lista de conversaciones, ingresa el nombre o el valor de una propiedad en el campo de filtro.
    2. Para abrir una conversación, haz clic en Ver acciones > Abrir.
    3. Para copiar un ID de conversación, haz clic en Ver acciones > Copiar ID.
    4. Para crear una conversación, en la barra de menú, haz clic en Crear conversación.
    5. Para actualizar la lista, en la barra de menú, haz clic en Actualizar.

Ubicaciones

Conversational Analytics opera de forma global, por lo que no puedes elegir qué región usar. Es posible que tus conversaciones no se almacenen en la misma región que sus fuentes de datos.

¿Qué sigue?