Consulta personalizada de 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": [
        {
          "field": "<string>",
          "name": "<string>",
          "aggregation_function": "<string>"
        }
      ],
      "filters": [
        {
          "name": "<string>",
          "filter": "<string>",
          "value": "<string>"
        }
      ],
      "aggregations": [
        {
          "field": "<string>",
          "name": "<string>"
        }
      ]
    }
  ]
}
'

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {}
        }
      ]
    }
  ]
}

POST

api

Analytics

Consulta personalizada de 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": [
        {
          "field": "<string>",
          "name": "<string>",
          "aggregation_function": "<string>"
        }
      ],
      "filters": [
        {
          "name": "<string>",
          "filter": "<string>",
          "value": "<string>"
        }
      ],
      "aggregations": [
        {
          "field": "<string>",
          "name": "<string>"
        }
      ]
    }
  ]
}
'

{
  "queryResults": [
    {
      "responseItems": [
        {
          "item": {}
        }
      ]
    }
  ]
}

Descripción general

La Analytics API personalizada ofrece capacidades de consulta flexibles para datos de Autocomplete, Chat y Command, con selections personalizables, filtros, aggregations y ordenaciones.

Request

service_key

string

requerido

Tu clave de servicio con permisos de “Analytics Read”

group_name

string

Limita los resultados a usuarios de un grupo específico (opcional)

query_requests

array

requerido

Array de objetos de consulta que definen los datos a recuperar

Mostrar Objeto de solicitud de consulta

data_source

string

requerido

Fuente de datos a consultar. Opciones:

QUERY_DATA_SOURCE_USER_DATA - Datos de Autocomplete
QUERY_DATA_SOURCE_CHAT_DATA - Datos de Chat
QUERY_DATA_SOURCE_COMMAND_DATA - Datos de Command
QUERY_DATA_SOURCE_PCW_DATA - Datos de Percent Code Written

selections

array

requerido

Array de selections de campos que se van a recuperar

Mostrar Objeto Selection

field

string

requerido

Nombre del campo a seleccionar (consulta la sección Available Fields)

name

string

Alias del campo. Si no se especifica, el valor predeterminado es {aggregation_function}_{field_name} (en minúsculas)

aggregation_function

string

Función de agregación a aplicar:

QUERY_AGGREGATION_UNSPECIFIED (predeterminado)
QUERY_AGGREGATION_COUNT
QUERY_AGGREGATION_SUM
QUERY_AGGREGATION_AVG
QUERY_AGGREGATION_MAX
QUERY_AGGREGATION_MIN

filters

array

Array de filtros a aplicar

Mostrar Objeto Filter

name

string

requerido

Nombre del campo sobre el que filtrar

filter

string

requerido

Operación de filtrado:

QUERY_FILTER_EQUAL
QUERY_FILTER_NOT_EQUAL
QUERY_FILTER_GREATER_THAN
QUERY_FILTER_LESS_THAN
QUERY_FILTER_GE (mayor o igual que)
QUERY_FILTER_LE (menor o igual que)

value

string

requerido

Valor con el que comparar

aggregations

array

Array de aggregations para agrupar los resultados

Mostrar Objeto Aggregation

field

string

requerido

Nombre del campo por el que agrupar

name

string

requerido

Alias para el campo de agregación

Estructura de la solicitud de consulta

Cada objeto de solicitud de consulta contiene:

data_source (obligatorio): Fuente de datos a consultar
selections (obligatorio): Matriz de selecciones de campos que se recuperarán
filters (opcional): Matriz de filtros que se aplicarán
aggregations (opcional): Matriz de agregaciones para agrupar

Selections

Las selections definen qué campos recuperar y cómo agregarlos.

field (obligatorio): Nombre del campo a seleccionar
name (opcional): Alias del campo
aggregation_function (opcional): Función de agregación a aplicar

Ejemplo de selección

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

Filtros

Los filtros restringen los datos a elementos que cumplen criterios específicos.

name (obligatorio): Nombre del campo por el que filtrar
filter (obligatorio): Operación de filtro
value (obligatorio): Valor con el que comparar

Ejemplo de filtro

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

Aggregations

Las agregaciones agrupan datos según criterios específicos.

field (obligatorio): Nombre del campo por el que agrupar
name (obligatorio): Alias para el campo de agregación

Ejemplo de agregación

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

Campos disponibles

Datos de usuario

Todos los datos de usuario se agregan por usuario y por hora.

Field Name	Description	Valid Aggregations
`api_key`	Hash de la clave de API del usuario	UNSPECIFIED, COUNT
`date`	Fecha UTC del autocompletado	UNSPECIFIED, COUNT
`date UTC-x`	Fecha con desplazamiento de zona horaria (p. ej., “date UTC-8” para PST)	UNSPECIFIED, COUNT
`hour`	Hora UTC del autocompletado	UNSPECIFIED, COUNT
`language`	Lenguaje de programación	UNSPECIFIED, COUNT
`ide`	IDE en uso	UNSPECIFIED, COUNT
`version`	Versión de Windsurf	UNSPECIFIED, COUNT
`num_acceptances`	Número de aceptaciones de Autocomplete	SUM, MAX, MIN, AVG
`num_lines_accepted`	Líneas de código aceptadas	SUM, MAX, MIN, AVG
`num_bytes_accepted`	Bytes aceptados	SUM, MAX, MIN, AVG
`distinct_users`	Usuarios únicos	UNSPECIFIED, COUNT
`distinct_developer_days`	Tuplas únicas (usuario, día)	UNSPECIFIED, COUNT
`distinct_developer_hours`	Tuplas únicas (usuario, hora)	UNSPECIFIED, COUNT

Datos de Chat

Todos los Datos de Chat representan respuestas del modelo de IA del Chat, no preguntas del usuario.

Field Name	Description	Valid Aggregations
`api_key`	Hash de la clave de API del usuario	UNSPECIFIED, COUNT
`model_id`	ID del modelo de Chat	UNSPECIFIED, COUNT
`date`	Fecha UTC de la respuesta del Chat	UNSPECIFIED, COUNT
`date UTC-x`	Fecha con desfase de zona horaria	UNSPECIFIED, COUNT
`ide`	IDE en uso	UNSPECIFIED, COUNT
`version`	Versión de Windsurf	UNSPECIFIED, COUNT
`latest_intent_type`	Tipo de intención del Chat (ver Tipos de intención más abajo)	UNSPECIFIED, COUNT
`num_chats_received`	Número de mensajes de Chat recibidos	SUM, MAX, MIN, AVG
`chat_accepted`	Si se aceptó el Chat (pulgar arriba)	SUM, COUNT
`chat_inserted_at_cursor`	Si se hizo clic en el botón “Insert”	SUM, COUNT
`chat_applied`	Si se hizo clic en el botón “Apply Diff”	SUM, COUNT
`chat_loc_used`	Líneas de código usadas desde el Chat	SUM, MAX, MIN, AVG

Tipos de intención de Chat

CHAT_INTENT_GENERIC - Chat normal
CHAT_INTENT_FUNCTION_EXPLAIN - Code Lens de explicación de función
CHAT_INTENT_FUNCTION_DOCSTRING - Code Lens de docstring de función
CHAT_INTENT_FUNCTION_REFACTOR - Code Lens de refactorización de función
CHAT_INTENT_CODE_BLOCK_EXPLAIN - Code Lens de explicación de bloque de código
CHAT_INTENT_CODE_BLOCK_REFACTOR - Code Lens de refactorización de bloque de código
CHAT_INTENT_PROBLEM_EXPLAIN - Code Lens de explicación de problema
CHAT_INTENT_FUNCTION_UNIT_TESTS - Code Lens de pruebas unitarias de función

Datos de Command

Los datos de Command incluyen todos los comandos, incluidos los rechazados. Usa el campo accepted para filtrar solo los comandos aceptados.

Field Name	Description	Valid Aggregations
`api_key`	Hash de la clave de API del usuario	UNSPECIFIED, COUNT
`date`	Fecha UTC del comando	UNSPECIFIED, COUNT
`timestamp`	Marca de tiempo UTC del comando	UNSPECIFIED, COUNT
`language`	Lenguaje de programación	UNSPECIFIED, COUNT
`ide`	IDE en uso	UNSPECIFIED, COUNT
`version`	Versión de Windsurf	UNSPECIFIED, COUNT
`command_source`	Fuente del disparador de Command (ver Command Sources más abajo)	UNSPECIFIED, COUNT
`provider_source`	Modo de generación o edición	UNSPECIFIED, COUNT
`lines_added`	Líneas de código agregadas	SUM, MAX, MIN, AVG
`lines_removed`	Líneas de código eliminadas	SUM, MAX, MIN, AVG
`bytes_added`	Bytes agregados	SUM, MAX, MIN, AVG
`bytes_removed`	Bytes eliminados	SUM, MAX, MIN, AVG
`selection_lines`	Líneas seleccionadas (cero en generaciones)	SUM, MAX, MIN, AVG
`selection_bytes`	Bytes seleccionados (cero en generaciones)	SUM, MAX, MIN, AVG
`accepted`	Indica si el comando fue aceptado	SUM, COUNT

Orígenes de Command

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

Fuentes del proveedor

PROVIDER_SOURCE_COMMAND_GENERATE - Modo de generación
PROVIDER_SOURCE_COMMAND_EDIT - Modo de edición

Datos de PCW

Datos del Porcentaje de Código Escrito con seguimiento por separado de las contribuciones de Autocomplete y Command.

Field Name	Description	Valid Aggregations
`percent_code_written`	Calculado como codeium_bytes / (codeium_bytes + user_bytes)	UNSPECIFIED
`codeium_bytes`	Total de bytes generados por Codeium	UNSPECIFIED
`user_bytes`	Total de bytes escritos por el usuario	UNSPECIFIED
`total_bytes`	codeium_bytes + user_bytes	UNSPECIFIED
`codeium_bytes_by_autocomplete`	Bytes de Codeium provenientes de Autocomplete	UNSPECIFIED
`codeium_bytes_by_command`	Bytes de Codeium provenientes de Command	UNSPECIFIED

Filtros de PCW

Nombre del campo	Descripción	Ejemplos
`language`	Lenguaje de programación	KOTLIN, GO, JAVA
`ide`	IDE utilizado	jetbrains, vscode
`version`	Versión de Windsurf	1.28.0, 130.0

Para filtrar por fecha en consultas de PCW, utiliza start_timestamp y end_timestamp en el cuerpo principal de la solicitud.

Ejemplos de solicitudes

Ejemplo de datos de usuario

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "tu_service_key_aquí",
  "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": "date",
          "filter": "QUERY_FILTER_GE",
          "value": "2024-01-01"
        },
        {
          "name": "date",
          "filter": "QUERY_FILTER_LE",
          "value": "2024-02-01"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Ejemplo de datos de Chat

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

Ejemplo de datos de Command

curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "query_requests": [
    {
      "data_source": "QUERY_DATA_SOURCE_COMMAND_DATA",
      "selections": [
        {
          "field": "lines_added",
          "name": "total_lines_added",
          "aggregation_function": "QUERY_AGGREGATION_SUM"
        },
        {
          "field": "lines_removed",
          "name": "total_lines_removed",
          "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": "programming_language"
        }
      ]
    }
  ]
}' \
https://server.codeium.com/api/v1/Analytics

Ejemplo de datos de PCW

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

Respuesta

queryResults

array

Array de resultados de consulta, uno por cada solicitud de consulta

responseItems

array

Array de elementos de resultado

item

object

Objeto que contiene los campos seleccionados y sus valores

Ejemplos de respuestas

Respuesta de datos de usuario

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

Respuesta de datos del Chat

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

Respuesta de datos de 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"
          }
        }
      ]
    }
  ]
}

Respuesta de datos de PCW

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

Notas importantes

PCW (Percent Code Written) tiene una alta variabilidad en un mismo día o entre usuarios; agrégalo por semanas para obtener mejores conclusiones
Todos los campos de selections deben tener funciones de aggregations o ninguno debe tenerlas (no se pueden mezclar)
Los campos con el patrón “distinct_*” no se pueden usar en aggregations
Los alias de campos deben ser únicos en todas las selections y aggregations
Si no se especifica ninguna función de aggregations, el valor predeterminado es UNSPECIFIED

Obtener Analytics de Cascade Manejo de errores

⌘I

​Descripción general

​Request

​Estructura de la solicitud de consulta

​Selections

​Ejemplo de selección

​Filtros

​Ejemplo de filtro

​Aggregations

​Ejemplo de agregación

​Campos disponibles

​Datos de usuario

​Datos de Chat

​Tipos de intención de Chat

​Datos de Command

​Orígenes de Command

​Fuentes del proveedor

​Datos de PCW

​Filtros de PCW

​Ejemplos de solicitudes

​Ejemplo de datos de usuario

​Ejemplo de datos de Chat

​Ejemplo de datos de Command

​Ejemplo de datos de PCW

​Respuesta

​Ejemplos de respuestas

​Respuesta de datos de usuario

​Respuesta de datos del Chat

​Respuesta de datos de Command

​Respuesta de datos de PCW

​Notas importantes

Descripción general

Request

Estructura de la solicitud de consulta

Selections

Ejemplo de selección

Filtros

Ejemplo de filtro

Aggregations

Ejemplo de agregación

Campos disponibles

Datos de usuario

Datos de Chat

Tipos de intención de Chat

Datos de Command

Orígenes de Command

Fuentes del proveedor

Datos de PCW

Filtros de PCW

Ejemplos de solicitudes

Ejemplo de datos de usuario

Ejemplo de datos de Chat

Ejemplo de datos de Command

Ejemplo de datos de PCW

Respuesta

Ejemplos de respuestas

Respuesta de datos de usuario

Respuesta de datos del Chat

Respuesta de datos de Command

Respuesta de datos de PCW

Notas importantes