Analisar dados com conversas

Acesso antecipado

Este recurso está sujeito aos "Termos da Oferta Pré-GA" na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis no estado em que se encontram e podem ter assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

Observação: para se inscrever no acesso antecipado à análise de conversas, preencha o formulário de solicitação. Para solicitar suporte ou enviar feedback sobre esse recurso, envie um e-mail para [e-mail].

Use este documento para aprender a criar, editar e excluir conversas no BigQuery. As conversas são chats persistentes do usuário com um agente de dados ou uma fonte de dados. Os usuários podem fazer perguntas de várias partes aos agentes de dados usando termos comuns, como "vendas" ou "mais popular", sem precisar especificar nomes de campos de tabela ou definir condições para filtrar os dados. A resposta do chat enviada ao usuário fornece a resposta à pergunta do usuário como texto e código, além de gerar gráficos quando apropriado. A resposta também inclui o raciocínio por trás dos resultados.

Você pode criar uma conversa com um agente de dados ou uma conversa direta com uma ou mais tabelas. Quando você cria uma conversa direta, a API Conversational Analytics interpreta sua pergunta sem o contexto e as instruções de processamento oferecidas por um agente de dados.

Antes de começar

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.
   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   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

Funções exigidas

Para criar conversas, você precisa ter um dos seguintes papéis do IAM da API Conversational Analytics:

• Ver e criar conversas com qualquer agente de dados compartilhado com você: usuário do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser) no nível do projeto.
• Criar uma conversa direta: usuário de chat sem estado do Gemini Data Analytics (roles/geminidataanalytics.dataAgentStatelessUser)

Além disso, qualquer usuário que criar uma conversa precisa ter os seguintes papéis:

• Leitor de dados do BigQuery (roles/bigquery.dataViewer) em qualquer tabela que o agente de dados use como fonte de dados.
• Se uma tabela de fonte de dados usar o controle de acesso no nível da coluna, o leitor refinado (roles/datacatalog.categoryFineGrainedReader) na tag de política apropriada. Para mais informações, consulte Papéis usados com controle de acesso no nível da coluna.
• Se uma tabela de fonte de dados usar o controle de acesso no nível da linha, você precisará receber a política de acesso no nível da função nessa tabela. Para mais informações, consulte Criar ou atualizar políticas de acesso no nível da linha.
• Se uma tabela de origem de dados usar mascaramento de dados, o leitor mascarado (roles/bigquerydatapolicy.maskedReader) na política de dados apropriada. Para mais informações, consulte Funções para consultar dados mascarados.

Se um usuário da conversa não tiver as funções adequadas nas tabelas de dados de origem usadas pelo agente de dados, o seguinte erro será retornado quando o usuário conversar com o agente:

Schema_Resolution: Access Denied

Criar uma conversa com um agente de dados

Siga estas etapas para criar uma conversa com um agente de dados. Você precisa criar um agente de dados antes de iniciar uma conversa com ele.

1. Acesse a página Agentes do BigQuery.

   Acessar a página "Agentes"

2. Na guia Conversas, no painel Chat com seus dados, clique no card do agente de dados com quem você quer conversar. A página da conversa é aberta.

3. No campo Faça uma pergunta, digite uma pergunta que você quer que o agente de dados responda. Você também pode clicar em uma das perguntas sugeridas pelo Gemini para começar.

   O agente de dados responde, informando a ação que está tomando para resolver sua dúvida e retornando os resultados.

   Para conferir as etapas realizadas pelo agente de dados, clique em Ver etapas.

   Para saber como os resultados foram calculados, clique em Como isso foi calculado?:

   

   A guia Texto descreve o código gerado, e a guia Código fornece o código gerado:

   

   Se for adequado para os dados, o agente também vai fornecer gráficos, tabelas e outras visualizações.

Criar uma conversa direta com uma fonte de dados

Siga estas etapas para criar uma conversa direta com uma fonte de dados:

1. Acesse a página Agentes do BigQuery.

   Acessar a página "Agentes"

2. Na guia Conversas, no painel Conversar com seus dados, clique em Fontes de dados.

3. Selecione uma ou mais tabelas e clique em Criar conversa.

4. No campo Faça uma pergunta, digite uma pergunta que você quer que o agente de dados responda. Você também pode clicar em uma das perguntas sugeridas pelo Gemini para começar.

   A API Conversational Analytics processa sua pergunta e retorna os resultados.

   Para conferir as etapas realizadas pela API Conversational Analytics, clique em Ver etapas.

   Para saber como os resultados foram calculados, clique em Como isso foi calculado?:

   

   A guia Texto descreve o código gerado, e a guia Código fornece o código gerado:

   

Abrir uma conversa

Siga estas etapas para abrir uma conversa:

1. Acesse a página Agentes do BigQuery.

   Acessar a página "Agentes"

2. Na guia Conversas, na lista de conversas, clique na conversa que você quer abrir.

Renomear uma conversa

Siga estas etapas para renomear uma conversa:

1. Acesse a página Agentes do BigQuery.

   Acessar a página "Agentes"

2. Na guia Conversas, na lista de conversas, clique na conversa que você quer renomear.

3. Clique em Ver ações > Renomear.

4. Na caixa de diálogo Renomear conversa, digite um novo nome no campo Nome da conversa.

5. Clique em Renomear.

Excluir uma conversa

Siga estas etapas para excluir uma conversa:

1. Acesse a página Agentes do BigQuery.

   Acessar a página "Agentes"

2. Na guia Conversas, na lista de conversas, clique na conversa que você quer renomear.

3. Clique em Ver ações > Excluir.

4. Na caixa de diálogo Excluir conversa?, clique em Excluir.

Locais

A análise de dados de conversação opera globalmente, então não é possível escolher qual região usar.

A seguir

• Saiba mais sobre a análise de conversas no BigQuery.
• Saiba mais sobre a API Conversational Analytics.
• Criar agentes de dados.