Skip to main content
POST
Obtener Analytics de Cascade

Descripción general

Obtén datos de Analytics específicos de Cascade, incluidos los renglones sugeridos/aceptados, el uso del modelo de IA, el consumo de créditos y las estadísticas de uso de herramientas.

Solicitud

string
requerido
Tu clave de servicio con permisos “Teams Read-only”
string
Filtra los resultados a usuarios de un grupo específico. No se puede usar con el parámetro emails.
string
Hora de inicio en formato RFC 3339 (p. ej., 2023-01-01T00:00:00Z)
string
Hora de finalización en formato RFC 3339 (p. ej., 2023-12-31T23:59:59Z)
array
Matriz de direcciones de correo electrónico para filtrar los resultados. No se puede usar con el parámetro group_name.
array
Filtra por tipo de IDE. Opciones disponibles:
  • "editor" - Windsurf Editor
  • "jetbrains" - JetBrains Plugin
Si se omite, devuelve datos para ambos IDE.
array
requerido
Matriz de consultas de fuentes de datos a ejecutar. Cada objeto debe contener una de las fuentes de datos admitidas.

Fuentes de datos

cascade_lines

Consulta las líneas diarias de Cascade sugeridas y aceptadas.
Campos de respuesta:
  • day - Fecha en formato RFC 3339
  • linesSuggested - Número de líneas sugeridas
  • linesAccepted - Número de líneas aceptadas

cascade_runs

Consulta el uso del modelo de IA, el consumo de créditos y los datos sobre los modos.
Campos de respuesta:
  • day - Fecha en formato RFC 3339
  • model - Nombre del modelo de IA utilizado
  • mode - Modo de Cascade (ver modos más abajo)
  • messagesSent - Número de mensajes enviados
  • cascadeId - ID único de conversación
  • promptsUsed - Créditos consumidos (en centavos de crédito)
Modos de Cascade:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Modo de escritura
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Modo de lectura
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modo heredado
  • UNKNOWN - Modo desconocido

cascade_tool_usage

Consulta las estadísticas de uso de herramientas (conteos agregados).
Campos de respuesta:
  • tool - Identificador de la herramienta (ver asignaciones de herramientas a continuación)
  • count - Número de veces que se usó la herramienta

Asignaciones de uso de herramientas

Ejemplo de solicitud

Respuesta

array
Array de resultados de consulta, uno por cada solicitud de consulta

Ejemplo de respuesta

Notas

  • La API devuelve datos sin procesar que pueden contener valores “UNKNOWN”
  • Para el análisis de métricas, realiza agregaciones por campos específicos de interés (por ejemplo, suma promptsUsed para obtener patrones de uso)
  • Los datos de modo y de prompt pueden estar divididos en múltiples entradas
  • El consumo de créditos (promptsUsed) se devuelve en centavos (100 = 1 crédito)