Ative e use o interpretador de código

O intérprete de código na análise conversacional traduz as suas perguntas em linguagem natural em código Python e executa esse código para fornecer análises e visualizações avançadas. O Code Interpreter está disponível para agentes de dados de estatísticas de conversação nas instâncias do Looker (original) e do Looker (Google Cloud core).

Ao contrário das experiências de BI baseadas em SQL padrão, o intérprete de código suporta uma grande variedade de estatísticas de dados, desde cálculos básicos e gráficos a tarefas mais avançadas, como a previsão de séries cronológicas. O Code Interpreter melhora a análise conversacional, permitindo que os utilizadores realizem estes tipos de análise avançada, que, de outra forma, exigiria normalmente conhecimentos especializados de programação avançada ou métodos estatísticos.

Esta página descreve como ativar o intérprete de código para uma instância do Looker e como usar o intérprete de código com um agente de dados das estatísticas de conversas.

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

Antes de começar

Para usar o intérprete de código, tem de cumprir os requisitos para usar a análise conversacional no Looker, incluindo autorizações para criar e usar agentes de dados:

  • Para usar o intérprete de código com um agente de dados de estatísticas de conversas numa instância do Looker (original), a sua instância tem de ter o Looker 25.18 ou posterior.

Ative o interpretador de código

Esta secção descreve como ativar o intérprete de código nas seguintes plataformas:

Ative o interpretador de código no Looker (original)

Na instância do Looker (original), um administrador do Looker tem de seguir estes passos para ativar o intérprete de código e disponibilizá-lo aos utilizadores da análise conversacional:

  1. No painel Administração, navegue para a secção Plataforma e selecione a página Gemini no Looker.
  2. Em Ativação do Gemini no Looker, ative a definição Ativar o Gemini no Looker.
  3. Selecione Ativar funcionalidades do testador fidedigno. Quando esta definição está ativada, os utilizadores podem aceder às capacidades de testador fidedigno do Gemini no Looker. Esta definição tem de estar ativada para permitir que os utilizadores acedam ao intérprete de código com as estatísticas de conversas.
  4. Opcionalmente, selecione Ativar utilização de dados do testador fidedigno. Quando esta definição está ativada, consente que os seus dados sejam utilizados pela Google conforme descrito nos termos do programa de testadores fidedignos do Google Cloud Gemini. Esta definição só pode ser ativada quando a definição Ativar funcionalidades do testador fidedigno está ativada. Esta definição é ativada automaticamente quando a definição Ativar funcionalidades do testador fidedigno está ativada.
  5. Selecione Ativar interpretador de código. Quando esta definição está ativada, os utilizadores podem aceder ao intérprete de código nos agentes de dados das estatísticas de conversas. Esta definição só pode ser ativada quando a definição Ativar funcionalidades do testador fidedigno também está ativada.

A definição Ativar interpretador de código foi ativada por predefinição para instâncias do Looker (original) que cumpriram os seguintes critérios:

  • Um administrador do Looker ativou as definições Ativar o Gemini no Looker e Ativar funcionalidades de testador fidedigno na sua instância do Looker (original) antes de atualizar a instância para o Looker 25.8.
  • Um administrador do Looker atualizou a sua instância para o Looker 25.8 no primeiro dia dos implementações de lançamentos.

Ative o interpretador de código no Looker (Google Cloud Core)

Na instância do Looker (Google Cloud core), um administrador do Looker tem de seguir estes passos para ativar o intérprete de código e disponibilizá-lo aos utilizadores da análise conversacional:

  1. Navegue para o painel Administração > secção Plataforma > página Gemini no Looker.
  2. Ative o intérprete de código.

O intérprete de código está desativado por predefinição, mesmo quando o Gemini no Looker está ativado nas definições da instância do Looker (Google Cloud core) na Google Cloud consola.

Um administrador do Looker tem de conceder a autorização gemini_in_looker aos utilizadores antes de poderem usar o intérprete de código.

Use o interpretador de código com um agente de dados das estatísticas de conversas

Quando o intérprete de código está ativado para um determinado agente de dados, as capacidades de estatísticas melhoradas estão disponíveis para todas as conversas com esse agente.

Pode ativar o intérprete de código para um agente de dados quando o criar ou editar. Ative o interpretador de código ativando a opção Ativar estatísticas avançadas.

Limitações conhecidas

  • O Interpretador de código usa o Python para resolver problemas. Uma vez que o Python é mais flexível do que as linguagens de consulta estruturada, as respostas do intérprete de código podem ter mais variabilidade do que as respostas da experiência de análise conversacional principal.
  • Para dados do Looker, as Estatísticas de conversas podem devolver um máximo de 5000 linhas por consulta.
  • O Interpretador de código suporta estas bibliotecas Python. Para pedir apoio técnico para bibliotecas Python adicionais, envie um email para conversational-analytics-feedback@google.com.
  • Os seguintes tipos de gráficos de visualização não são suportados nas respostas do Interpretador de código:
    • Maps

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

Bibliotecas Python suportadas

Mostrar bibliotecas Python suportadas

O Interpretador de código suporta 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 ativa o interpretador de código, as capacidades analíticas avançadas do Python permitem que os agentes de dados das estatísticas de conversas respondam a uma gama mais ampla de perguntas, além dos tipos padrão de perguntas suportadas. Por exemplo:

  • Pode explicar os principais fatores que impulsionam as vendas com base nos meus dados?
  • Qual é o valor do cliente para cada um dos meus segmentos de clientes, tendo em conta a frequência de compra média e o valor de encomenda médio?
  • Como se comparam as vendas deste ano com as vendas do ano passado?
  • Identificar valores atípicos nos meus dados de vendas para ajudar a identificar produtos ou regiões com um desempenho particularmente bom ou mau.
  • Faça uma análise da coorte para compreender a retenção de clientes.
  • Os meus produtos com a margem mais elevada são também os produtos mais populares? Usa esta resposta para dar uma sugestão sobre como otimizar a minha combinação de produtos.
  • Qual é a taxa de crescimento anual composta (CAGR) das vendas por categoria de produtos nos últimos 3 anos?
  • Mostra a TCAC como um gráfico de barras com a categoria do produto no eixo x e a TCAC no eixo y.