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 /api/v1/CascadeAnalytics

Obtenir les Analytics Cascade

cURL

curl --request POST \
  --url https://server.codeium.com/api/v1/CascadeAnalytics \
  --header 'Content-Type: application/json' \
  --data '
{
  "service_key": "<string>",
  "group_name": "<string>",
  "start_timestamp": "<string>",
  "end_timestamp": "<string>",
  "emails": [
    {}
  ],
  "ide_types": [
    {}
  ],
  "query_requests": [
    {}
  ]
}
'

200

{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "<string>",
            "linesSuggested": "<string>",
            "linesAccepted": "<string>"
          }
        ]
      },
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "<string>",
            "model": "<string>",
            "mode": "<string>",
            "messagesSent": "<string>",
            "cascadeId": "<string>",
            "promptsUsed": "<string>"
          }
        ]
      },
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "<string>",
            "count": "<string>"
          }
        ]
      }
    }
  ]
}

​

Vue d’ensemble

Récupérez des données Analytics spécifiques à Cascade, notamment les 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

service_key · string · requis

Votre clé de service avec les autorisations « Teams Read-only »

group_name · string

Filtrez les résultats aux 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 (p. ex. « 2023-01-01T00:00:00Z »)

end_timestamp · string

Heure de fin au format RFC 3339 (p. ex. « 2023-12-31T23:59:59Z »)

emails · array

Tableau d’adresses e‑mail pour filtrer les résultats. Ne peut pas être utilisé avec le paramètre group_name.

ide_types · array

Filtrez par type d’IDE. Options disponibles :

• "editor" - Windsurf Editor
• "jetbrains" - JetBrains Plugin

S’il est omis, renvoie des données pour les deux IDE.

query_requests · 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 pour les lignes Cascade quotidiennes proposées et acceptées.

{
  "cascade_lines": {}
}

Champs de réponse :

• day - Date au format RFC 3339
• linesSuggested - Nombre de lignes proposées
• linesAccepted - Nombre de lignes acceptées

​

cascade_runs

Requête pour l’utilisation des modèles d’IA, la consommation de crédits et les données sur les modes.

{
  "cascade_runs": {}
}

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 - ID de conversation unique
• 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 de statistiques d’utilisation des outils (comptages agrégés).

{
  "cascade_tool_usage": {}
}

Champs de réponse :

• tool - Identifiant de l’outil (voir les mappages d’outils ci-dessous)
• count - Nombre d’utilisations de l’outil

​

Correspondances d’utilisation des outils

Tool Identifier	Nom affiché
CODE_ACTION	Édition de code
VIEW_FILE	Afficher le fichier
RUN_COMMAND	Exécuter une commande
FIND	Outil de recherche
GREP_SEARCH	Recherche Grep
VIEW_FILE_OUTLINE	Afficher le plan du fichier
MQUERY	Riptide
WORKFLOWS_USED	Workflows utilisés
LIST_DIRECTORY	Lister le contenu du répertoire
MCP_TOOL	Outil MCP
PROPOSE_CODE	Proposer du code
SEARCH_WEB	Recherche sur le Web
MEMORY	Mémoire
PROXY_WEB_SERVER	Aperçu dans le navigateur
DEPLOY_WEB_APP	Déployer l’application web

​

Exemple de demande

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2025-01-01T00:00:00Z",
  "end_timestamp": "2025-01-02T00:00:00Z",
  "emails": ["[e-mail]", "[e-mail]"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics

​

Réponse

queryResults · array

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

Afficher Résultat des lignes Cascade

cascadeLines · object

cascadeLines · array

Tableau de statistiques quotidiennes sur les lignes

day · string

Date au format RFC 3339

linesSuggested · string

Nombre de lignes suggérées ce jour-là

linesAccepted · string

Nombre de lignes acceptées ce jour-là

Afficher Résultat des exécutions Cascade

cascadeRuns · object

cascadeRuns · array

Tableau de statistiques d’utilisation du modèle d’IA

day · string

Date au format RFC 3339

model · string

Nom du modèle d’IA utilisé pour l’exécution

mode · string

Identifiant du mode Cascade

messagesSent · string

Nombre de messages envoyés

cascadeId · string

Identifiant unique de la conversation

promptsUsed · string

Crédits consommés en centimes (par exemple “100” = 1 crédit)

Afficher Résultat d’utilisation des outils Cascade

cascadeToolUsage · object

cascadeToolUsage · array

Tableau de statistiques d’utilisation des outils

tool · string

Identifiant de l’outil

count · string

Nombre de fois où l’outil a été utilisé

​

Exemple de réponse

{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "2025-05-01T00:00:00Z",
            "linesSuggested": "206",
            "linesAccepted": "157"
          },
          {
            "day": "2025-05-02T00:00:00Z",
            "linesSuggested": "16"
          }
        ]
      }
    },
    {
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "2025-05-01T00:00:00Z",
            "model": "Claude 3.7 Sonnet (Thinking)",
            "mode": "CONVERSATIONAL_PLANNER_MODE_DEFAULT",
            "messagesSent": "1",
            "cascadeId": "0d35c1f7-0a85-41d0-ac96-a04cd2d64444"
          }
        ]
      }
    },
    {
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "CODE_ACTION",
            "count": "15"
          },
          {
            "tool": "LIST_DIRECTORY",
            "count": "20"
          }
        ]
      }
    }
  ]
}

​

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 promptsUsed pour 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)