Skip to main content
POST
Obtenir les Analytics de Cascade

Vue d’ensemble

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

Requête

string
requis
Votre clé de service avec l’autorisation “Teams Read-only”
string
Filtre 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
Filtrer par type d’IDE. Options disponibles :
  • "editor" - Windsurf Editor
  • "jetbrains" - JetBrains Plugin
S’il est omis, renvoie les données pour les deux IDE.
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

Requête des lignes quotidiennes de Cascade suggérées et acceptées.
Champs de réponse :
  • day - Date au format RFC 3339
  • linesSuggested - Nombre de lignes proposées
  • linesAccepted - Nombre de lignes acceptées

cascade_runs

Interroger l’utilisation du modèle d’IA, la consommation de crédits et les données relatives aux modes.
Champs de réponse :
  • day - Date au format RFC 3339
  • model - Nom du modèle d’IA 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 d’écriture
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Mode de lecture
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Mode hérité
  • UNKNOWN - Mode inconnu

cascade_tool_usage

Requête pour les statistiques d’utilisation des outils (totaux agrégés).
Champs de réponse :
  • tool - Identifiant de l’outil (voir les mappages d’outils ci-dessous)
  • count - Nombre de fois où l’outil a été utilisé

Correspondances d’utilisation des outils

Exemple de demande

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 qui peuvent contenir des valeurs « UNKNOWN »
  • Pour l’analyse des métriques, agrégez par champs spécifiques d’intérêt (par exemple, la somme de promptsUsed pour analyser 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)