Skip to main content
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

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
Si se omite, devuelve datos de todos los IDE.
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

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

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)