Cascade Analytics abrufen

Cascade-spezifische Nutzungsmetriken abfragen, einschließlich der Anzahl vorgeschlagener/akzeptierter Zeilen, der Nutzung von AI-Modellen, des Credit-Verbrauchs und der Tool-Nutzungsstatistiken.

POST /api/v1/CascadeAnalytics

Cascade Analytics abrufen

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>"
          }
        ]
      }
    }
  ]
}

​

Überblick

Abrufen Cascade-spezifischer Analytics-Daten, einschließlich vorgeschlagener und akzeptierter Zeilen, Nutzung der AI-Modelle, Kreditverbrauch und Statistiken zur Tool-Nutzung.

​

Anfrage

service_key · string · erforderlich

Ihr Service Key mit „Teams Nur-Lesen“-Berechtigungen

group_name · string

Ergebnisse auf Benutzer in einer bestimmten Gruppe beschränken. Kann nicht zusammen mit dem Parameter emails verwendet werden.

start_timestamp · string

Startzeit im RFC 3339-Format (z. B. 2023-01-01T00:00:00Z)

end_timestamp · string

Endzeit im RFC 3339-Format (z. B. 2023-12-31T23:59:59Z)

emails · array

Array von E‑Mail-Adressen zum Filtern der Ergebnisse. Kann nicht zusammen mit dem Parameter group_name verwendet werden.

ide_types · array

Nach IDE-Typ filtern. Verfügbare Optionen:

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

Wenn weggelassen, werden Daten für beide IDEs zurückgegeben.

query_requests · array · erforderlich

Array von Datenquellenabfragen, die ausgeführt werden sollen. Jedes Objekt muss eine der unterstützten Datenquellen enthalten.

​

Datenquellen

​

cascade_lines

Abfrage nach täglich vorgeschlagenen und angenommenen Cascade-Zeilen.

{
  "cascade_lines": {}
}

Antwortfelder:

• day - Datum im RFC 3339-Format
• linesSuggested - Anzahl der vorgeschlagenen Zeilen
• linesAccepted - Anzahl der akzeptierten Zeilen

​

cascade_runs

Abfrage von AI-Modell-Nutzung, Kreditverbrauch und Modusdaten.

{
  "cascade_runs": {}
}

Antwortfelder:

• day - Datum im Format RFC 3339
• model - Name des verwendeten AI-Modells
• mode - Cascade-Modus (siehe Modi unten)
• messagesSent - Anzahl gesendeter Nachrichten
• cascadeId - Eindeutige Konversations-ID
• promptsUsed - Verbrauchte Credits (in Cent)

Cascade-Modi:

• CONVERSATIONAL_PLANNER_MODE_DEFAULT - Schreibmodus
• CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Lesemodus
• CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Legacy-Modus
• UNKNOWN - Unbekannter Modus

​

cascade_tool_usage

Abfrage von Tool-Nutzungsstatistiken (aggregierte Zählwerte).

{
  "cascade_tool_usage": {}
}

Antwortfelder:

• tool - Tool-Bezeichner (siehe Tool-Zuordnungen unten)
• count - Anzahl der Tool-Nutzungen

​

Zuordnungen der Tool-Nutzung

Tool Identifier	Anzeigename
CODE_ACTION	Code bearbeiten
VIEW_FILE	Datei anzeigen
RUN_COMMAND	Command ausführen
FIND	Such-Tool
GREP_SEARCH	Grep-Suche
VIEW_FILE_OUTLINE	Dateiübersicht anzeigen
MQUERY	Riptide
WORKFLOWS_USED	Verwendete Workflows
LIST_DIRECTORY	Verzeichnis auflisten
MCP_TOOL	MCP-Tool
PROPOSE_CODE	Code vorschlagen
SEARCH_WEB	Web durchsuchen
MEMORY	Speicher
PROXY_WEB_SERVER	Browser-Vorschau
DEPLOY_WEB_APP	Web-App bereitstellen

​

Beispielanfrage

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

​

Response

queryResults · array

Array mit Abfrageergebnissen, eines pro Abfrageanforderung

Anzeigen Cascade-Zeilen-Ergebnis

cascadeLines · object

cascadeLines · array

Array täglicher Zeilenstatistiken

day · string

Datum im RFC 3339-Format

linesSuggested · string

Anzahl der an diesem Tag vorgeschlagenen Zeilen

linesAccepted · string

Anzahl der an diesem Tag akzeptierten Zeilen

Anzeigen Cascade-Läufe-Ergebnis

cascadeRuns · object

cascadeRuns · array

Array von Nutzungsstatistiken für AI-Modelle

day · string

Datum im RFC 3339-Format

model · string

Name des für den Lauf verwendeten AI-Modells

mode · string

Kennung des Cascade-Modus

messagesSent · string

Anzahl der gesendeten Nachrichten

cascadeId · string

Eindeutiger Konversationsbezeichner

promptsUsed · string

In Cent verbrauchte Credits (z. B. „100“ = 1 Credit)

Anzeigen Cascade-Toolnutzungs-Ergebnis

cascadeToolUsage · object

cascadeToolUsage · array

Array von Toolnutzungsstatistiken

tool · string

Toolbezeichner

count · string

Anzahl der Verwendungen des Tools

​

Beispielantwort

{
  "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"
          }
        ]
      }
    }
  ]
}

​

Hinweise

• Die API gibt Rohdaten zurück, die „UNKNOWN“-Werte enthalten können
• Für die Analyse von Metriken nach spezifischen Feldern von Interesse aggregieren (z. B. promptsUsed aufsummieren, um Nutzungsmuster zu erkennen)
• Modus- und Prompt-Daten können auf mehrere Einträge verteilt sein
• Der Kreditverbrauch (promptsUsed) wird in Cent zurückgegeben (100 = 1 Credit)