Estas notas de lançamento destinam-se a atualizações da API Conversational Analytics.
25 de setembro de 2025
Atualizações da API Conversational Analytics:
Está agora disponível uma nova API, a ListAccessibleDataAgents, para listar os agentes de dados acessíveis a um utilizador num projeto. Um agente de dados é considerado acessível se o utilizador que invoca a API tiver a autorização get no agente. Pode usar o campo creator_filter para gerir os agentes que este método devolve:
NONE(predefinição): devolve todos os agentes de dados acessíveis ao utilizador, independentemente do criador.CREATOR_ONLY: devolve apenas os agentes de dados que foram criados pelo utilizador.NOT_CREATOR_ONLY: devolve apenas os agentes de dados que foram criados por outros utilizadores.
A enumeração systemMessage.text.textType está agora disponível com os valores FINAL_RESPONSE e THOUGHT, o que ajuda os clientes a distinguir entre diferentes tipos de mensagens de texto. A API Conversational Analytics usa agora systemMessage.text mensagens com textType = THOUGHT para produzir passos de raciocínio.
A API suporta agora até cinco origens de dados do Looker Explore no contexto. Os pedidos de chat geram consultas na exploração mais relevante. Para mais informações, consulte a documentação sobre a ligação a dados do Looker com HTTP e com o SDK Python.
O campo systemMessage.data.generatedLookerQuery é agora systemMessage.data.query.looker.
25 de agosto de 2025
A API Conversational Analytics já está disponível na Pré-visualização pública.
Atualizações da biblioteca de cliente:
As seguintes bibliotecas cliente estão agora disponíveis para vários idiomas:
Atualizações da API Conversational Analytics:
O suporte para pontos finais v1beta para HTTP REST já está disponível.
Foi adicionado suporte para os métodos da API GetLocation e ListLocations às APIs REST e ao SDK.
Já pode partilhar agentes de dados através dos métodos da API GetIamPolicy e SetIamPolicy.
Agora, pode criar agentes de dados a partir de origens de dados do Looker baseadas em instâncias do Looker (Google Cloud core) que usam redes de IP privadas. (A API Conversational Analytics não suporta origens de dados baseadas em instâncias do Looker (Google Cloud core) que se encontram dentro de perímetros da nuvem privada virtual.)
O contexto estruturado para origens de dados do BigQuery já está disponível. Isto inclui a capacidade de adicionar exemplos de pares de perguntas/consultas, descrições de tabelas, sinónimos e etiquetas ao nível da tabela e do campo através da API.
As APIs de localização e operação são agora suportadas. As funções de gestão de identidade e de acesso DataAgentCreator e DataAgentEditor vão ter agora autorizações para APIs de operação.
Foi feita uma melhoria para o armazenamento automático de Last Published Context na camada do servidor sempre que o contexto publicado de um agente de dados é atualizado.
Os nomes a apresentar das funções de gestão de identidades e acessos foram atualizados para "Utilizador do chat sem estado do Gemini Data Analytics" e "Criador do agente de dados do Gemini Data Analytics". Para mais informações acerca das funções de gestão de identidade e de acesso usadas com a API, consulte a página de documentação Conceda funções e autorizações de gestão de identidade e de acesso da API Conversational Analytics.
A versão 1.1 do Colaboratory já está disponível.
Foram feitas atualizações ao processamento de erros para processar erros internos 500 relacionados com conversas para o chat com estado.
Foram implementadas melhores mensagens de processamento de exceções para erros de cliente 400.
Atualizações à documentação:
Agora, pode usar a nova aplicação de início rápido do Streamlit no GitHub para configurar uma demonstração da API Conversational Analytics em minutos.
A demonstração de ouro da API Conversational Analytics já está disponível no GitHub. Com a demonstração de ouro da API Conversational Analytics, pode ver exemplos para integrar a API Conversational Analytics em aplicações Web, bem como uma demonstração de produção completa em TypeScript. Este projeto destina-se apenas a fins de demonstração. Não se destina a utilização num ambiente de produção.
Arquitetura, fluxos de trabalho e funções da API Conversational Analytics: saiba mais sobre os conceitos importantes para usar a API Conversational Analytics, incluindo como funcionam os agentes de dados, os fluxos de trabalho típicos dos agentes de dados, os modos de conversa, as funções de gestão de identidades e acessos, e como criar 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 origens de dados, no estilo das visualizações e no tamanho dos conjuntos de dados.
Resolva problemas de erros da API Conversational Analytics: saiba mais acerca de potenciais problemas ou erros com a API Conversational Analytics, bem como soluções propostas.
Monitorize e faça a gestão dos custos do BigQuery para os seus agentes da API Conversational Analytics: saiba como implementar controlos de custos para os seus agentes da API Conversational Analytics.
Os métodos SetIAMPolicy e GetIAMPolicy estão disponíveis na página de documentação Vista geral da API Conversational Analytics para utilização na partilha de agentes de dados.
Está agora disponível uma nova página de documentação com respostas a Perguntas frequentes sobre a API Conversational Analytics.
Defina o contexto do agente de dados para origens de dados do BigQuery: saiba como escrever instruções do sistema para origens de dados do BigQuery.
Defina o contexto do agente de dados para origens de dados do Looker: saiba como escrever instruções do sistema para origens de dados do Looker.
15 de julho de 2025
Agora, pode convidar utilizadores para colaborarem em agentes de dados específicos atribuindo funções de IAM predefinidas. Para ver detalhes, consulte o artigo Funções e autorizações do IAM da API Conversational Analytics.
Um novo guia de práticas recomendadas ajuda a fornecer contexto empresarial e de dados eficaz aos seus agentes. Para mais informações, consulte o artigo Oriente o comportamento do agente com contexto criado.
Atualizações do SDK:
Agora, pode instalar o SDK Python a partir do Python Package Index (PyPI).
25 de junho de 2025
Atualizações da API:
As novas funções IAM predefinidas controlam o acesso para criar, gerir e interagir com agentes de dados:
geminidataanalytics.dataAgentCreatorgeminidataanalytics.dataAgentOwnergeminidataanalytics.dataAgentEditorgeminidataanalytics.dataAgentUsergeminidataanalytics.dataAgentViewergeminidataanalytics.dataAgentStatelessUser
Para ver uma lista completa de funções e respetivas autorizações, consulte o artigo Conceda funções e autorizações de IAM da API Conversational Analytics.
5 de junho de 2025
A pré-visualização privada inicial da API Conversational Analytics introduziu capacidades para criar e interagir com agentes de dados.
Os seguintes blocos de notas interativos do Colaboratory estão disponíveis para começar a usar a API REST e o SDK Python:
Atualizações da API:
O serviço de agente de dados permite-lhe criar, configurar e gerir programaticamente agentes de IA persistentes e sensíveis ao contexto com o Looker, o Looker Studio e o BigQuery.
O serviço de chat de dados permite-lhe participar em conversas com o seu agente através de vários modos de chat. Estes modos incluem um modo com estado em que a Google gere o histórico de conversas, uma opção com estado em que a sua aplicação gere a conversa e um modo sem estado em que a sua aplicação fornece o contexto completo com cada pedido.
A API suporta a análise avançada com Python e tenta novamente as consultas com falhas automaticamente.
A API Conversational Analytics (geminidataanalytics.googleapis.com) substitui a API Data QnA descontinuada (dataqna.googleapis.com). Isto inclui a migração de DataQuestionService para a nova DataChatService. Para ver instruções detalhadas sobre como atualizar os seus pedidos, consulte o guia de migração.