Ativar e usar o interpretador de códigos

O Interpretador de Códigos na Análise Conversacional 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 da Análise Conversacional 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álises 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 a Análise Conversacional, 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.

Nesta página, descrevemos 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 da Análise Conversacional.

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 a Análise Conversacional no Looker, incluindo permissões para criar e usar agentes de dados:

  • Para usar o Interpretador de Códigos com um agente de dados da Análise Conversacional 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:

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 da Análise Conversacional:

  1. No painel Admin, navegue até 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 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 a Análise Conversacional.
  4. 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.
  5. 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 da Análise Conversacional. 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 da Análise Conversacional:

  1. Navegue até o painel Admin > seção Plataforma > página Gemini no Looker.
  2. 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 da Análise Conversacional

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 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 da Análise Conversacional.
  • Para dados do Looker, a Análise Conversacional pode 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 aceitos nas respostas do Interpretador de Códigos:
    • Maps

Esse recurso está na fase 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 na Análise Conversacional.

Bibliotecas Python aceitas

Mostrar bibliotecas Python aceitas

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 analíticos avançados do Python permitem que os agentes de dados da Análise Conversacional respondam a uma variedade maior de perguntas, além de os 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 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 com maior margem também são os mais populares? Use essa 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 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.