Ativar e usar o Interpretador de Códigos

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 assistência limitada. Para mais informações, consulte as descrições das fases de lançamento.

O Intérprete de código no Conversational Analytics traduz suas perguntas em linguagem natural para código Python e executa esse código para fornecer análises e visualizações avançadas. O interpretador de código está disponível para agentes de dados da análise de conversas nas instâncias do Looker (original) e do Looker (Google Cloud Core).

Ao contrário das experiências de BI padrão com tecnologia SQL, o interpretador de código oferece suporte a uma ampla variedade de análises de dados, desde cálculos e gráficos básicos até tarefas mais avançadas, como previsão de série temporal. O Code Interpreter aprimora a Análise de Conversação ao permitir que os usuários façam esses tipos de análise avançada, que normalmente exigem conhecimento especializado de programação avançada ou métodos estatísticos.

Nesta página, descrevemos como ativar o Code Interpreter para uma instância do Looker e como usar o Code Interpreter com um agente de dados do Conversational Analytics.

Saiba como e quando o Gemini para Google Cloud usa seus dados.

Como uma tecnologia em estágio inicial, os produtos do Gemini para Google Cloud podem gerar uma saída plausível, mas que é factualmente incorreta. Recomendamos que você valide todas as saídas dos produtos do Gemini para Google Cloud antes de usá-las. Para mais informações, consulte Gemini para Google Cloud e IA responsável.

Antes de começar

Para usar o Code Interpreter, você precisa atender aos requisitos de uso do recurso Análises de conversação no Looker, incluindo permissões para criar e usar agentes de dados:

• Para usar o Interpretador de código com um agente de dados das Análises de conversação em uma instância do Looker (original), sua instância precisa estar no Looker 25.18 ou mais recente.

Ativar o Interpretador de Códigos

Esta seção descreve como ativar o Code Interpreter nas seguintes plataformas:

• Looker (original)
• Looker (Google Cloud Core)

Ativar o Interpretador de Códigos no Looker (original)

Na instância do Looker (original), um administrador precisa seguir estas etapas para ativar o Interpretador de código e disponibilizá-lo aos usuários das Análises de conversação:

1. No painel Administrador, acesse a seção Plataforma e selecione a página Gemini no Looker.
2. Em Ativação do Gemini no Looker, ative a configuração Ativar o Gemini no Looker.
3. Selecione Ativar recursos do Trusted Tester. Quando essa configuração está ativada, os usuários podem acessar os recursos do Trusted Tester do Gemini no Looker. Essa configuração precisa estar ativada para permitir que os usuários acessem o Interpretador de Códigos com o Conversational Analytics.
4. Se quiser, selecione Ativar o uso de dados do Trusted Tester. Quando essa configuração está ativada, você concorda que seus dados sejam usados pelo Google, conforme descrito nos termos do Programa Trusted Tester do Gemini para Google Cloud . Essa configuração só pode ser ativada quando a opção Ativar recursos de trusted testers está ativada. Essa configuração é ativada automaticamente quando a opção Ativar recursos do Trusted Tester está ativada.
5. Selecione Ativar o Interpretador de Códigos. Quando essa configuração está ativada, os usuários podem acessar o interpretador de código nos agentes de dados do Conversational Analytics. Essa configuração só pode ser ativada quando a opção Ativar recursos do Trusted Tester também está ativada.

A configuração Ativar o Interpretador de Código foi ativada por padrão para instâncias do Looker (original) que atendiam aos seguintes critérios:

• Um administrador do Looker ativou as configurações Ativar o Gemini no Looker e Ativar recursos de trusted testers na sua instância do Looker (original) antes de você atualizar para o Looker 25.8.
• Um administrador do Looker atualizou sua instância para o Looker 25.8 no primeiro dia das implantações de lançamento.

Ativar o Interpretador de Códigos no Looker (Google Cloud Core)

Na instância do Looker (Google Cloud Core), um administrador do Looker precisa seguir estas etapas para ativar o Interpretador de código e disponibilizá-lo aos usuários da Análise de conversas:

1. Acesse o painel Administrador > seção Plataforma > página Gemini no Looker.
2. Ative o Interpretador de código.

O Code Interpreter fica desativado por padrão, mesmo quando o Gemini no Looker está ativado nas configurações da instância do Looker (Google Cloud Core) no console Google Cloud .

Um administrador do Looker precisa conceder a permissão gemini_in_looker aos usuários antes que eles possam usar o Interpretador de código.

Usar o Interpretador de Códigos com um agente de dados do Conversational Analytics

Quando o Interpretador de Códigos é ativado para um determinado agente de dados, os recursos de análise avançada ficam disponíveis para todas as conversas com esse agente.

É possível ativar o Interpretador de código para um agente de dados ao criar ou editar. Ative o Interpretador de Códigos ativando a opção Ativar as análises avançadas.

Limitações conhecidas

• O Code Interpreter usa Python para resolver problemas. Como o Python é mais flexível do que as linguagens de consulta estruturadas, as respostas do Interpretador de código podem ter mais variabilidade do que as respostas da experiência principal do Conversational Analytics.
• Para dados do Looker, o Conversational Analytics pode retornar até 5.000 linhas por consulta.
• O interpretador de código é compatível com estas bibliotecas Python. Para solicitar suporte para outras bibliotecas do Python, envie um e-mail para [e-mail].
• Os seguintes tipos de gráficos de visualização não são compatíveis com as respostas do Interpretador de código:
  • Maps

Para informações sobre outras limitações, consulte a documentação sobre limitações conhecidas no Conversational Analytics.

Bibliotecas Python compatíveis

Mostrar bibliotecas Python compatíveis

O Code Interpreter é compatível com as seguintes bibliotecas Python:

• altair
• attrs
• chess
• contourpy
• cycler
• entrypoints
• fonttools
• fpdf
• geopandas
• imageio
• jinja2
• joblib
• jsonschema
• jsonschema-specifications
• kiwisolver
• lxml
• markupsafe
• matplotlib
• mpmath
• numexpr
• numpy
• opencv-python
• openpyxl
• packaging
• pandas
• patsy
• pdfminer-six
• pillow
• plotly
• protobuf
• pylatex
• pyparsing
• PyPDF2
• python-dateutil
• python-docx
• python-pptx
• pytz
• referencing
• reportlab
• rpds-py
• scikit-image
• scikit-learn
• scipy
• seaborn
• six
• statsmodels
• striprtf
• sympy
• tabulate
• tensorflow
• threadpoolctl
• toolz
• torch
• tzdata
• xlrd

Perguntas sugeridas

Quando você ativa o Interpretador de Códigos, os recursos analíticos avançados do Python permitem que os agentes de dados das Análises de conversação respondam a uma variedade maior de perguntas, além dos tipos padrão de perguntas aceitas. Exemplo:

• Você pode explicar os principais fatores de vendas com base nos meus dados?
• Qual é o valor da vida útil de cada um dos meus segmentos de clientes, considerando a frequência média de compra e o valor médio do pedido?
• Como as vendas deste ano se comparam às do ano passado?
• Identificar outliers nos meus dados de vendas para ajudar a identificar produtos ou regiões com desempenho muito bom ou muito ruim.
• Faça uma análise de coorte para entender a retenção de clientes.
• Meus produtos com maior margem também são os mais procurados? Use esta resposta para dar uma sugestão de como otimizar meu mix de produtos.
• Qual é a taxa de crescimento anual composta (CAGR, na sigla em inglês) das vendas por categoria de produto nos últimos três anos?
• Mostre a CAGR como um gráfico de barras com a categoria de produto no eixo x e a CAGR no eixo y.

Recursos relacionados

• Visão geral da Análise de conversas
• Conversar com dados do Looker