API Conversational Analytics: crie agentes de dados e converse com seus dados

Prévia particular

Esse produto ou recurso está sujeito aos "Termos da oferta pré-GA" na seção "Termos gerais de serviço" dos Termos específicos de serviço. Os produtos e 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 das fases de lançamento.

Os desenvolvedores podem usar a API de análise conversacional, acessada por geminidataanalytics.googleapis.com, para criar uma interface de chat com tecnologia de inteligência artificial (IA) ou um agente de dados que responda a perguntas sobre dados estruturados no BigQuery, no Looker e no Looker Studio usando linguagem natural. Com a API Conversational Analytics, você fornece ao seu agente de dados informações e dados comerciais ("contexto"), além de acesso a ferramentas como SQL, Python e bibliotecas de visualização. Essas respostas do agente são apresentadas ao usuário e podem ser registradas pelo aplicativo cliente, criando uma experiência de chat de dados simples e auditável.

Importante: se você estiver migrando da API Data QnA, consulte o guia de migração para ter uma visão geral das principais diferenças e etapas necessárias.

Saiba como e quando o Gemini para Google Cloud usa seus dados. Como uma tecnologia em estágio inicial, o Gemini para produtos Google Cloud pode gerar uma saída que parece plausível, mas é factualmente incorreta. Recomendamos que você valide todos os resultados do Gemini para Google Cloud produtos antes de usá-los. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

Observação: as ofertas de pré-lançamento (1) são destinadas apenas a ambientes de teste e não devem ser usadas em um ambiente de produção ou para processar dados pessoais ou outros dados sujeitos a requisitos de conformidade legal ou regulamentar. Além disso, (2) estão sujeitas aos Termos de Ofertas Pré-GA dos Termos Específicos de Serviço e ao Adendo de Consentimento para o Programa Trusted Tester do Gemini.

Google Cloud

Começar a usar a API Conversational Analytics

Siga estas etapas para configurar seu ambiente e começar a criar e interagir com agentes de dados usando a API Conversational Analytics.

Observação: para usar a API Conversational Analytics, você precisa fazer parte da visualização privada. Para demonstrar interesse, preencha o formulário de interesse na prévia.

Configuração e pré-requisitos

Antes de usar a API ou os exemplos, siga estas etapas:

• Ativar a API Conversational Analytics: descreve os pré-requisitos para ativar a API Conversational Analytics.
• Autenticar e se conectar a uma fonte de dados com a API Conversational Analytics: oferece instruções para autenticar a API e configurar conexões com os dados do BigQuery, do Looker e do Looker Studio.

Criar e interagir com um agente de dados

Depois de concluir as etapas anteriores, use a API Conversational Analytics para criar e interagir com um agente de dados seguindo estas etapas:

• Criar um agente de dados usando HTTP: fornece um exemplo completo de como criar e interagir com um agente de dados usando solicitações HTTP diretas com Python.
• Criar um agente de dados usando o SDK do Python: apresenta um exemplo completo de como criar e interagir com um agente de dados usando o SDK do Python.
• Criar uma conversa com várias interações: oferece orientações e exemplos para lidar com perguntas de acompanhamento (com e sem estado) usando o SDK do Python.
• Renderizar uma resposta do agente da API de análise de conversas como uma visualização: mostra um exemplo de como processar especificações de gráficos de respostas da API e renderizá-las como visualizações usando o SDK do Python e a biblioteca Vega-Altair.

Principais operações de API

A API oferece os seguintes endpoints principais para gerenciar agentes de dados e conversas:

Nome da API	Método HTTP	Endpoint	Descrição
Criar agente	POST	/v1alpha/projects/*/locations/*/dataAgents	Cria um novo agente de dados.
Acessar agente	GET	/v1alpha/projects/*/locations/*/dataAgents/*	Recupera detalhes de um agente de dados específico.
Atualizar agente	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	Modifica um agente de dados.
Excluir agente	DELETE	/v1alpha/projects/*/locations/*/dataAgents/*	Remove um agente de dados.
Listar agentes	GET	/v1alpha/projects/*/locations/*/dataAgents	Lista os agentes de dados disponíveis em um projeto.
Chat	POST	/v1alpha/projects/*/locations/*:chat	Envia uma mensagem de chat para um agente de dados.
Criar conversa	POST	/v1alpha/projects/*/locations/*/conversations	Inicia uma nova conversa.
Acessar conversa	GET	/v1alpha/projects/*/locations/*/conversations/*	Recupera detalhes de uma conversa específica.
Listar conversas	GET	/v1alpha/projects/*/locations/*/conversations	Lista as conversas em um projeto específico.
Listar mensagens	GET	/v1alpha/projects/*/locations/*/conversations/*/messages	Lista as mensagens de uma conversa específica.

Outros recursos

• Documentação de referência da API Conversational Analytics: fornece descrições detalhadas de métodos, endpoints e definições de tipo para estruturas de solicitação e resposta.