Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

Analisar dados com conversas

Este documento descreve como criar, editar e excluir conversas no Cloud SQL para PostgreSQL. As conversas são chats persistentes com um agente de dados.

Você pode 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.

Você pode 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

Verifique se o faturamento está ativado para o Google Cloud projeto.
Ative o Cloud SQL, a API Data Analytics com 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 um dos seguintes papéis Identity and Access Management (IAM) da API Conversational Analytics:

Consultar dados de fontes 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.
Criar 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 o papel de proprietário do agente de dados do Gemini Data Analytics nos agentes de dados que você cria.
Visualizar 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.
Visualizar todos os agentes de dados no projeto: Leitor do agente de dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer) no nível do 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 à instância. Para mais informações, consulte Gerenciar usuários com a autenticação de banco de dados do IAM para o Cloud SQL.
Os papéis cloudsql.studioUser e cloudsql.instanceUser concedidos 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.
Privilégios de banco de dados concedidos a um usuário do IAM ou a uma conta de serviço fazendo login como o usuário postgres.
```
GRANT ALL ON SCHEMA public TO public;
```
Para mais informações, consulte Conceder privilégios de banco de dados a um usuário individual do IAM ou a uma conta de serviço.

Ao gerenciar o acesso aos recursos de banco de dados do Cloud SQL para PostgreSQL, considere as seguintes camadas de permissões:

Google Cloud IAM: controla o acesso à instância do banco de dados como um recurso de nuvem. Isso inclui permissões para conectar, gerenciar a instância e executar consultas SQL, por exemplo, usando a permissão executeSql.
Permissões de banco de dados: controlam o acesso a objetos no banco de dados, como tabelas, visualizações e esquemas. Eles são gerenciados usando comandos SQL como GRANT e sistemas de usuário e função específicos do banco de dados.

Para o Cloud SQL para PostgreSQL, você precisa de papéis do IAM do Cloud SQL adequados para se conectar à instância e ter autorização para enviar consultas. Para interagir com objetos como tabelas e visualizações, o usuário do banco de dados de conexão precisa ter os privilégios necessários concedidos usando o sistema GRANT do Cloud SQL para PostgreSQL. Para mais informações, consulte Sobre usuários e papéis do PostgreSQL. Se o agente usar uma conta de serviço, você poderá receber um papel de banco de dados atribuído. Por exemplo, consulte Gerenciar usuários com a autenticação de banco de dados do IAM.

Criar conversas

É possível criar conversas persistentes com um agente ou com uma fonte de dados no console Google Cloud do Cloud SQL para PostgreSQL na guia Catálogo de agentes na 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. Você também pode 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:

No Google Cloud console, acesse a página do Cloud SQL para PostgreSQL.

Acessar o Cloud SQL
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Na seção Meus agentes ou Compartilhado por outras pessoas na sua organização, clique no card do agente com quem você quer conversar.
Clique em Iniciar uma conversa. Um novo painel de chat será aberto.
No campo Faça uma pergunta, insira 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 declarando a ação que está tomando 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. Você pode 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 seu histórico de chat, 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

No Google Cloud console, acesse a página do Cloud SQL para PostgreSQL.

Acessar o Cloud SQL
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Na guia Conversas, na lista de conversas, clique na conversa que você quer abrir.

Renomear uma conversa

No Google Cloud console, acesse a página do Cloud SQL para PostgreSQL.

Acessar o Cloud SQL
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Na guia Conversas, na lista de conversas, clique na conversa que você quer renomear.
Clique em Ver ações > Renomear.
Na caixa de diálogo Renomear conversa, insira um novo nome para a conversa no campo Nome da conversa.
Clique em Renomear.

Excluir uma conversa

No Google Cloud console, acesse a página do Cloud SQL para PostgreSQL.

Acessar o Cloud SQL
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Na guia Conversas, na lista de conversas, clique na conversa que você quer excluir.
Clique em Ver ações > Excluir.
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 Cloud SQL para PostgreSQL.
Saiba mais sobre a API Conversational Analytics.
Crie um agente de dados no Cloud SQL para PostgreSQL.