Saltar al contenido principal
POST
Obtener la analítica de Cascade

Descripción general

Recupera datos de analítica específicos 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.

Solicitud

service_key
string
requerido
Tu clave de servicio con permisos “Teams Read-only”
group_name
string
Filtra los resultados para mostrar solo los usuarios de un grupo específico. No se puede usar con el parámetro emails.
start_timestamp
string
Hora de inicio en formato RFC 3339 (p. ej., 2023-01-01T00:00:00Z)
end_timestamp
string
Hora de finalización en formato RFC 3339 (p. ej., 2023-12-31T23:59:59Z)
emails
array
Lista de direcciones de correo electrónico para filtrar los resultados. No se puede usar con el parámetro group_name.
ide_types
array
Filtra por tipo de IDE. Opciones disponibles:
  • "editor" - Editor de escritorio de Devin
  • "jetbrains" - Complemento de JetBrains
  • "cli" - Devin CLI
Si se omite, devuelve datos de todos los IDE.
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.
query_requests
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

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

cascade_runs

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

cascade_tool_usage

Consulta estadísticas de uso de herramientas (recuentos agregados).
Campos de la respuesta:
  • 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

queryResults
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 promptsUsed para 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)