Obtener Analytics de Cascade
Analytics API
Obtener Analytics de Cascade
Consultar métricas de uso específicas de Cascade, incluidas las líneas sugeridas/aceptadas, el uso del modelo de IA, el consumo de créditos y las 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
Array de direcciones de correo electrónico para filtrar resultados. No se puede usar con el parámetro
group_name.array
Filtrar por tipo de IDE. Opciones disponibles:
"editor"- Windsurf Editor"jetbrains"- JetBrains Plugin
array
requerido
Array de consultas de fuentes de datos a ejecutar. Cada objeto debe contener una de las fuentes de datos compatibles.
Orígenes 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 (consulta los modos a continuación)messagesSent- Número de mensajes enviadoscascadeId- ID único de la conversaciónpromptsUsed- Créditos consumidos (en centavos)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Modo de escrituraCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Modo de solo lecturaCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Modo heredadoUNKNOWN- Modo desconocido
cascade_tool_usage
tool- Identificador de la herramienta (consulta las asignaciones de herramientas a continuación)count- Número de veces que se utilizó 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, agrupa por campos específicos de interés (por ejemplo, suma
promptsUsedpara analizar patrones de uso) - Los datos de modo y de prompt pueden estar divididos en varias entradas
- El consumo de créditos (
promptsUsed) se devuelve en centavos (100 = 1 crédito)