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
string
requerido
Tu clave de servicio con permisos “Teams Read-only”
string
Filtra los resultados para mostrar solo los 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
Lista 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"- Editor de escritorio de Devin"jetbrains"- Complemento de JetBrains"cli"- Devin CLI
Al filtrar por Devin CLI (
"cli"), el campo mode de cascade_runs no se rellena. cascade_lines y cascade_tool_usage cubren la actividad de Devin CLI y Devin Local, pero solo incluyen datos registrados después de que esos agentes comenzaran a reportarla.array
requerido
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
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)

