Obtenir les Analytics Cascade
Analytics API
Obtenir les Analytics Cascade
Interroger les métriques et les données d’utilisation propres à Cascade, notamment les lignes suggérées/acceptées, l’utilisation des modèles d’IA, la consommation de crédits et les statistiques d’utilisation des outils.
POST
Obtenir les Analytics Cascade
Vue d’ensemble
Requête
string
requis
Votre clé de service avec les autorisations « Teams Read-only »
string
Filtrez les résultats aux 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 (p. ex. « 2023-01-01T00:00:00Z »)
string
Heure de fin au format RFC 3339 (p. ex. « 2023-12-31T23:59:59Z »)
array
Tableau d’adresses e‑mail pour filtrer les résultats. Ne peut pas être utilisé avec le paramètre
group_name.array
Filtrez par type d’IDE. Options disponibles :
"editor"- Windsurf Editor"jetbrains"- JetBrains Plugin
array
requis
Tableau de requêtes de sources 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 proposéeslinesAccepted- Nombre de lignes acceptées
cascade_runs
day- Date au format RFC 3339model- Nom du modèle d’IA utilisémode- Mode Cascade (voir les modes ci-dessous)messagesSent- Nombre de messages envoyéscascadeId- ID de conversation uniquepromptsUsed- Crédits consommés (en centimes)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Mode d’écritureCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Mode de lectureCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Mode héritéUNKNOWN- Mode inconnu
cascade_tool_usage
tool- Identifiant de l’outil (voir les mappages d’outils ci-dessous)count- Nombre d’utilisations de l’outil
Correspondances d’utilisation des outils
Exemple de demande
Réponse
array
Tableau des résultats de requête, un élément pour chaque requête
Exemple de réponse
Remarques
- L’API renvoie des données brutes susceptibles de contenir des valeurs « UNKNOWN »
- Pour analyser les métriques, agrégez par champs spécifiques pertinents (par exemple, en faisant la somme de
promptsUsedpour les schémas d’utilisation) - Les données relatives au mode et au prompt peuvent être réparties sur plusieurs entrées
- La consommation de crédits (
promptsUsed) est renvoyée en centimes (100 = 1 crédit)