Consulta personalizada de Analytics
Analytics API
Consulta personalizada de Analytics
Consultas flexibles de Analytics con selections, filtros y aggregations personalizados para datos de Autocomplete, Chat, Command y PCW.
POST
Consulta personalizada de Analytics
Descripción general
Request
string
requerido
Tu clave de servicio con permisos “Analytics Read”
string
Filtra los resultados para usuarios de un grupo específico (opcional)
array
requerido
Array de objetos de solicitud de consulta que definen los datos a recuperar
Estructura de la solicitud de consulta
- data_source (obligatorio): Fuente de datos a consultar
- selections (obligatorio): Arreglo de selecciones de campos para recuperar
- filters (opcional): Arreglo de filtros a aplicar
- aggregations (opcional): Arreglo de aggregations para agrupar
Selections
- field (obligatorio): Nombre del campo a seleccionar
- name (opcional): Alias del campo
- aggregation_function (opcional): Función de agregación que se aplicará
Ejemplo de selección
Filtros
- name (obligatorio): Nombre del campo por el que filtrar
- filter (obligatorio): Operación de filtro
- value (obligatorio): Valor a comparar
Ejemplo de filtrado
Aggregations
- field (obligatorio): Nombre del campo por el que agrupar
- name (obligatorio): Alias para el campo de agregación
Ejemplo de agregación
Campos disponibles
Datos de usuario
Datos de Chat
Los datos de Chat están separados de los datos de Cascade y representan el uso de nuestros plugins heredados, no agentivos
Tipos de intención de Chat
CHAT_INTENT_GENERIC- Chat normalCHAT_INTENT_FUNCTION_EXPLAIN- Indicador Code Lens de explicación de funciónCHAT_INTENT_FUNCTION_DOCSTRING- Indicador Code Lens de docstring de funciónCHAT_INTENT_FUNCTION_REFACTOR- Indicador Code Lens de refactorización de funciónCHAT_INTENT_CODE_BLOCK_EXPLAIN- Indicador Code Lens de explicación de bloque de códigoCHAT_INTENT_CODE_BLOCK_REFACTOR- Indicador Code Lens de refactorización de bloque de códigoCHAT_INTENT_PROBLEM_EXPLAIN- Indicador Code Lens de explicación de problemaCHAT_INTENT_FUNCTION_UNIT_TESTS- Indicador Code Lens de pruebas unitarias de función
Datos de Command
accepted para filtrar únicamente los comandos aceptados.
Fuentes de Command
COMMAND_REQUEST_SOURCE_LINE_HINT_CODE_LENSCOMMAND_REQUEST_SOURCE_DEFAULT- Uso típico de CommandCOMMAND_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
Fuentes del proveedor
PROVIDER_SOURCE_COMMAND_GENERATE- Modo generaciónPROVIDER_SOURCE_COMMAND_EDIT- Modo edición
Datos de PCW
Filtros de PCW
Para filtrar por fecha en las consultas de PCW, utiliza
start_timestamp y end_timestamp en el cuerpo principal de la solicitud.
Ejemplos de solicitudes
Ejemplo de datos del usuario
Ejemplo de datos de Chat
Ejemplo de datos de Command
Ejemplo de datos de PCW
Respuesta
array
Ejemplos de respuestas
Respuesta de datos del usuario
Respuesta de datos de Chat
Respuesta de datos de Command
Respuesta de datos de PCW
Notas importantes
- PCW (Percent Code Written) presenta una gran variabilidad dentro de un mismo día o entre usuarios; agrégalo por semanas para obtener información más útil
- Todos los campos de selección deben tener funciones de agregación 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 agregación, el valor predeterminado es UNSPECIFIED