Analiza datos con conversaciones

Usa este documento para aprender a crear, editar y borrar conversaciones en BigQuery. Las conversaciones son chats persistentes del usuario con un agente de datos o una fuente de datos. Los usuarios pueden hacer preguntas de varias partes a los agentes de datos que usan términos comunes, como "ventas" o "más populares", sin tener que especificar nombres de campos de tablas ni definir condiciones para filtrar los datos. La respuesta del chat que se le devuelve al usuario proporciona la respuesta a su pregunta como texto y código, y también genera gráficos cuando corresponde. La respuesta también incluye el razonamiento detrás de los resultados.

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

Antes de comenzar

  1. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

    Roles required to select or create a project

    • Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
    • Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

    Go to project selector

  2. Verify that billing is enabled for your Google Cloud project.

  3. Enable the BigQuery, Gemini Data Analytics, and Gemini for Google Cloud API APIs.

    Roles required to enable APIs

    To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

    Enable the APIs

Roles obligatorios

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

  • Ver y crear conversaciones con cualquier agente de datos que se haya compartido contigo: Usuario del agente de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentUser) a nivel del proyecto
  • Crear una conversación directa: Usuario de chat sin estado de análisis de datos de Gemini (roles/geminidataanalytics.dataAgentStatelessUser)

Además, cualquier usuario que cree una conversación debe tener los siguientes roles:

Si un usuario de conversación no tiene los roles adecuados en las tablas de datos fuente que usa el agente de datos, se muestra el siguiente error cuando el usuario chatea con el agente de datos:

Schema_Resolution: Access Denied

Crea una conversación con un agente de datos

Sigue estos pasos para crear una conversación con un agente de datos. Debes crear un agente de datos antes de iniciar una conversación con uno.

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

    Ir a la página Agentes

  2. En la pestaña Conversaciones, en el panel Chatea con tus datos, haz clic en la tarjeta del agente de datos con el que deseas chatear. Se abrirá la página de conversación.

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

    El agente de datos responde y explica la acción que realizará para abordar tu pregunta y, luego, muestra los resultados.

    Para ver los pasos que siguió el agente de datos, haz clic en Ver pasos.

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

    Selecciona el ícono junto a la respuesta inicial del agente de datos para ver los detalles de los cálculos del agente.

    En la pestaña Text, se describe el código generado, y en la pestaña Code, se proporciona el código generado:

    Los detalles del cálculo del agente incluyen información sobre el código que generó.

    Si es adecuado para los datos, el agente de datos también proporciona gráficos, tablas y otras visualizaciones.

Cómo crear una conversación directa con una fuente de datos

Sigue estos pasos para crear una conversación directa con una fuente de datos:

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

    Ir a la página 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 tablas y haz clic en Crear conversación.

  4. En el campo Haz una pregunta, escribe una pregunta que quieras que responda 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 los pasos que siguió la API de Conversational Analytics, haz clic en Ver pasos.

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

    Selecciona el ícono junto a la respuesta inicial del agente de datos para ver los detalles de los cálculos del agente.

    En la pestaña Text, se describe el código generado, y en la pestaña Code, se proporciona el código generado:

    Los detalles del cálculo del agente incluyen información sobre el código que generó.

Cómo abrir una conversación existente

Sigue estos pasos para abrir una conversación:

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

    Ir a la página Agentes

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

Cómo cambiar el nombre de una conversación

Sigue estos pasos para cambiar el nombre de una conversación:

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

    Ir a la página Agentes

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

  3. Haz clic en Ver acciones > Cambiar nombre.

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

  5. Haga clic en Cambiar nombre.

Borrar una conversación

Sigue estos pasos para borrar una conversación:

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

    Ir a la página Agentes

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

  3. Haz clic en Ver acciones > Borrar.

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

Ubicaciones

El análisis conversacional funciona a nivel mundial, por lo que no puedes elegir qué región usar.

¿Qué sigue?