Benutzerdefinierte Analytics-Abfrage
Analytics-API
Benutzerdefinierte Analytics-Abfrage
Flexible Analytics-Abfragen mit benutzerdefinierten selections, Filtern und aggregations für Autocomplete-, Chat-, Command- und PCW-Daten.
POST
Benutzerdefinierte Analytics-Abfrage
Überblick
Request
string
erforderlich
Ihr Service Key mit Berechtigung „Analytics Read“
string
Ergebnisse auf Nutzer in einer bestimmten Gruppe filtern (optional)
array
erforderlich
Array von Query-Request-Objekten, die die abzurufenden Daten definieren
Struktur der Query-Anfrage
- data_source (erforderlich): Abzufragende Datenquelle
- selections (erforderlich): Array von Feldselections, die abgerufen werden sollen
- filters (optional): Array von Filtern, die angewendet werden sollen
- aggregations (optional): Array von Aggregations zum Gruppieren
Selections
- field (erforderlich): Name des auszuwählenden Feldes
- name (optional): Alias für das Feld
- aggregation_function (optional): Anzuwendende Aggregationsfunktion
Beispiel zur Auswahl
Filter
- name (erforderlich): Feldname, nach dem gefiltert werden soll
- filter (erforderlich): Filter-Operation
- value (erforderlich): Wert, mit dem verglichen werden soll
Beispiel für Filter
Aggregations
- field (required): Feldname, nach dem gruppiert werden soll
- name (required): Alias für das Aggregationsfeld
Beispiel für Aggregation
Verfügbare Felder
Nutzerdaten
Chat-Daten
Chat-Daten sind von Cascade-Daten getrennt und erfassen die Nutzung unserer älteren, nicht-agentischen Plugins
Chat-Intent-Typen
CHAT_INTENT_GENERIC- Normales ChatCHAT_INTENT_FUNCTION_EXPLAIN- CodeLens zur Erklärung einer FunktionCHAT_INTENT_FUNCTION_DOCSTRING- CodeLens für den Docstring einer FunktionCHAT_INTENT_FUNCTION_REFACTOR- CodeLens zum Refactoring einer FunktionCHAT_INTENT_CODE_BLOCK_EXPLAIN- CodeLens zur Erklärung eines CodeblocksCHAT_INTENT_CODE_BLOCK_REFACTOR- CodeLens zum Refactoring eines CodeblocksCHAT_INTENT_PROBLEM_EXPLAIN- CodeLens zur Erklärung eines ProblemsCHAT_INTENT_FUNCTION_UNIT_TESTS- CodeLens für Unit-Tests einer Funktion
Command-Daten
accepted, um nur nach akzeptierten Commands zu filtern.
Command-Quellen
COMMAND_REQUEST_SOURCE_LINE_HINT_CODE_LENSCOMMAND_REQUEST_SOURCE_DEFAULT- Typische Command-VerwendungCOMMAND_REQUEST_SOURCE_RIGHT_CLICK_REFACTORCOMMAND_REQUEST_SOURCE_FUNCTION_CODE_LENSCOMMAND_REQUEST_SOURCE_FOLLOWUPCOMMAND_REQUEST_SOURCE_CLASS_CODE_LENSCOMMAND_REQUEST_SOURCE_PLANCOMMAND_REQUEST_SOURCE_SELECTION_HINT_CODE_LENS
Providerquellen
PROVIDER_SOURCE_COMMAND_GENERATE- GenerierungsmodusPROVIDER_SOURCE_COMMAND_EDIT- Bearbeitungsmodus
PCW-Daten
PCW-Filter
Für die Datumsfilterung in PCW-Abfragen verwende die Parameter
start_timestamp und end_timestamp im Hauptteil der Anfrage.
Beispielanfragen
Beispiel für Nutzerdaten
Beispiel für Chatdaten
Beispiel für Command-Daten
Beispiel für PCW-Daten
Antwort
array
Beispielantworten
Antwort mit Benutzerdaten
Antwort mit Chat-Daten
Command-Datenantwort
PCW-Datenantwort
Wichtige Hinweise
- PCW (Percent Code Written) weist innerhalb einzelner Tage oder bei einzelnen Nutzern eine hohe Varianz auf – aggregieren Sie über Wochen, um bessere Einblicke zu erhalten
- Alle selection-Felder müssen entweder Aggregationsfunktionen haben oder keine (Mischformen sind nicht möglich)
- Felder mit dem Muster “distinct_*” können nicht in aggregations verwendet werden
- Feldaliase müssen über alle selections und aggregations hinweg eindeutig sein
- Wenn keine Aggregationsfunktion angegeben ist, wird standardmäßig UNSPECIFIED verwendet