Cascade Analytics abrufen
Analytics-API
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
Cascade Analytics abrufen
Überblick
Anfrage
string
erforderlich
Ihr Service Key mit „Teams Nur-Lesen“-Berechtigungen
string
Ergebnisse auf Benutzer in einer bestimmten Gruppe beschränken. Kann nicht zusammen mit dem Parameter
emails verwendet werden.string
Startzeit im RFC 3339-Format (z. B.
2023-01-01T00:00:00Z)string
Endzeit im RFC 3339-Format (z. B.
2023-12-31T23:59:59Z)array
Array von E‑Mail-Adressen zum Filtern der Ergebnisse. Kann nicht zusammen mit dem Parameter
group_name verwendet werden.array
Nach IDE-Typ filtern. Verfügbare Optionen:
"editor"- Windsurf Editor"jetbrains"- JetBrains Plugin
array
erforderlich
Array von Datenquellenabfragen, die ausgeführt werden sollen. Jedes Objekt muss eine der unterstützten Datenquellen enthalten.
Datenquellen
cascade_lines
day- Datum im RFC 3339-FormatlinesSuggested- Anzahl der vorgeschlagenen ZeilenlinesAccepted- Anzahl der akzeptierten Zeilen
cascade_runs
day- Datum im Format RFC 3339model- Name des verwendeten AI-Modellsmode- Cascade-Modus (siehe Modi unten)messagesSent- Anzahl gesendeter NachrichtencascadeId- Eindeutige Konversations-IDpromptsUsed- Verbrauchte Credits (in Cent)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- SchreibmodusCONVERSATIONAL_PLANNER_MODE_READ_ONLY- LesemodusCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Legacy-ModusUNKNOWN- Unbekannter Modus
cascade_tool_usage
tool- Tool-Bezeichner (siehe Tool-Zuordnungen unten)count- Anzahl der Tool-Nutzungen
Zuordnungen der Tool-Nutzung
Beispielanfrage
Response
array
Array mit Abfrageergebnissen, eines pro Abfrageanforderung
Beispielantwort
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.
promptsUsedaufsummieren, 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)