Passer au contenu principal
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

service_key
string
requis
Votre clé de service avec les autorisations “Teams Read-only”
group_name
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.
start_timestamp
string
Heure de début au format RFC 3339 (par ex. : 2023-01-01T00:00:00Z)
end_timestamp
string
Heure de fin au format RFC 3339 (par ex. : 2023-12-31T23:59:59Z)
emails
array
Liste d’adresses e-mail permettant de filtrer les résultats. Ne peut pas être utilisé avec le paramètre group_name.
ide_types
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"), seule la source de données cascade_runs renvoie des données. Les sources de données cascade_lines et cascade_tool_usage ne sont pas prises en charge pour Devin CLI et renverront des résultats vides.
query_requests
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

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