API de análise conversacional: crie agentes de dados e converse com seus dados, API de análise conversacional: crie agentes de dados e converse com seus dados

Prévia privada

Este produto ou recurso está sujeito aos "Termos de Ofertas 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 do estágio de lançamento .

Os desenvolvedores podem usar a API de Análise Conversacional, acessada em geminidataanalytics.googleapis.com , para criar uma interface de bate-papo com inteligência artificial (IA), ou um agente de dados, que responda a perguntas sobre dados estruturados no BigQuery, Looker e Looker Studio usando linguagem natural. Com a API de Análise Conversacional, 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 bate-papo com dados fluida e auditável.

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

Aprenda como e quando Gêmeos para Google Cloud usa seus dados . Como uma tecnologia em estágio inicial, Gemini para Google Cloud produtos podem gerar resultados que parecem plausíveis, mas são factualmente incorretos. 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 .

Nota: As ofertas de pré-visualização GA (1) destinam-se ao uso apenas em 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 regulatória e (2) estão sujeitas aos Termos de Ofertas Pré-GA dos Termos Específicos de Serviço e ao Adendo de Consentimento para Gemini para Google Cloud Programa de Testador Confiável .

Comece a usar a API de análise conversacional

Siga estas etapas para configurar seu ambiente e começar a criar e interagir com agentes de dados usando a API de análise conversacional.

Observação: para usar a API de Análise Conversacional, você precisa participar da pré-visualização privada. Para expressar interesse, preencha o formulário de interesse na pré-visualização .

Configuração e pré-requisitos

Antes de usar a API ou os exemplos, conclua as seguintes etapas:

• Habilitar a API de análise conversacional : descreve os pré-requisitos para habilitar a API de análise conversacional.
• Autenticar e conectar-se a uma fonte de dados com a API do Conversational Analytics : fornece instruções para autenticação na API e configuração de conexões com seus dados do BigQuery, Looker e Looker Studio.

Crie e interaja com um agente de dados

Após concluir as etapas anteriores, use a API do 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.
• Crie um agente de dados usando o Python SDK : fornece um exemplo completo de como criar e interagir com um agente de dados usando o Python SDK.
• Crie uma conversa multi-turno : fornece orientação e exemplos para lidar com perguntas de acompanhamento (com e sem estado) usando o Python SDK.
• Renderizar uma resposta do agente da API de análise conversacional como uma visualização : fornece um exemplo de processamento de especificações de gráfico a partir de respostas da API e renderizá-las como visualizações usando o SDK do Python e a biblioteca Vega-Altair.

Operações principais da API

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

Nome da API	Método HTTP	Ponto final	Descrição
Criar agente	POST	/v1alpha/projects/*/locations/*/dataAgents	Cria um novo agente de dados.
Obter agente	GET	/v1alpha/projects/*/locations/*/dataAgents/*	Recupera detalhes de um agente de dados específico.
Agente de atualização	PATCH	/v1alpha/projects/*/locations/*/dataAgents/*	Modifica um agente de dados existente.
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.
Bater papo	POST	/v1alpha/projects/*/locations/*:chat	Envia uma mensagem de bate-papo para um agente de dados.
Criar conversa	POST	/v1alpha/projects/*/locations/*/conversations	Inicia uma nova conversa.
Obter 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 mensagens dentro de uma conversa específica.

Recursos adicionais

• Documentação de referência da API de análise conversacional : fornece descrições detalhadas de métodos, pontos de extremidade e definições de tipo para estruturas de solicitação e resposta.