Skip to main content
POST
Consulta personalizada de Analytics

Descripción general

La Analytics API personalizada ofrece capacidades de consulta flexibles para datos de Autocomplete, Chat y Command, con selections, filtros, aggregations y criterios de ordenación personalizables.

Request

string
requerido
Tu clave de servicio con permisos “Analytics Read”
string
Filtra los resultados para usuarios de un grupo específico (opcional)
array
requerido
Array de objetos de solicitud de consulta que definen los datos a recuperar

Estructura de la solicitud de consulta

Cada objeto de solicitud de consulta contiene:
  • data_source (obligatorio): Fuente de datos a consultar
  • selections (obligatorio): Arreglo de selecciones de campos para recuperar
  • filters (opcional): Arreglo de filtros a aplicar
  • aggregations (opcional): Arreglo de aggregations para agrupar

Selections

Las selections definen qué campos recuperar y cómo agregarlos.
  • field (obligatorio): Nombre del campo a seleccionar
  • name (opcional): Alias del campo
  • aggregation_function (opcional): Función de agregación que se aplicará

Ejemplo de selección

Filtros

Los filtros restringen los datos a los elementos que cumplen criterios específicos.
  • name (obligatorio): Nombre del campo por el que filtrar
  • filter (obligatorio): Operación de filtro
  • value (obligatorio): Valor a comparar

Ejemplo de filtrado

Aggregations

Las aggregations agrupan los datos según los criterios especificados.
  • field (obligatorio): Nombre del campo por el que agrupar
  • name (obligatorio): Alias para el campo de agregación

Ejemplo de agregación

Campos disponibles

Datos de usuario

Todos los datos de usuario se agregan por usuario y por hora.

Datos de Chat

Los datos de Chat están separados de los datos de Cascade y representan el uso de nuestros plugins heredados, no agentivos
Todos los datos de Chat corresponden a respuestas del modelo de IA de chat, no a preguntas del usuario.

Tipos de intención de Chat

  • CHAT_INTENT_GENERIC - Chat normal
  • CHAT_INTENT_FUNCTION_EXPLAIN - Indicador Code Lens de explicación de función
  • CHAT_INTENT_FUNCTION_DOCSTRING - Indicador Code Lens de docstring de función
  • CHAT_INTENT_FUNCTION_REFACTOR - Indicador Code Lens de refactorización de función
  • CHAT_INTENT_CODE_BLOCK_EXPLAIN - Indicador Code Lens de explicación de bloque de código
  • CHAT_INTENT_CODE_BLOCK_REFACTOR - Indicador Code Lens de refactorización de bloque de código
  • CHAT_INTENT_PROBLEM_EXPLAIN - Indicador Code Lens de explicación de problema
  • CHAT_INTENT_FUNCTION_UNIT_TESTS - Indicador Code Lens de pruebas unitarias de función

Datos de Command

Los datos de Command incluyen todos los comandos, incluidos los rechazados. Usa el campo accepted para filtrar únicamente los comandos aceptados.

Fuentes de Command

  • COMMAND_REQUEST_SOURCE_LINE_HINT_CODE_LENS
  • COMMAND_REQUEST_SOURCE_DEFAULT - Uso típico de Command
  • COMMAND_REQUEST_SOURCE_RIGHT_CLICK_REFACTOR
  • COMMAND_REQUEST_SOURCE_FUNCTION_CODE_LENS
  • COMMAND_REQUEST_SOURCE_FOLLOWUP
  • COMMAND_REQUEST_SOURCE_CLASS_CODE_LENS
  • COMMAND_REQUEST_SOURCE_PLAN
  • COMMAND_REQUEST_SOURCE_SELECTION_HINT_CODE_LENS

Fuentes del proveedor

  • PROVIDER_SOURCE_COMMAND_GENERATE - Modo generación
  • PROVIDER_SOURCE_COMMAND_EDIT - Modo edición

Datos de PCW

Datos del porcentaje de código escrito con seguimiento separado de las contribuciones de Autocomplete y Command.

Filtros de PCW

Para filtrar por fecha en las consultas de PCW, utiliza start_timestamp y end_timestamp en el cuerpo principal de la solicitud.

Ejemplos de solicitudes

Ejemplo de datos del usuario

Ejemplo de datos de Chat

Ejemplo de datos de Command

Ejemplo de datos de PCW

Respuesta

array
Array de resultados de consulta, uno por cada solicitud de consulta
array
Array de elementos de resultado
object
Objeto que contiene los campos seleccionados y sus valores

Ejemplos de respuestas

Respuesta de datos del usuario

Respuesta de datos de Chat

Respuesta de datos de Command

Respuesta de datos de PCW

Notas importantes

  • PCW (Percent Code Written) presenta una gran variabilidad dentro de un mismo día o entre usuarios; agrégalo por semanas para obtener información más útil
  • Todos los campos de selección deben tener funciones de agregación o ninguno debe tenerlas (no se pueden mezclar)
  • Los campos con el patrón “distinct_*” no se pueden usar en aggregations
  • Los alias de campos deben ser únicos en todas las selections y aggregations
  • Si no se especifica ninguna función de agregación, el valor predeterminado es UNSPECIFIED