Skip to main content
POST
Obtenir l’analyse de Cascade

Vue d’ensemble

Récupérez des données d’analyse propres à Cascade, notamment le nombre de lignes suggérées et acceptées, l’utilisation des modèles, la consommation de crédits et les statistiques d’utilisation des outils.

Requête

string
requis
Votre clé de service avec les autorisations “Teams Read-only”
string
Filtre les résultats pour n’inclure que les utilisateurs d’un groupe spécifique. Ne peut pas être utilisé avec le paramètre emails.
string
Heure de début au format RFC 3339 (par ex. : 2023-01-01T00:00:00Z)
string
Heure de fin au format RFC 3339 (par ex. : 2023-12-31T23:59:59Z)
array
Liste d’adresses e-mail permettant de filtrer les résultats. Ne peut pas être utilisé avec le paramètre group_name.
array
Filtre par type d’IDE. Options disponibles :
  • "editor" - éditeur de bureau Devin
  • "jetbrains" - plugin JetBrains
  • "cli" - Devin CLI
Si omis, renvoie les données pour tous les IDE.
Lors du filtrage par Devin CLI ("cli"), le champ mode de cascade_runs n’est pas renseigné. cascade_lines et cascade_tool_usage couvrent l’activité de Devin CLI et de Devin Local, mais incluent uniquement les données enregistrées depuis que ces agents ont commencé à les remonter.
array
requis
Liste des requêtes de source de données à exécuter. Chaque objet doit contenir l’une des sources de données prises en charge.

Sources de données

cascade_lines

Interroger les lignes Cascade suggérées et acceptées au quotidien.
Champs de la réponse :
  • day - Date au format RFC 3339
  • linesSuggested - Nombre de lignes suggérées
  • linesAccepted - Nombre de lignes acceptées

cascade_runs

Permet d’interroger les données d’utilisation des modèles, de consommation de crédits et de mode.
Champs de la réponse :
  • day - Date au format RFC 3339
  • model - Nom du modèle utilisé
  • mode - Mode Cascade (voir les modes ci-dessous)
  • messagesSent - Nombre de messages envoyés
  • cascadeId - Identifiant unique de conversation
  • promptsUsed - Crédits consommés (en centimes)
Modes Cascade :
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Mode écriture
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Mode lecture
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Mode ancien
  • UNKNOWN - Mode inconnu

cascade_tool_usage

Interroger les statistiques d’utilisation des outils (totaux agrégés).
Champs de réponse :
  • tool - Identifiant de l’outil (voir les correspondances des outils ci-dessous)
  • count - Nombre d’utilisations de l’outil

Correspondances d’utilisation des outils

Exemple de requête

Réponse

array
Tableau des résultats de requête, un pour chaque requête

Exemple de réponse

Remarques

  • L’API renvoie des données brutes pouvant contenir des valeurs “UNKNOWN”
  • Pour l’analyse des métriques, agrégez les données selon les champs spécifiques pertinents (p. ex., additionnez promptsUsed pour analyser les tendances d’utilisation)
  • Les données de mode et de prompt peuvent être réparties entre plusieurs entrées
  • La consommation de crédits (promptsUsed) est renvoyée en centimes (100 = 1 crédit)