Obtener Analytics de Cascade
Analytics API
Obtener Analytics de Cascade
Consultar métricas y datos de uso específicos de Cascade, incluidas líneas sugeridas/aceptadas, uso de modelos de IA, consumo de créditos y estadísticas de uso de herramientas.
POST
Obtener Analytics de Cascade
Descripción general
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
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
day- Fecha en formato RFC 3339linesSuggested- Número de líneas sugeridaslinesAccepted- Número de líneas aceptadas
cascade_runs
day- Fecha en formato RFC 3339model- Nombre del modelo de IA utilizadomode- Modo de Cascade (ver modos más abajo)messagesSent- Número de mensajes enviadoscascadeId- ID único de conversaciónpromptsUsed- Créditos consumidos (en centavos de crédito)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Modo de escrituraCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Modo de lecturaCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Modo heredadoUNKNOWN- Modo desconocido
cascade_tool_usage
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
promptsUsedpara 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)