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 Cloud SQL para PostgreSQL. As conversas são chats persistentes com um agente de dados.

Você pode fazer perguntas com várias partes aos agentes de dados que usam termos comuns, como "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, além de gerar 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 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 projeto do Google Cloud .

2. Ative as APIs Cloud SQL, API Data Analytics com Gemini e Gemini para Google Cloud , se ainda não estiverem ativadas.

   Funções necessárias para ativar APIs

   Para ativar APIs, você precisa da permissão serviceusage.services.enable. Se você criou o projeto, provavelmente já tem essa permissão pelo papel de proprietário (roles/owner). Caso contrário, é possível conseguir essa permissão pelo papel de administrador do Service Usage (roles/serviceusage.serviceUsageAdmin). 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 os papéis necessários 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 IAM da API Conversational Analytics.

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 Análise de Dados do Gemini (roles/geminidataanalytics.dataAgentCreator) no projeto. Esse papel concede automaticamente o papel de proprietário do agente de análise de dados do Gemini nos agentes de dados que você criar. 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, é preciso ter os seguintes papéis 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 vinculação de política do IAM a um projeto. Opcional: se você usa conjuntos de contexto (pré-lançamento) com seu agente de dados de banco de dados, para criar, fazer upload e gerenciar conjuntos de contexto: o papel de Editor do Dataplex Catalog (roles/dataplex.catalogEditor) ou Administrador do Dataplex Catalog (roles/dataplex.catalogAdmin) concedido ao usuário do IAM no nível do projeto. Para mais informações, consulte Permissões de conjuntos de contexto. Privilégios de banco de dados concedidos a um usuário ou conta de serviço do IAM ao fazer 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.
Provisionar agentes no Gemini Enterprise	Para disponibilizar um agente publicado para os 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 conferir todos os agentes de dados no projeto: Leitor do Agente de Dados do Gemini Data Analytics (roles/geminidataanalytics.dataAgentViewer).

Ao gerenciar o acesso aos recursos do 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 se 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ários e papéis específicos do banco de dados.

No 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 uma fonte de dados no console do Google Cloud para o Cloud SQL para PostgreSQL na guia Catálogo de agentes da página Conversas.

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 console do Google Cloud , siga estas etapas:

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

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 conversa é 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 ver cada etapa que o agente de dados segue para responder à sua pergunta, clique em Mostrar raciocínio para conferir cada mensagem no processo de raciocínio do agente.

   Para ver informações sobre como os resultados foram calculados, clique em Como isso foi calculado?. A seção Resumo agora inclui uma consulta gerada seguida pelo resultado. Copie o código e clique em Studio para colá-lo no editor de consultas.

   Quando apropriado para os dados, o agente de dados fornece gráficos, tabelas e outras visualizações. Para ver 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 Conversas.

Abra uma conversa.

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

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

Renomear uma conversa

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

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

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 do Google Cloud , acesse a página do Cloud SQL para PostgreSQL.

   Acessar o Cloud SQL

2. Selecione uma instância na lista.

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

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 conversas opera globalmente. Não é possível escolher qual região usar.

A seguir

• Saiba mais sobre a análise de conversação no Cloud SQL para PostgreSQL.
• Saiba mais sobre a API Conversational Analytics.
• Crie um agente de dados no Cloud SQL para PostgreSQL.