Analisar dados com conversas

Neste documento, descrevemos como criar, editar e excluir conversas no Spanner. As conversas são chats persistentes com um agente de dados.

Você pode fazer perguntas de várias partes aos agentes de dados usando termos comuns, por exemplo, "vendas" ou "mais populares", sem especificar nomes de campos de tabela ou definir condições para filtrar os dados. A resposta do chat fornece a resposta à sua pergunta como texto e código, e gera gráficos quando apropriado. A resposta inclui o raciocínio por trás dos resultados.

Você pode criar uma conversa com um agente de dados. Quando você cria uma conversa direta, a API Análises de conversação interpreta sua pergunta sem o contexto e as instruções de processamento oferecidas por um agente de dados.

Antes de começar

  1. Verifique se o faturamento está ativado para o projeto do Google Cloud .

  2. Ative o Spanner, a API Data Analytics com Gemini e o Gemini para APIs Google Cloud .

    Funções necessárias para ativar APIs

    Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

    Ativar as APIs

Funções exigidas

Para trabalhar com agentes de dados, você precisa ter um dos seguintes papéis do Identity and Access Management (IAM) da API Análises de conversação:

  • Consulte dados de fontes de banco de dados compatíveis usando o método QueryData: Usuário de consulta de dados do Gemini Data Analytics (roles/geminidataanalytics.queryDataUser) no nível do projeto.
  • Criar, editar, compartilhar e excluir todos os agentes de dados no projeto: Proprietário do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentOwner) no nível do projeto.
  • Crie seus próprios agentes de dados no projeto: Criador do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator) no nível do projeto. Esse papel concede automaticamente a função de proprietário do agente de dados do Gemini Data Analytics nos agentes de dados que você cria.
  • Ver e editar todos os agentes de dados no projeto: editor do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor) no nível do projeto.
  • Confira todos os agentes de dados no projeto: leitor de agentes de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) no nível do projeto.

Além disso, você precisa ter os seguintes papéis para criar ou editar um agente de dados:

Para trabalhar com recursos do Spanner, consulte Papéis e permissões do Spanner.

Criar conversas

É possível criar conversas persistentes com um agente ou uma fonte de dados no console Google Cloud do Spanner na guia Catálogo de agentes da página Agentes.

Criar uma conversa com um agente de dados

Para criar uma conversa com um agente de dados, primeiro crie e publique um agente de dados. Você também pode iniciar uma conversa com agentes compartilhados por outras pessoas.

Para criar uma conversa com um agente de dados no console Google Cloud , siga estas etapas:

  1. No console Google Cloud , acesse a página do Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista e depois um banco de dados.

  3. No menu de navegação, clique em Agentes.

  4. Na seção Meus agentes ou Compartilhados por outras pessoas na sua organização, clique no card do agente com quem você quer conversar.

  5. Clique em Iniciar uma conversa. Um novo painel de chat é aberto.

  6. No campo Faça uma pergunta, digite uma pergunta para o agente de dados. Por exemplo, "Quais foram nossas vendas totais no último trimestre?" ou "Mostre os cinco principais usuários por tempo de sessão". 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, em seguida, retorna os resultados.

    Para conferir cada etapa que o agente de dados realiza para responder à sua pergunta, clique em Mostrar raciocínio e veja cada mensagem no processo de raciocínio do agente.

    Para saber como os resultados foram calculados, clique em Como isso foi calculado? A seção Resumo agora inclui uma consulta gerada seguida do resultado da consulta. Copie o código e clique em Studio para colar o código no editor de consultas.

    Quando apropriado para os dados, o agente de dados fornece gráficos, tabelas e outras visualizações. Para acessar seu histórico de chat, acesse a lista Gerenciamento de conversas.

    Para ver as informações do agente, acesse o painel Detalhes. Esse painel inclui uma descrição do agente e das fontes de conhecimento dele.

Gerenciar conversas

Você pode abrir, renomear ou excluir uma conversa na página Agentes.

Abrir uma conversa

  1. No console Google Cloud , acesse a página do Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista e depois um banco de dados.

  3. No menu de navegação, clique em Agentes.

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

Renomear uma conversa

  1. No console Google Cloud , acesse a página do Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista e depois um banco de dados.

  3. No menu de navegação, clique em Agentes.

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

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

  6. Na caixa de diálogo Renomear conversa, insira um novo nome para a conversa no campo Nome da conversa.

  7. Clique em Renomear.

Excluir uma conversa

  1. No console Google Cloud , acesse a página do Spanner.

    Acessar o Spanner

  2. Selecione uma instância na lista e depois um banco de dados.

  3. No menu de navegação, clique em Agentes.

  4. Na guia Conversas, na lista de conversas, clique na conversa que você quer excluir.

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

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

Locais

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

A seguir