Obtener la analítica de Cascade
API de analítica
Obtener la analítica de Cascade
Consulta métricas de uso específicas de Cascade, incluidas las líneas sugeridas/aceptadas, el uso del modelo, el consumo de créditos y las estadísticas de uso de herramientas.
POST
Obtener la analítica de Cascade
Descripción general
Solicitud
Tu clave de servicio con permisos “Teams Read-only”
Filtra los resultados para mostrar solo los usuarios de un grupo específico. No se puede usar con el parámetro
emails.Hora de inicio en formato RFC 3339 (p. ej.,
2023-01-01T00:00:00Z)Hora de finalización en formato RFC 3339 (p. ej.,
2023-12-31T23:59:59Z)Lista de direcciones de correo electrónico para filtrar los resultados. No se puede usar con el parámetro
group_name.Filtra por tipo de IDE. Opciones disponibles:
"editor"- Editor de escritorio de Devin"jetbrains"- Complemento de JetBrains"cli"- Devin CLI
Al filtrar por Devin CLI (
"cli"), solo cascade_runs devuelve datos. Las fuentes de datos cascade_lines y cascade_tool_usage no son compatibles con Devin CLI y devolverán resultados vacíos.Lista de consultas de fuentes de datos que se ejecutarán. Cada objeto debe contener una de las fuentes de datos compatibles.
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 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 los mapeos de herramientas a continuación)count- Número de veces que se usó la herramienta
Asignaciones de uso de herramientas
Solicitud de ejemplo
Respuesta
Array de resultados de consultas, uno por cada solicitud de consulta
Ejemplo de respuesta
Notas
- La API devuelve datos en bruto que pueden contener valores “UNKNOWN”
- Para el análisis de métricas, agrupa por los campos específicos de interés (p. ej., suma
promptsUsedpara los 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)

