Os agentes de dados de conversação permitem interagir com os dados do banco de dados usando uma interface de linguagem natural. Ao criar esses agentes, você ajuda os usuários a "conversar com os dados", gerando insights de bancos de dados operacionais sem precisar escrever consultas SQL complexas.
Em termos gerais, um agente de dados é uma combinação de persona, um conjunto de fontes de dados, com acesso a um conjunto de conhecimento empresarial essencial para as finalidades dele.
Para desenvolvedores de aplicativos, esses agentes oferecem os seguintes benefícios:
- Alta precisão: ao usar o contexto criado, é possível alcançar alta precisão para perguntas de negócios específicas. O contexto criado é o principal fator que os criadores de agentes podem usar para melhorar a precisão. Ele inclui descrições de esquema, instruções do sistema e contexto estruturado que fornece informações adicionais sobre as consultas de banco de dados esperadas.
- Menos complexidade: os agentes traduzem linguagem natural em consultas SQL, execução e até mesmo resumo ou visualização de dados.
- Flexibilidade: é possível criar rascunhos de agentes para testes pessoais ou publicá-los para disponibilizá-los a outros usuários no seu projeto ou de forma programática usando a API.
Antes de começar
-
Verifique se o faturamento está ativado para o projeto do Google Cloud .
-
Ative as APIs Bigtable, Bigtable Admin, 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.
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 Identity and Access Management da API Conversational Analytics.
| Caso de uso | Funções exigidas |
|---|---|
| Criar, editar, publicar, compartilhar e excluir agentes |
|
| 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 trabalhar com recursos do Bigtable, consulte Papéis e permissões do Bigtable.
Criar um agente de dados
As seções a seguir descrevem como criar um agente de dados. Depois de criar um agente, é possível editar as configurações dele.
Configurar noções básicas
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Clique na guia Catálogo de agentes.
Clique em Criar agente. A página Editor é aberta.
Na seção Editor, no campo Nome do agente, insira um nome descritivo para o agente de dados, por exemplo,
Q4 sales dataouUser activity logs.No campo Descrição do agente, insira uma descrição do agente de dados. Uma boa descrição explica o que o agente faz, quais dados ele usa e ajuda a determinar se esse é o agente de dados correto para uma conversa, por exemplo,
What are the top 10 selling products in Q2?.Na seção Fontes de conhecimento, clique em Adicionar fonte. A página Adicionar dados é aberta.
Selecione as tabelas em que o agente vai se concentrar ao responder a perguntas.
Clique em Adicionar dados. A página do novo agente será reaberta.
Clique em Salvar rascunho para registrar seu progresso.
Criar consultas verificadas
Você pode selecionar consultas verificadas em uma lista gerada pelo sistema ou criar as suas.
Para criar uma consulta verificada para o agente de dados, faça o seguinte:
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Clique na guia Catálogo de agentes.
Localize o card do agente de dados que você quer modificar. Se o agente de dados for um rascunho não publicado, clique em Rascunhos de agentes.
Para abrir o agente de dados no editor de agentes, clique em Abrir ações e em Editar no card do agente.
Em Consultas verificadas, clique em Adicionar consulta.
- Em Pergunta, insira a pergunta que pode ser respondida pela consulta verificada.
- Clique em Gerar SQL para que o Gemini gere uma consulta verificada que corresponda à pergunta que você adicionou.
- Clique em Executar e verifique se a consulta retorna os resultados esperados.
- Revise a resposta e modifique a consulta verificada, se necessário.
- Clique em Adicionar.
- Clique em Salvar rascunho para registrar seu progresso.
Repita essas etapas para criar outras consultas verificadas.
Adicionar rótulos aos agentes de dados
Na seção Configurações do agente, é possível criar rótulos para organizar seus recursos do Google Cloud . Rótulos são pares de chave-valor que permitem agrupar objetos relacionados entre si ou com outros recursos do Google Cloud.
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Clique na guia Catálogo de agentes.
Localize o card do agente de dados que você quer modificar. Se o agente de dados for um rascunho não publicado, clique em Rascunhos de agentes.
Para abrir o agente de dados no editor de agentes, clique em Abrir ações e em Editar no card do agente.
Na seção Configurações do agente, clique em Adicionar rótulo. O painel Gerenciar marcadores é aberto.
Clique em Adicionar rótulo.
Nos campos chave e valor, insira o par de chave-valor do rótulo.
Se quiser incluir mais rótulos, clique novamente em Adicionar rótulo.
Para excluir um rótulo, clique em Excluir.
Quando terminar, clique em Adicionar. A página do novo agente será reaberta.
Continue para a próxima seção para colocar o agente no modo de rascunho ou para publicá-lo.
Visualizar e publicar o agente
Na seção Visualização, insira um exemplo de pergunta no campo Fazer uma pergunta e pressione Enter.
Para verificar se o agente de dados retorna os dados esperados, analise a resposta do agente. Se a resposta não for o que você espera, mude as configurações na seção Editor para refinar a configuração do agente de dados até receber respostas satisfatórias. Você pode continuar testando e modificando o agente para refinar os resultados.
Clique em Salvar rascunho.
Para colocar o agente de dados no modo de rascunho, que pode ser editado novamente mais tarde, clique em Voltar para retornar à página Catálogo de agentes. Como o agente agora está no modo de rascunho, ele aparece na seção Rascunhos de agentes na guia Catálogo de agentes.
Para publicar o agente, permaneça na página de criação e prossiga para a próxima etapa.
Para publicar o agente de dados e disponibilizá-lo para uso no projeto, clique em Publicar. Na caixa de diálogo Canais de publicação, selecione os canais de publicação que serão usados. Clique em Publicar agente (ou Publicar atualizações).
Ao publicar o agente, outros usuários que têm acesso às mesmas tabelas de banco de dados podem visualizar e conversar com seu agente, aproveitando as instruções e o contexto que você criou.
É possível criar conversas com o agente de dados usando a página Agentes no console do Google Cloud . Também é possível criar sua própria interface para conversar com o agente de dados usando a API Conversational Analytics.
Opcional: na caixa de diálogo Seu agente foi publicado e está pronto para ser compartilhado, clique em Compartilhar para compartilhar o agente de dados com outros usuários.
- No painel Permissões de compartilhamento, clique em Adicionar principal.
- No campo Novos principais, insira um ou mais principais.
- Clique na lista Selecionar um papel.
- Na lista Papel, selecione um dos seguintes papéis:
- Usuário do Agente de Análise de Dados do Gemini
(
roles/geminidataanalytics.dataAgentUser): concede permissão para conversar com o agente de dados. - Editor do agente de dados do Gemini Data Analytics
(
roles/geminidataanalytics.dataAgentEditor): concede permissão para editar o agente de dados. - Leitor do agente de dados do Gemini Data Analytics
(
roles/geminidataanalytics.dataAgentViewer): concede permissão para visualizar o agente de dados.
- Usuário do Agente de Análise de Dados do Gemini
(
- Clique em Salvar.
Opcional: é possível publicar o agente de dados no Gemini Enterprise. Para mais informações, consulte Publicar um agente de dados no Gemini Enterprise.
Para voltar à página do novo agente, clique em Fechar. Depois de salvar ou publicar o agente, ele vai aparecer no Catálogo de Agentes.
Gerenciar agentes de dados
Você pode encontrar os agentes atuais na guia Catálogo de agentes, que consiste em três seções:
- Todos os agentes: uma lista de todos os agentes que você cria e publica, além dos agentes que outras pessoas criam e compartilham com você.
- Meus agentes: uma lista de todos os agentes que você cria e publica. Você pode modificar e compartilhar agentes publicados com outras pessoas.
Rascunhos de agentes: agentes que você ainda não publicou. Não é possível compartilhar rascunhos de agentes.
Editar um agente de dados
Para editar um agente de dados, siga estas etapas:
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Clique na guia Catálogo de agentes.
Localize o card do agente de dados que você quer modificar. Se o agente de dados for um rascunho não publicado, clique em Rascunhos de agentes.
Para abrir o agente de dados no editor de agentes, clique em Abrir ações e em Editar no card do agente.
Edite a configuração do agente de dados conforme necessário.
Para salvar as mudanças sem publicar, clique em Salvar rascunho.
Para publicar o agente de dados e disponibilizá-lo para uso no projeto, clique em Publicar. Na caixa de diálogo Canais de publicação, selecione os canais de publicação que serão usados. Clique em Publicar agente (ou Publicar atualizações). Na caixa de diálogo Compartilhar, você pode compartilhar o agente com outras pessoas ou clicar em Fechar.
Para voltar ao painel Catálogo de agentes, clique em Voltar.
Compartilhar um agente de dados
Siga estas etapas para compartilhar um agente de dados publicado. Não é possível compartilhar agentes de rascunho.
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Clique na guia Catálogo de agentes.
Localize o card do agente de dados que você quer modificar.
Para abrir o agente de dados no editor de agentes, clique em Abrir ações > clique em Editar no card do agente.
Para compartilhar o agente de dados com outros usuários, clique em Compartilhar.
No painel Permissões de compartilhamento, clique em Adicionar principal.
No campo Adicionar principais, insira um ou mais principais.
Clique em Selecionar papel.
Na lista Papel, selecione um dos seguintes papéis:
- Usuário do agente de dados do Gemini Data Analytics
(
roles/geminidataanalytics.dataAgentUser): concede permissão para conversar com o agente de dados. - Editor do agente de dados do Gemini Data Analytics
(
roles/geminidataanalytics.dataAgentEditor): concede permissão para editar o agente de dados. - Leitor do Agente de Análise de Dados do Gemini
(
roles/geminidataanalytics.dataAgentViewer): concede permissão para visualizar o agente de dados.
- Usuário do agente de dados do Gemini Data Analytics
(
Clique em Salvar.
Para voltar à página de edição do agente, clique em Fechar.
Para voltar ao painel Catálogo de agentes, clique em Voltar.
Excluir um agente de dados
No console do Google Cloud , acesse a página do Bigtable.
Selecione uma instância na lista.
No menu de navegação, clique em Agentes.
Selecione a guia Catálogo de agentes.
Localize o card do agente de dados que você quer excluir. Se o agente de dados for um rascunho não publicado, clique em Rascunhos de agentes.
Clique em Abrir ações > Excluir.
Na caixa de diálogo Excluir agente?, clique em Excluir. A exclusão permanente do agente o remove do projeto.
Depois que você exclui um agente, as conversas ficam disponíveis no modo somente visualização. Não é possível fazer novas perguntas ao agente excluído.
Publicar um agente de dados no Gemini Enterprise
A publicação de um agente de dados envolve a colaboração entre analistas de dados, administradores do Gemini Enterprise e usuários empresariais. Para saber mais sobre os papéis necessários para esses usuários, consulte Papéis necessários.
Criar e publicar um agente
Para criar, editar e publicar um agente, siga estas etapas:
- Crie ou edite seu agente de dados no Bigtable.
- Publique o agente. Ao publicar o agente, selecione Gemini Enterprise como uma opção de publicação.
- Para copiar o JSON do endpoint de A2A, clique em Copiar JSON.
- Compartilhe o JSON do endpoint A2A e a lista de usuários com o administrador do Gemini Enterprise para que ele possa registrar o agente personalizado no console do Google Cloud e configurar as permissões de acesso. Para mais informações, consulte Provisionar um agente.
- Compartilhe o agente com os usuários e grupos que precisam de acesso.
Provisionar um agente
Para disponibilizar um agente publicado aos usuários no console do Google Cloud , siga estas etapas:
No console do Google Cloud , acesse Gemini Enterprise.
Clique no nome do app em que você quer registrar o agente.
Clique em Agentes > Adicionar agentes.
Na seção Escolher um tipo de agente, clique em Adicionar em Agente personalizado via A2A.
No campo JSON do card do agente, insira os detalhes do card do agente que você recebeu do analista de dados no formato JSON.
Clique em Visualizar detalhes do agente > Próxima.
Para permitir que o agente acesse os recursos do Google Cloud em seu nome, siga estas etapas:
Insira o ID do cliente e a chave secreta do cliente que você gerou na seção Configurar detalhes de autorização.
No campo URI de autorização, insira o seguinte:
https://accounts.google.com/o/oauth2/v2/auth?client_id=client_id&redirect_uri=https%3A%2F%2Fvertexaisearch.cloud.google.com%2Fstatic%2Foauth%2Foauth.html&scope=https%3A%2F%2Fwww.googleapis.com%2Fauth%2Fcloud-platform&include_granted_scopes=true&response_type=code&access_type=offline&prompt=consent
Substitua client_id pelo ID do cliente que você gerou em Configurar detalhes de autorização.
No campo URI do token, insira o seguinte:
https://oauth2.googleapis.com/token
No campo Escopos, insira o seguinte:
https://www.googleapis.com/auth/cloud-platform
Clique em Concluir.
Compartilhe o agente com os usuários ou grupos.
Para mais informações, consulte Registrar e gerenciar agentes A2A.
Encontrar e usar um agente
Você pode encontrar e usar um agente de dados no Gemini Enterprise usando qualquer um dos seguintes métodos:
- Localize o agente na Galeria de Agentes e inicie um chat dedicado.
- Use o URL dedicado do agente para abrir o Gemini Enterprise diretamente em uma sessão com esse agente de dados específico do Bigtable.
- Invoque o agente escrevendo um
@mention, como@sales_pipeline_agent, no chat principal do Gemini Enterprise. - Faça uma pergunta analítica geral, como "Qual é a tendência do nosso pipeline de vendas nos últimos três meses?", para que o Gemini Enterprise encaminhe automaticamente a consulta ao agente de dados relevante.
Depois de encontrar o agente, você pode interagir com ele usando um dos seguintes métodos:
- Conclua o login único do OAuth para autenticar com segurança no Bigtable.
- Faça perguntas em linguagem natural. O agente de análise de conversação processa suas solicitações e transmite a resposta de volta para o Gemini Enterprise como texto, Markdown, gráficos ou tabelas.
- Confira seu histórico de conversas no painel de histórico, onde as conversas são salvas automaticamente.
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 conversacional no Bigtable.
- Saiba mais sobre a API Conversational Analytics.
- Analisar dados com conversas.
- Saiba como o papel de
Leitor do agente de dados do Gemini Data Analytics (
roles/geminidataanalytics.dataAgentViewer) concede permissão para visualizar o agente de dados.