Interogare Analytics personalizată

Prezentare generală

Analytics API personalizat oferă capabilități flexibile de interogare pentru datele Autocomplete, Chat și Command, cu selections personalizabile, filtre, agregations și ordonări.

Cerere

service_key

string

required

Cheia ta de serviciu cu permisiuni „Teams Read-only”

group_name

string

Filtrează rezultatele la utilizatorii dintr-un anumit grup (opțional)

query_requests

array

required

Listă de obiecte de cerere de interogare care definesc datele de extras

Structura cererii de interogare

Fiecare obiect de cerere de interogare conține:

data_source

string

required

Sursa de date de interogat. Opțiuni:

QUERY_DATA_SOURCE_USER_DATA - date Autocomplete
QUERY_DATA_SOURCE_CHAT_DATA - date Chat
QUERY_DATA_SOURCE_COMMAND_DATA - date Command
QUERY_DATA_SOURCE_PCW_DATA - date Percent Code Written

selections

array

required

Array de selecții de câmp de recuperat (consultați secțiunea Selections)

filters

array

Array de filtre de aplicat (consultați secțiunea Filters)

aggregations

array

Array de agregări pentru grupare (consultați secțiunea Aggregations)

Selections

Selections definesc ce câmpuri să fie preluate și cum să fie agregate.

field

string

required

Numele câmpului de selectat (vezi secțiunea Available Fields)

name

string

Alias pentru câmp. Dacă nu este specificat, valoarea implicită este {aggregation_function}_{field_name} (cu litere mici)

aggregation_function

string

Funcția de agregare de aplicat:

QUERY_AGGREGATION_UNSPECIFIED (implicit)
QUERY_AGGREGATION_COUNT
QUERY_AGGREGATION_SUM
QUERY_AGGREGATION_AVG
QUERY_AGGREGATION_MAX
QUERY_AGGREGATION_MIN

Exemplu de selecție

{
  "field": "num_acceptances",
  "name": "total_acceptances",
  "aggregation_function": "QUERY_AGGREGATION_SUM"
}

Filtre

Filtrele restrâng datele la elementele care îndeplinesc anumite criterii.

name

string

required

Numele câmpului pe care se aplică filtrarea

value

string

required

Valoarea de comparat

filter

string

required

Operația de filtrare:

QUERY_FILTER_EQUAL
QUERY_FILTER_NOT_EQUAL
QUERY_FILTER_GREATER_THAN
QUERY_FILTER_LESS_THAN
QUERY_FILTER_GE (mai mare sau egal)
QUERY_FILTER_LE (mai mic sau egal)

Exemplu de filtrare

{
  "name": "language",
  "filter": "QUERY_FILTER_EQUAL",
  "value": "PYTHON"
}

Agregations

Agregations grupează datele după criterii specificate.

field

string

required

Numele câmpului după care se grupează

name

string

required

Alias pentru câmpul de agregare

Exemplu de agregare

{
  "field": "ide",
  "name": "tip_ide"
}

Câmpuri disponibile

Date despre utilizator

Toate datele despre utilizator sunt agregate per utilizator, pe oră.

Numele câmpului	Descriere	Agregări valide
`api_key`	Hash-ul cheii API a utilizatorului	UNSPECIFIED, COUNT
`date`	Data UTC a Autocomplete	UNSPECIFIED, COUNT
`date UTC-x`	Dată cu decalaj de fus orar (de ex., „date UTC-8” pentru PST)	UNSPECIFIED, COUNT
`hour`	Ora UTC a Autocomplete	UNSPECIFIED, COUNT
`language`	Limbaj de programare	UNSPECIFIED, COUNT
`ide`	IDE utilizat	UNSPECIFIED, COUNT
`version`	Versiunea Windsurf	UNSPECIFIED, COUNT
`num_acceptances`	Număr de acceptări Autocomplete	SUM, MAX, MIN, AVG
`num_lines_accepted`	Linii de cod acceptate	SUM, MAX, MIN, AVG
`num_bytes_accepted`	Octeți acceptați	SUM, MAX, MIN, AVG
`distinct_users`	Utilizatori unici	UNSPECIFIED, COUNT
`distinct_developer_days`	Perechi distincte (utilizator, zi)	UNSPECIFIED, COUNT
`distinct_developer_hours`	Perechi distincte (utilizator, oră)	UNSPECIFIED, COUNT

Date Chat

Toate datele Chat reprezintă răspunsuri ale modelului de chat, nu întrebările utilizatorului.

Field Name	Description	Valid Aggregations
`api_key`	Hash-ul cheii API a utilizatorului	UNSPECIFIED, COUNT
`model_id`	ID-ul modelului de Chat	UNSPECIFIED, COUNT
`date`	Data UTC a răspunsului de chat	UNSPECIFIED, COUNT
`date UTC-x`	Dată cu decalaj de fus orar	UNSPECIFIED, COUNT
`ide`	IDE utilizat	UNSPECIFIED, COUNT
`version`	Versiunea Windsurf	UNSPECIFIED, COUNT
`latest_intent_type`	Tipul intenției din Chat (vezi Tipuri de intenții mai jos)	UNSPECIFIED, COUNT
`num_chats_received`	Numărul de mesaje de chat primite	SUM, MAX, MIN, AVG
`chat_accepted`	Dacă chatul a fost acceptat (thumbs up)	SUM, COUNT
`chat_inserted_at_cursor`	Dacă s-a făcut clic pe butonul „Insert”	SUM, COUNT
`chat_applied`	Dacă s-a făcut clic pe butonul „Apply Diff”	SUM, COUNT
`chat_loc_used`	Linii de cod utilizate din chat	SUM, MAX, MIN, AVG

Tipuri de intenție Chat

CHAT_INTENT_GENERIC - Chat obișnuit
CHAT_INTENT_FUNCTION_EXPLAIN - CodeLens pentru explicarea funcției
CHAT_INTENT_FUNCTION_DOCSTRING - CodeLens pentru docstringul funcției
CHAT_INTENT_FUNCTION_REFACTOR - CodeLens pentru refactorizarea funcției
CHAT_INTENT_CODE_BLOCK_EXPLAIN - CodeLens pentru explicarea blocului de cod
CHAT_INTENT_CODE_BLOCK_REFACTOR - CodeLens pentru refactorizarea blocului de cod
CHAT_INTENT_PROBLEM_EXPLAIN - CodeLens pentru explicarea problemei
CHAT_INTENT_FUNCTION_UNIT_TESTS - CodeLens pentru testele unitare ale funcției

Date Command

Datele Command includ toate comenzile, inclusiv pe cele respinse. Folosiți câmpul accepted pentru a filtra doar comenzile acceptate.

Numele câmpului	Descriere	Agregări valide
`api_key`	Hash-ul cheii API a utilizatorului	UNSPECIFIED, COUNT
`date`	Data UTC a comenzii	UNSPECIFIED, COUNT
`timestamp`	Marcajul temporal UTC al comenzii	UNSPECIFIED, COUNT
`language`	Limbaj de programare	UNSPECIFIED, COUNT
`ide`	IDE utilizat	UNSPECIFIED, COUNT
`version`	Versiunea Windsurf	UNSPECIFIED, COUNT
`command_source`	Sursa declanșării Command (vedeți Command Sources mai jos)	UNSPECIFIED, COUNT
`provider_source`	Mod de generare sau editare	UNSPECIFIED, COUNT
`lines_added`	Linii de cod adăugate	SUM, MAX, MIN, AVG
`lines_removed`	Linii de cod eliminate	SUM, MAX, MIN, AVG
`bytes_added`	Bytes adăugați	SUM, MAX, MIN, AVG
`bytes_removed`	Bytes eliminați	SUM, MAX, MIN, AVG
`selection_lines`	Linii selectate (zero pentru generări)	SUM, MAX, MIN, AVG
`selection_bytes`	Bytes selectați (zero pentru generări)	SUM, MAX, MIN, AVG
`accepted`	Dacă a fost acceptată comanda	SUM, COUNT

Surse Command

COMMAND_REQUEST_SOURCE_LINE_HINT_CODE_LENS
COMMAND_REQUEST_SOURCE_DEFAULT - Utilizare tipică a Command
COMMAND_REQUEST_SOURCE_RIGHT_CLICK_REFACTOR
COMMAND_REQUEST_SOURCE_FUNCTION_CODE_LENS
COMMAND_REQUEST_SOURCE_FOLLOWUP
COMMAND_REQUEST_SOURCE_CLASS_CODE_LENS
COMMAND_REQUEST_SOURCE_PLAN
COMMAND_REQUEST_SOURCE_SELECTION_HINT_CODE_LENS

Surse de furnizor

PROVIDER_SOURCE_COMMAND_GENERATE - Mod generare
PROVIDER_SOURCE_COMMAND_EDIT - Mod editare

Date PCW

Date despre procentul de cod scris (Percent Code Written), cu urmărire separată pentru contribuțiile din Autocomplete și Command.

Field Name	Description	Valid Aggregations
`percent_code_written`	Calculat ca codeium_bytes / (codeium_bytes + user_bytes)	UNSPECIFIED
`codeium_bytes`	Totalul de bytes generați de Codeium	UNSPECIFIED
`user_bytes`	Totalul de bytes scriși de utilizator	UNSPECIFIED
`total_bytes`	codeium_bytes + user_bytes	UNSPECIFIED
`codeium_bytes_by_autocomplete`	Bytes Codeium din Autocomplete	UNSPECIFIED
`codeium_bytes_by_command`	Bytes Codeium din Command	UNSPECIFIED

Filtre PCW

Denumire câmp	Descriere	Exemple
`language`	Limbaj de programare	KOTLIN, GO, JAVA
`ide`	IDE utilizat	jetbrains, vscode
`version`	Versiune Windsurf	1.28.0, 130.0

Pentru filtrarea după dată în interogările PCW, utilizați start_timestamp și end_timestamp în corpul principal al cererii.

Exemple de solicitări

Exemplu de date de utilizator

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "cheia_ta_de_serviciu_aici",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_USER_DATA",
      "selections": [
        {
          "field": "num_acceptances",
          "name": "acceptari_totale",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        },
        {
          "field": "num_lines_accepted",
          "name": "linii_totale",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        }
      ],
      "filters": [
        {
          "name": "hour",
          "filter": "QUERY_FILTER_GE",
          "value": "2024-01-01"
        },
        {
          "name": "hour",
          "filter": "QUERY_FILTER_LE",
          "value": "2024-02-01"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Exemplu de date Chat

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "cheia_ta_de_serviciu_aici",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_CHAT_DATA",
      "selections": [
        {
          "field": "chat_loc_used",
          "name": "linii_folosite",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        }
      ],
      "filters": [
        {
          "name": "tip_ultima_intentie",
          "filter": "QUERY_FILTER_EQUAL",
          "value": "CHAT_INTENT_FUNCTION_DOCSTRING"
        }
      ],
      "aggregations": [
        {
          "field": "ide",
          "name": "tip_ide"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Exemplu de date pentru Command

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "cheia_ta_de_serviciu_aici",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_COMMAND_DATA",
      "selections": [
        {
          "field": "lines_added",
          "name": "total_linii_adaugate",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        },
        {
          "field": "lines_removed",
          "name": "total_linii_eliminate",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        }
      ],
      "filters": [
        {
          "name": "provider_source",
          "filter": "QUERY_FILTER_EQUAL",
          "value": "PROVIDER_SOURCE_COMMAND_EDIT"
        },
        {
          "name": "accepted",
          "filter": "QUERY_FILTER_EQUAL",
          "value": "true"
        }
      ],
      "aggregations": [
        {
          "field": "language",
          "name": "limbaj_programare"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Exemplu de date PCW

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "cheia_ta_de_serviciu_aici",
  "start_timestamp": "2024-01-01T00:00:00Z",
  "end_timestamp": "2024-12-22T00:00:00Z",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_PCW_DATA",
      "selections": [
        {
          "field": "percent_code_written",
          "name": "pcw"
        },
        {
          "field": "codeium_bytes",
          "name": "ai_bytes"
        },
        {
          "field": "total_bytes",
          "name": "total"
        },
        {
          "field": "codeium_bytes_by_autocomplete",
          "name": "autocomplete_bytes"
        },
        {
          "field": "codeium_bytes_by_command",
          "name": "command_bytes"
        }
      ],
      "filters": [
        {
          "filter": "QUERY_FILTER_EQUAL",
          "name": "language",
          "value": "GO"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Răspuns

queryResults

array

Listă de rezultate ale interogării, câte unul pentru fiecare cerere de interogare

responseItems

array

Listă de elemente de rezultat

item

object

Obiect care conține câmpurile selectate și valorile acestora

Exemple de răspuns

Răspuns pentru datele utilizatorilor

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {
            "total_acceptances": "125",
            "total_lines": "863"
          }
        }
      ]
    }
  ]
}

Răspuns de date Chat

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {
            "lines_used": "74",
            "ide_type": "jetbrains"
          }
        },
        {
          "item": {
            "lines_used": "41",
            "ide_type": "vscode"
          }
        }
      ]
    }
  ]
}

Răspuns de date pentru Command

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {
            "programming_language": "PYTHON",
            "total_lines_added": "21",
            "total_lines_removed": "5"
          }
        },
        {
          "item": {
            "programming_language": "GO",
            "total_lines_added": "31",
            "total_lines_removed": "27"
          }
        }
      ]
    }
  ]
}

Răspuns de date PCW

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {
            "ai_bytes": "6018",
            "autocomplete_bytes": "4593",
            "command_bytes": "1425",
            "pcw": "0.61",
            "total": "9900"
          }
        }
      ]
    }
  ]
}

Note importante

PCW (Percent Code Written) poate varia semnificativ în cadrul aceleiași zile sau pentru același utilizator — agregați pe perioade de câteva săptămâni pentru informații mai bune
Toate câmpurile de selecție trebuie fie să aibă funcții de agregare, fie niciunul (nu se pot combina)
Câmpurile cu modelul „distinct_*” nu pot fi folosite în agregations
Aliasurile câmpurilor trebuie să fie unice în toate selections și aggregations
Dacă nu este specificată o funcție de agregare, valoarea implicită este UNSPECIFIED

Începeți

Funcționalități

Cascade (JetBrains)

Conturi

Conștientizare a contextului

Cele mai bune practici

Depanare

Securitate

Interogare Analytics personalizată

Prezentare generală

Cerere

Structura cererii de interogare

Selections

Exemplu de selecție

Filtre

Exemplu de filtrare

Agregations

Exemplu de agregare

Câmpuri disponibile

Date despre utilizator

Date Chat

Tipuri de intenție Chat

Date Command

Surse Command

Surse de furnizor

Date PCW

Filtre PCW

Exemple de solicitări

Exemplu de date de utilizator

Exemplu de date Chat

Exemplu de date pentru Command

Exemplu de date PCW

Răspuns

Exemple de răspuns

Răspuns pentru datele utilizatorilor

Răspuns de date Chat

Răspuns de date pentru Command

Răspuns de date PCW

Note importante

Începeți

Funcționalități

Cascade (JetBrains)

Conturi

Conștientizare a contextului

Cele mai bune practici

Depanare

Securitate

​Prezentare generală

​Cerere

​Structura cererii de interogare

​Selections

​Exemplu de selecție

​Filtre

​Exemplu de filtrare

​Agregations

​Exemplu de agregare

​Câmpuri disponibile

​Date despre utilizator

​Date Chat

​Tipuri de intenție Chat

​Date Command

​Surse Command

​Surse de furnizor

​Date PCW

​Filtre PCW

​Exemple de solicitări

​Exemplu de date de utilizator

​Exemplu de date Chat

​Exemplu de date pentru Command

​Exemplu de date PCW

​Răspuns

​Exemple de răspuns

​Răspuns pentru datele utilizatorilor

​Răspuns de date Chat

​Răspuns de date pentru Command

​Răspuns de date PCW

​Note importante

Prezentare generală

Cerere

Structura cererii de interogare

Selections

Exemplu de selecție

Filtre

Exemplu de filtrare

Agregations

Exemplu de agregare

Câmpuri disponibile

Date despre utilizator

Date Chat

Tipuri de intenție Chat

Date Command

Surse Command

Surse de furnizor

Date PCW

Filtre PCW

Exemple de solicitări

Exemplu de date de utilizator

Exemplu de date Chat

Exemplu de date pentru Command

Exemplu de date PCW

Răspuns

Exemple de răspuns

Răspuns pentru datele utilizatorilor

Răspuns de date Chat

Răspuns de date pentru Command

Răspuns de date PCW

Note importante