Cómo habilitar y usar el intérprete de código

El intérprete de código de Conversational Analytics traduce tus preguntas en lenguaje natural a código de Python y ejecuta ese código para proporcionar análisis y visualizaciones avanzados. El intérprete de código está disponible para los agentes de datos de Conversational Analytics en las instancias de Looker (original) y Looker (Google Cloud Core).

A diferencia de las experiencias de IE potenciadas por SQL estándar, el intérprete de código admite una amplia variedad de análisis de datos, desde cálculos y gráficos básicos hasta tareas más avanzadas, como la previsión de series temporales. El intérprete de código mejora Conversational Analytics, ya que permite a los usuarios realizar estos tipos de análisis avanzados, que, de otro modo, requerirían conocimientos especializados de métodos estadísticos o de codificación avanzados.

En esta página, se describe cómo habilitar el intérprete de código para una instancia de Looker y cómo usarlo con un agente de datos de Conversational Analytics.

Descubre cómo y cuándo Gemini para Google Cloud usa tus datos.

Antes de comenzar

Para usar el intérprete de código, debes cumplir con los requisitos para usar Conversational Analytics en Looker, incluidos los permisos para crear y usar agentes de datos:

  • Para usar el intérprete de código con un agente de datos de Conversational Analytics en una instancia de Looker (original), tu instancia debe tener la versión 25.18 de Looker o una posterior.

Habilita el intérprete de código

En esta sección, se describe cómo habilitar el intérprete de código en las siguientes plataformas:

Habilita el intérprete de código en Looker (original)

En la instancia de Looker (original), un administrador de Looker debe seguir estos pasos para habilitar el intérprete de código y ponerlo a disposición de los usuarios de Conversational Analytics:

  1. En el panel Administrador, navega a la sección Plataforma y selecciona la página Gemini en Looker.
  2. En Habilitación de Gemini en Looker, activa el parámetro de configuración Habilitar Gemini en Looker.
  3. Selecciona Habilitar funciones del verificador de confianza. Cuando se habilita este parámetro de configuración, los usuarios pueden acceder a las funciones de Verificador de confianza de Gemini en Looker. Se debe habilitar este parámetro de configuración para permitir que los usuarios accedan al intérprete de código con Conversational Analytics.
  4. De manera opcional, selecciona Habilitar el uso de datos del verificador de confianza. Cuando se habilita este parámetro de configuración, das tu consentimiento para que Google use tus datos como se describe en las condiciones del Programa de verificadores de confianza de Gemini para Google Cloud . Este parámetro de configuración solo se puede habilitar cuando el parámetro de configuración Habilitar las funciones de Verificador de confianza está habilitado. Este parámetro de configuración se habilita automáticamente cuando se habilita el parámetro de configuración Habilitar las funciones de Verificador de confianza.
  5. Selecciona Habilitar el intérprete de código. Cuando este parámetro de configuración está habilitado, los usuarios pueden acceder al intérprete de código en los agentes de datos de Conversational Analytics. Este parámetro de configuración solo se puede habilitar cuando también está habilitado el parámetro de configuración Habilitar las funciones de Verificador de confianza.

El parámetro de configuración Habilitar el intérprete de código estaba habilitado de forma predeterminada para las instancias de Looker (original) que cumplían con los siguientes criterios:

  • Un administrador de Looker activó los parámetros de configuración Habilitar Gemini en Looker y Habilitar funciones del verificador de confianza en tu instancia de Looker (original) antes de que actualizaras tu instancia a Looker 25.8.
  • Un administrador de Looker actualizó tu instancia a Looker 25.8 el primer día de las implementaciones de la versión.

Habilita el intérprete de código en Looker (Google Cloud Core)

En la instancia de Looker (Google Cloud Core), un administrador de Looker debe seguir estos pasos para habilitar el intérprete de código y que esté disponible para los usuarios de Conversational Analytics:

  1. Navega al panel de Administrador > sección Plataforma > página Gemini en Looker.
  2. Habilita el Intérprete de código.

El intérprete de código está inhabilitado de forma predeterminada, incluso cuando Gemini en Looker está habilitado en la configuración de la instancia de Looker (Google Cloud Core) en la consola de Google Cloud .

Un administrador de Looker debe otorgar el permiso gemini_in_looker a los usuarios antes de que puedan usar el intérprete de código.

Usa el intérprete de código con un agente de datos de Conversational Analytics

Cuando el intérprete de código está habilitado para un agente de datos determinado, las capacidades de análisis mejoradas están disponibles para todas las conversaciones con ese agente.

Puedes habilitar el intérprete de código para un agente de datos cuando lo crees o edites. Habilita el intérprete de código activando la opción Habilitar estadísticas avanzadas.

Limitaciones conocidas

  • El intérprete de código usa Python para resolver problemas. Dado que Python es más flexible que los lenguajes de consultas estructuradas, las respuestas del intérprete de código pueden tener más variabilidad que las respuestas de la experiencia principal de Conversational Analytics.
  • En el caso de los datos de Looker, Conversational Analytics puede devolver un máximo de 5,000 filas por consulta.
  • El intérprete de código admite estas bibliotecas de Python. Para solicitar asistencia para bibliotecas de Python adicionales, envía un correo electrónico a conversational-analytics-feedback@google.com.
  • Los siguientes tipos de gráficos de visualización no se admiten en las respuestas del intérprete de código:
    • Maps

Para obtener información sobre otras limitaciones, consulta la documentación sobre las limitaciones conocidas en Conversational Analytics.

Bibliotecas de Python compatibles

Mostrar las bibliotecas de Python compatibles

El intérprete de código admite las siguientes bibliotecas de 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

Preguntas sugeridas

Cuando habilitas el intérprete de código, las capacidades analíticas avanzadas de Python permiten que los agentes de datos de Estadísticas conversacionales respondan una gama más amplia de preguntas, además de los tipos estándar de preguntas admitidas. Por ejemplo:

  • ¿Puedes explicar los factores clave de las ventas según mis datos?
  • ¿Cuál es el valor del ciclo de vida de cada uno de mis segmentos de clientes, teniendo en cuenta la frecuencia de compra promedio y el valor promedio del pedido?
  • ¿Cómo se comparan las ventas de este año con las del año pasado?
  • Identificar valores atípicos en mis datos de ventas para ayudar a identificar los productos o las regiones con un rendimiento particularmente bueno o malo
  • Realiza un análisis de cohortes para comprender la retención de clientes.
  • ¿Mis productos con el margen de ganancias más alto también son los más populares? Usa esta respuesta para sugerir cómo optimizar mi combinación de productos.
  • ¿Cuál es la tasa de crecimiento anual compuesta (CAGR) de las ventas por categoría de producto en los últimos 3 años?
  • Muestra el CAGR como un gráfico de barras con la categoría de producto en el eje X y el CAGR en el eje Y.