POST
/
api
/
v1
/
Analytics
Consulta personalizada do Analytics
curl --request POST \
  --url https://server.codeium.com/api/v1/Analytics \
  --header 'Content-Type: application/json' \
  --data '{
  "service_key": "<string>",
  "group_name": "<string>",
  "query_requests": [
    {}
  ],
  "data_source": "<string>",
  "selections": [
    {}
  ],
  "filters": [
    {}
  ],
  "aggregations": [
    {}
  ],
  "field": "<string>",
  "name": "<string>",
  "aggregation_function": "<string>",
  "value": "<string>",
  "filter": "<string>"
}'
{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {}
        }
      ]
    }
  ]
}

​
Visão geral

A Analytics API personalizada oferece recursos flexíveis de consulta para dados de Autocomplete, Chat e Command, com selections, filtros, aggregations e ordenações personalizáveis.

​
Solicitação

​
service_key
string
required
Sua Service Key com permissões “Teams Read-only”
​
group_name
string
Filtre os resultados para usuários de um grupo específico (opcional)
​
query_requests
array
required
Array de objetos de solicitação de consulta que definem os dados a serem recuperados

​
Estrutura da solicitação de consulta

Cada objeto de solicitação de consulta contém:
​
data_source
string
required
Fonte de dados a consultar. Opções:
  • QUERY_DATA_SOURCE_USER_DATA - dados de Autocomplete
  • QUERY_DATA_SOURCE_CHAT_DATA - dados de Chat
  • QUERY_DATA_SOURCE_COMMAND_DATA - dados de Command
  • QUERY_DATA_SOURCE_PCW_DATA - dados de Percent Code Written
​
selections
array
required
Array de seleções de campos a recuperar (veja a seção Selections)
​
filters
array
Array de filtros a aplicar (veja a seção Filters)
​
aggregations
array
Array de aggregations para agrupar (veja a seção Aggregations)

​
Selections

Selections definem quais campos serão obtidos e como serão agregados.
​
field
string
required
Nome do campo a selecionar (consulte a seção Available Fields)
​
name
string
Alias do campo. Se não for especificado, o padrão será {aggregation_function}_{field_name} (em minúsculas)
​
aggregation_function
string
Função de agregação a ser aplicada:
  • QUERY_AGGREGATION_UNSPECIFIED (padrão)
  • QUERY_AGGREGATION_COUNT
  • QUERY_AGGREGATION_SUM
  • QUERY_AGGREGATION_AVG
  • QUERY_AGGREGATION_MAX
  • QUERY_AGGREGATION_MIN

​
Exemplo de seleção

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

​
Filtros

Filtros reduzem os dados a elementos que atendem a critérios específicos.
​
name
string
required
Nome do campo a ser filtrado
​
value
string
required
Valor a ser comparado
​
filter
string
required
Operação de filtro:
  • QUERY_FILTER_EQUAL
  • QUERY_FILTER_NOT_EQUAL
  • QUERY_FILTER_GREATER_THAN
  • QUERY_FILTER_LESS_THAN
  • QUERY_FILTER_GE (maior ou igual)
  • QUERY_FILTER_LE (menor ou igual)

​
Exemplo de filtro

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

​
Aggregations

Aggregations agrupam dados por critérios especificados.
​
field
string
required
Nome do campo pelo qual agrupar
​
name
string
required
Alias para o campo de aggregation

​
Exemplo de agregação

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

​
Campos disponíveis

​
Dados do usuário

Todos os dados do usuário são agregados por usuário, por hora.
Nome do campoDescriçãoAgregações válidas
api_keyHash da chave de API do usuárioUNSPECIFIED, COUNT
dateData em UTC do AutocompleteUNSPECIFIED, COUNT
date UTC-xData com deslocamento de fuso horário (por exemplo, “date UTC-8” para PST)UNSPECIFIED, COUNT
hourHora em UTC do AutocompleteUNSPECIFIED, COUNT
languageLinguagem de programaçãoUNSPECIFIED, COUNT
ideIDE em usoUNSPECIFIED, COUNT
versionVersão do WindsurfUNSPECIFIED, COUNT
num_acceptancesNúmero de aceitações do AutocompleteSUM, MAX, MIN, AVG
num_lines_acceptedLinhas de código aceitasSUM, MAX, MIN, AVG
num_bytes_acceptedBytes aceitosSUM, MAX, MIN, AVG
distinct_usersUsuários distintosUNSPECIFIED, COUNT
distinct_developer_daysTuplas distintas (usuário, dia)UNSPECIFIED, COUNT
distinct_developer_hoursTuplas distintas (usuário, hora)UNSPECIFIED, COUNT

​
Dados do Chat

Todos os Dados do Chat representam respostas do modelo de chat, não perguntas dos usuários.
Field NameDescriptionValid Aggregations
api_keyHash da chave de API do usuárioUNSPECIFIED, COUNT
model_idID do modelo de ChatUNSPECIFIED, COUNT
dateData em UTC da resposta do ChatUNSPECIFIED, COUNT
date UTC-xData com offset de fuso horárioUNSPECIFIED, COUNT
ideIDE em usoUNSPECIFIED, COUNT
versionVersão do WindsurfUNSPECIFIED, COUNT
latest_intent_typeTipo de intenção do Chat (veja Tipos de Intenção abaixo)UNSPECIFIED, COUNT
num_chats_receivedNúmero de mensagens do Chat recebidasSUM, MAX, MIN, AVG
chat_acceptedSe o Chat foi aceito (polegar para cima)SUM, COUNT
chat_inserted_at_cursorSe o botão “Insert” foi clicadoSUM, COUNT
chat_appliedSe o botão “Apply Diff” foi clicadoSUM, COUNT
chat_loc_usedLinhas de código usadas a partir do ChatSUM, MAX, MIN, AVG

​
Tipos de intenção do Chat

  • CHAT_INTENT_GENERIC - Chat comum
  • CHAT_INTENT_FUNCTION_EXPLAIN - Code lens de explicação de função
  • CHAT_INTENT_FUNCTION_DOCSTRING - Code lens de docstring de função
  • CHAT_INTENT_FUNCTION_REFACTOR - Code lens de refatoração de função
  • CHAT_INTENT_CODE_BLOCK_EXPLAIN - Code lens de explicação de bloco de código
  • CHAT_INTENT_CODE_BLOCK_REFACTOR - Code lens de refatoração de bloco de código
  • CHAT_INTENT_PROBLEM_EXPLAIN - Code lens de explicação de problema
  • CHAT_INTENT_FUNCTION_UNIT_TESTS - Code lens de testes unitários de função

​
Dados de Command

Os dados de Command incluem todos os comandos, inclusive os recusados. Use o campo accepted para filtrar apenas os comandos aceitos.
Field NameDescriptionValid Aggregations
api_keyHash da chave de API do usuárioUNSPECIFIED, COUNT
dateData UTC do comandoUNSPECIFIED, COUNT
timestampCarimbo de data/hora (UTC) do comandoUNSPECIFIED, COUNT
languageLinguagem de programaçãoUNSPECIFIED, COUNT
ideIDE em usoUNSPECIFIED, COUNT
versionVersão do WindsurfUNSPECIFIED, COUNT
command_sourceOrigem do acionamento do Command (veja Command Sources abaixo)UNSPECIFIED, COUNT
provider_sourceModo de geração ou ediçãoUNSPECIFIED, COUNT
lines_addedLinhas de código adicionadasSUM, MAX, MIN, AVG
lines_removedLinhas de código removidasSUM, MAX, MIN, AVG
bytes_addedBytes adicionadosSUM, MAX, MIN, AVG
bytes_removedBytes removidosSUM, MAX, MIN, AVG
selection_linesLinhas selecionadas (zero para gerações)SUM, MAX, MIN, AVG
selection_bytesBytes selecionados (zero para gerações)SUM, MAX, MIN, AVG
acceptedIndica se o comando foi aceitoSUM, COUNT

​
Fontes do Command

  • COMMAND_REQUEST_SOURCE_LINE_HINT_CODE_LENS
  • COMMAND_REQUEST_SOURCE_DEFAULT - Uso típico do 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

​
Fontes do provedor

  • PROVIDER_SOURCE_COMMAND_GENERATE - Modo de geração
  • PROVIDER_SOURCE_COMMAND_EDIT - Modo de edição

​
Dados de PCW

Dados de Percent Code Written com rastreamento separado para contribuições de Autocomplete e Command.
Field NameDescriptionValid Aggregations
percent_code_writtenCalculado como codeium_bytes / (codeium_bytes + user_bytes)UNSPECIFIED
codeium_bytesTotal de bytes gerados pelo CodeiumUNSPECIFIED
user_bytesTotal de bytes escritos pelo usuárioUNSPECIFIED
total_bytescodeium_bytes + user_bytesUNSPECIFIED
codeium_bytes_by_autocompleteBytes do Codeium provenientes de AutocompleteUNSPECIFIED
codeium_bytes_by_commandBytes do Codeium provenientes de CommandUNSPECIFIED

​
Filtros do PCW

Nome do campoDescriçãoExemplos
languageLinguagem de programaçãoKOTLIN, GO, JAVA
ideIDE em usojetbrains, vscode
versionVersão do Windsurf1.28.0, 130.0
Para filtrar por data em consultas do PCW, use start_timestamp e end_timestamp no corpo principal da requisição.

​
Exemplos de solicitações

​
Exemplo de dados do usuário

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "sua_chave_de_servico_aqui",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_USER_DATA",
      "selections": [
        {
          "field": "num_acceptances",
          "name": "total_acceptances",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        },
        {
          "field": "num_lines_accepted",
          "name": "total_lines",
          "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

​
Exemplo de dados do Chat

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

​
Exemplo de dados do Command

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

​
Exemplo de dados de PCW

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "sua_chave_de_servico_aqui",
  "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

​
Resposta

​
queryResults
array
Array de resultados de consulta, um para cada solicitação de consulta
​
responseItems
array
Array de itens de resultado
​
item
object
Objeto contendo os campos selecionados e seus valores

​
Exemplos de respostas

​
Resposta de dados do usuário

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

​
Resposta de Dados do Chat

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

​
Resposta de dados do 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"
          }
        }
      ]
    }
  ]
}

​
Resposta de dados do PCW

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

​
Observações importantes

  • O PCW (Percent Code Written) apresenta alta variabilidade ao longo de um mesmo dia ou entre usuários — agregue por semanas para obter insights melhores
  • Todos os campos de seleção devem ou ter funções de agregação, ou nenhum deve tê-las (não é possível misturar)
  • Campos com o padrão “distinct_*” não podem ser usados em aggregations
  • Os aliases de campos devem ser exclusivos em todas as selections e aggregations
  • Se nenhuma função de agregação for especificada, o padrão será UNSPECIFIED