Analisar dados com conversas

Visualizar

Este recurso está sujeito aos Termos das Soluções 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 suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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

É possível fazer perguntas de várias partes aos agentes de dados que usam termos comuns, por exemplo, "vendas" ou "mais popular", 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.

É possível criar uma conversa com um agente de dados. Ao criar 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. Verifique se o faturamento está ativado para o Google Cloud projeto.

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

   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 permissões do IAM que correspondam ao seu caso de uso. A tabela a seguir lista as funções necessárias com base em se você está criando e publicando agentes, provisionando agentes no Gemini Enterprise ou descobrindo e usando agentes. Para mais informações, consulte Papéis do Identity and Access Management da API Conversational Analytics roles.

Caso de uso	Funções exigidas
Criar, editar, publicar, compartilhar e excluir agentes	Para criar agentes de dados em um projeto: Criador do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentCreator) no projeto. Essa função concede automaticamente o papel de proprietário do agente de dados do Gemini Data Analytics nos agentes de dados que você cria. Para editar, compartilhar ou excluir um agente de dados: Proprietário do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentOwner) no agente ou projeto. Para editar um agente de dados em um projeto: Editor do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentEditor) no projeto. Para visualizar agentes de dados em um projeto: Leitor do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) no projeto. Além disso, você precisa ter as seguintes funções para criar ou editar um agente de dados: Um usuário do IAM ou uma conta de serviço adicionada ao cluster. Para mais informações, consulte Aplicar papéis do IAM. O papel spanner.databaseReader concedido ao usuário do IAM no nível do projeto. Para mais informações, consulte Adicionar uma vinculação de política do IAM a um projeto. Funções e permissões concedidas ao usuário do IAM no nível do projeto para os bancos de dados necessários. Para mais informações, consulte Conceder papéis e permissões.
Provisionar agentes no Gemini Enterprise	Para disponibilizar um agente publicado aos usuários no Gemini Enterprise, você precisa de permissões para registrar e gerenciar agentes A2A no console de administração do Gemini Enterprise.
Descobrir e usar agentes	Para conversar com agentes de dados: Usuário do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentUser). Para visualizar todos os agentes de dados no projeto: Leitor do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer).

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 com 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 um agente de dados e publique-o. Também é possível iniciar uma conversa com agentes que outras pessoas compartilham com você.

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

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

   Acessar o Spanner

2. Selecione uma instância na lista e, em seguida, um banco de dados.

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

4. Na seção Meus agentes ou Compartilhado 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 será 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á realizando para responder à sua pergunta e, em seguida, retorna os resultados.

   Para conferir cada etapa que o agente de dados realiza para fornecer a resposta à sua pergunta, clique em Mostrar raciocínio para visualizar cada mensagem no processo de raciocínio do agente.

   Para conferir informações sobre 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. É possível copiar o código e clicar 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 conferir o histórico de conversas, acesse a lista Gerenciamento de conversas.

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

Gerenciar conversas

É possível abrir, renomear ou excluir uma conversa na página Agentes.

Abrir uma conversa

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

   Acessar o Spanner

2. Selecione uma instância na lista e, em seguida, 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 Google Cloud console, acesse a página Spanner.

   Acessar o Spanner

2. Selecione uma instância na lista e, em seguida, 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, digite um novo nome para a conversa no campo Nome da conversa.

7. Clique em Renomear.

Excluir uma conversa

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

   Acessar o Spanner

2. Selecione uma instância na lista e, em seguida, 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 conversacional opera globalmente. Não é possível escolher qual região usar.

A seguir

• Saiba mais sobre a análise conversacional no Spanner.
• Saiba mais sobre a API Conversational Analytics.
• Crie um agente de dados no Spanner.