Notas da versão da API Conversational Analytics

Pré-lançamento

Este produto ou 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 produtos e recursos pré-GA estão disponíveis no estado em que se encontram e podem ter suporte limitado. Você encontra mais detalhes nas descrições das fases de lançamento.

Estas notas da versão são para atualizações da API Conversational Analytics.

25 de agosto de 2025

A API Conversational Analytics já está disponível no Acesso antecipado.

Atualizações da biblioteca de cliente:

As seguintes bibliotecas de cliente agora estão disponíveis para vários idiomas:

• PHP (v1beta)
• DotNet (v1beta)
• Python (v1beta)

Atualizações da API Conversational Analytics:

O suporte para endpoints v1beta de HTTP REST já está disponível.

O suporte para métodos de API GetLocation e ListLocations foi adicionado às APIs REST e ao SDK.

Agora é possível compartilhar agentes de dados usando os métodos GetIamPolicy e SetIamPolicy da API.

Agora é possível criar agentes de dados com base em fontes de dados do Looker que usam instâncias do Looker (Google Cloud Core) com redes IP particulares. A API Conversational Analytics não é compatível com fontes de dados baseadas em instâncias do Looker (Google Cloud Core) que estão dentro de perímetros de nuvem privada virtual.

O contexto estruturado para fontes de dados do BigQuery já está disponível. Isso inclui a capacidade de adicionar exemplos de pares de perguntas/consultas, descrições de tabelas, sinônimos e tags nos níveis de tabela e campo usando a API.

Agora há suporte para as APIs Location e Operation. Os papéis de gerenciamento de identidade e acesso DataAgentCreator e DataAgentEditor agora têm permissões para APIs de operação.

Fizemos uma melhoria no armazenamento automático de Last Published Context na camada do servidor sempre que o contexto publicado de um agente de dados é atualizado.

Os nomes de exibição das funções do gerenciamento de identidade e acesso foram atualizados para "Usuário de chat sem estado do Gemini Data Analytics" e "Criador do agente de dados do Gemini Data Analytics". Para mais informações sobre os papéis do Identity and Access Management usados com a API Conversational Analytics, consulte a página de documentação Conceder papéis e permissões do Identity and Access Management da API Conversational Analytics.

A versão 1.1 do Colaboratory já está disponível.

Atualizações no tratamento de erros foram feitas para lidar com erros internos 500 relacionados a conversas em chats com estado.

Melhores mensagens de tratamento de exceções foram implementadas para 400 erros do cliente.

Atualizações da documentação:

Agora você pode usar o novo aplicativo de início rápido do Streamlit no GitHub para configurar uma demonstração da API Conversational Analytics em minutos.

A demonstração principal da API Conversational Analytics já está disponível no GitHub. Com a demonstração Golden da API Conversational Analytics, você pode conferir exemplos de como integrar a API Conversational Analytics a aplicativos da Web, além de uma demonstração completa de produção em TypeScript. Este projeto é apenas para fins de demonstração. Ele não se destina ao uso em um ambiente de produção.

Exemplos de código de payload de solicitação foram adicionados às APIs REST e ao SDK.

Arquitetura, fluxos de trabalho e papéis da API Conversational Analytics: saiba mais sobre os principais conceitos para usar a API Conversational Analytics, incluindo como os agentes de dados funcionam, fluxos de trabalho típicos de agentes de dados, modos de conversa, papéis do Identity and Access Management e como projetar sistemas que usam vários agentes de dados.

Limitações conhecidas da API Conversational Analytics: saiba mais sobre as limitações no número de fontes de dados, estilo de visualizações e tamanho dos conjuntos de dados.

Resolver problemas de erros da API Conversational Analytics: saiba mais sobre possíveis problemas ou erros com a API Conversational Analytics, além de soluções propostas.

Monitore e gerencie os custos do BigQuery para seus agentes da API Conversational Analytics: saiba como implementar controles de custo para seus agentes da API Conversational Analytics.

Os métodos SetIAMPolicy e GetIAMPolicy estão disponíveis na página de documentação Visão geral da API Conversational Analytics para uso no compartilhamento de agentes de dados.

Uma nova página de documentação com respostas a perguntas frequentes sobre a API Conversational Analytics já está disponível.

Oriente o comportamento do agente com contexto criado para fontes de dados do BigQuery: saiba como escrever instruções do sistema para fontes de dados do BigQuery.

Orientar o comportamento do agente com contexto criado para fontes de dados do Looker: saiba como escrever instruções do sistema para fontes de dados do Looker.

15 de julho de 2025

Agora é possível convidar usuários para colaborar em agentes de dados específicos atribuindo papéis predefinidos do IAM. Para mais detalhes, consulte Permissões e papéis do IAM da API Conversational Analytics.

Um novo guia de práticas recomendadas ajuda você a fornecer um contexto de negócios e dados eficaz aos seus agentes. Para mais informações, consulte Orientar o comportamento do agente com contexto criado.

Atualizações do SDK:

Agora é possível instalar o SDK do Python no índice de pacotes do Python (PyPI).

25 de junho de 2025

Atualizações da API:

Novos papéis predefinidos do IAM controlam o acesso para criar, gerenciar e interagir com agentes de dados:

• geminidataanalytics.dataAgentCreator
• geminidataanalytics.dataAgentOwner
• geminidataanalytics.dataAgentEditor
• geminidataanalytics.dataAgentUser
• geminidataanalytics.dataAgentViewer
• geminidataanalytics.dataAgentStatelessUser

Para uma lista completa de papéis e permissões, consulte Conceder permissões e papéis do IAM da API Conversational Analytics.

5 de junho de 2025

O pré-lançamento privado inicial da API Conversational Analytics introduziu recursos para criar e interagir com agentes de dados.

Os seguintes notebooks interativos do Colaboratory estão disponíveis para começar a usar o REST e o SDK do Python:

• Notebook do Colab HTTP
• Notebook do Colab do SDK do Python

Atualizações da API:

Com o Serviço de agente de dados, é possível criar, configurar e gerenciar de maneira programática agentes de IA persistentes e sensíveis ao contexto com o Looker, o Looker Studio e o BigQuery.

O serviço Data Chat permite conversar com seu agente usando vários modos de chat. Esses modos incluem um modo com estado em que o Google gerencia o histórico de conversas, uma opção com estado em que o aplicativo gerencia a conversa e um modo sem estado em que o aplicativo fornece o contexto completo a cada solicitação.

A API oferece suporte a análise avançada usando Python e repete automaticamente as consultas com falha.

A API Conversational Analytics (geminidataanalytics.googleapis.com) substitui a API Data QnA descontinuada (dataqna.googleapis.com), incluindo a migração de DataQuestionService para o novo DataChatService. Para instruções detalhadas sobre como atualizar suas solicitações, consulte o guia de migração.