Obtenir l’analyse de Cascade
API d’analyse
Obtenir l’analyse de Cascade
Interrogez les métriques d’utilisation propres à Cascade, notamment les lignes suggérées/acceptées, l’utilisation des modèles, la consommation de crédits et les statistiques d’utilisation des outils.
POST
Obtenir l’analyse de Cascade
Vue d’ensemble
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
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
day- Date au format RFC 3339linesSuggested- Nombre de lignes suggéréeslinesAccepted- Nombre de lignes acceptées
cascade_runs
day- Date au format RFC 3339model- Nom du modèle utilisémode- Mode Cascade (voir les modes ci-dessous)messagesSent- Nombre de messages envoyéscascadeId- Identifiant unique de conversationpromptsUsed- Crédits consommés (en centimes)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Mode écritureCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Mode lectureCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Mode ancienUNKNOWN- Mode inconnu
cascade_tool_usage
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
promptsUsedpour 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)

