Ativar e usar o Interpretador de Códigos

O Interpretador de Códigos no Análises de conversação 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ódigos está disponível para agentes de dados das Análises de conversação 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ódigos oferece suporte a uma ampla variedade de análise de dados, desde cálculos e gráficos básicos até tarefas mais avançadas, como previsão de série temporal. O Interpretador de Códigos aprimora as Análises de conversação, permitindo que os usuários realizem esses tipos de análise avançada, que normalmente exigem conhecimento especializado de métodos estatísticos ou de programação avançada.

Esta página descreve como ativar o Interpretador de Códigos para uma instância do Looker e como usar o Interpretador de Códigos com um agente de dados do Análises de conversação.

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

Antes de começar

Para usar o Interpretador de Códigos, você precisa atender aos requisitos para usar o Análises de conversação no Looker, incluindo permissões para criar e usar agentes de dados:

Para usar o Interpretador de Códigos 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 Interpretador de Códigos 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 do Looker precisa seguir estas etapas para ativar o Interpretador de Códigos e disponibilizá-lo aos usuários das Análises de conversação:

No painel Admin, navegue até a seção Plataforma e selecione a página Gemini no Looker.
Em Ativação do Gemini no Looker, ative a configuração Ativar o Gemini no Looker.
Selecione Ativar recursos de trusted testers. Quando essa configuração está ativada, os usuários podem acessar os recursos do Gemini no Looker disponíveis para o Programa Trusted Tester. Essa configuração precisa estar ativada para permitir que os usuários acessem o Interpretador de Códigos com Análises de conversação.
Opcionalmente, selecione Ativar o uso de dados de trusted testers. Quando essa configuração está ativada, você concorda que seus dados sejam usados pelo Google, conforme descrito nos termos do Google Cloud Gemini no Programa Trusted Tester. Essa configuração só pode ser ativada quando a configuração Ativar recursos de trusted testers também estiver ativada. Essa configuração é ativada automaticamente quando a configuração Ativar recursos de trusted testers está ativada.
Selecione Ativar o Interpretador de Códigos. Quando essa configuração está ativada, os usuários podem acessar o Interpretador de Códigos nos agentes de dados do Análises de conversação. Essa configuração só pode ser ativada quando a configuração Ativar recursos de trusted testers também estiver ativada.

A configuração Ativar o Interpretador de Códigos 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 instância do Looker (original) antes de você atualizar a instância para o Looker 25.8.
Um administrador do Looker atualizou sua instância para o Looker 25.8 no primeiro dia de 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ódigos e disponibilizá-lo aos usuários das Análises de conversação:

Navegue até o painel Admin > seção Plataforma > página Gemini no Looker.
Ative o Interpretador de Códigos.

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

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

Usar o Interpretador de Códigos com um agente de dados de Análises de conversação

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

Você pode ativar o Interpretador de Códigos para um agente de dados ao criá-lo ou editá-lo. Ative o Interpretador de Códigos ativando a opção Ativar análises avançadas.

Limitações conhecidas

O Interpretador de Códigos usa o Python para resolver problemas. Como o Python é mais flexível do que as linguagens de consulta estruturadas, as respostas do Interpretador de Códigos podem ter mais variabilidade do que as respostas da experiência principal de Análises de conversação.
Para dados do Looker, as Análises de conversação podem retornar até 5.000 linhas por consulta.
O Interpretador de Códigos oferece suporte apenas a estas bibliotecas Python.
Os seguintes tipos de gráficos de visualização não são compatíveis com as respostas do Interpretador de Códigos:
- Maps

Esse recurso está na versão pré-GA. Para receber suporte com erros, resultados inesperados, feedback ou para solicitar suporte para outras bibliotecas Python, envie um e-mail para conversational-analytics-feedback@google.com.

Para informações sobre outras limitações, consulte a documentação sobre limitações conhecidas nas Análises de conversação.

Bibliotecas Python compatíveis

Mostrar bibliotecas Python compatíveis

O Interpretador de Códigos oferece suporte às 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 de análise avançada do Python permitem que os agentes de dados das Análises de conversação respondam a uma variedade maior de perguntas, além de tipos padrão de perguntas compatíveis. 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 vendas do ano passado?
Identifique outliers nos meus dados de vendas para ajudar a identificar produtos ou regiões com desempenho particularmente bom ou ruim.
Realize uma análise de coorte para entender a retenção de clientes.
Meus produtos de maior margem também são os mais populares? Use essa resposta para dar uma sugestão sobre como otimizar meu mix de produtos.
Qual é a taxa de crescimento anual composta (CAGR, na sigla em inglês) das vendas por categoria dos produtos nos últimos três anos?
Mostre a CAGR como um gráfico de barras com a categoria dos produtos no eixo X e a CAGR no eixo Y.