Obter Analytics do Cascade
Analytics API
Obter Analytics do Cascade
Consultar métricas de uso específicas do Cascade, incluindo linhas sugeridas/aceitas, uso de modelo de IA, consumo de créditos e estatísticas de uso de ferramentas.
POST
Obter Analytics do Cascade
Visão geral
Solicitação
string
obrigatório
Sua Service Key com permissões “Teams Read-only”
string
Filtra os resultados para usuários de um grupo específico. Não pode ser usado com o parâmetro
emails.string
Horário de início no formato RFC 3339 (por exemplo,
2023-01-01T00:00:00Z)string
Horário de término no formato RFC 3339 (por exemplo,
2023-12-31T23:59:59Z)array
Array de endereços de e-mail para filtrar os resultados. Não pode ser usado com o parâmetro
group_name.array
Filtrar por tipo de IDE. Opções disponíveis:
"editor"- Windsurf Editor"jetbrains"- Plugin JetBrains
array
obrigatório
Array de consultas de fontes de dados a serem executadas. Cada objeto deve conter uma das fontes de dados compatíveis.
Fontes de dados
cascade_lines
day- Data no formato RFC 3339linesSuggested- Número de linhas sugeridaslinesAccepted- Número de linhas aceitas
cascade_runs
day- Data no formato RFC 3339model- Nome do modelo de IA utilizadomode- Modo do Cascade (veja os modos abaixo)messagesSent- Número de mensagens enviadascascadeId- ID exclusivo da conversapromptsUsed- Créditos consumidos (em centavos)
CONVERSATIONAL_PLANNER_MODE_DEFAULT- Modo de escritaCONVERSATIONAL_PLANNER_MODE_READ_ONLY- Modo de leituraCONVERSATIONAL_PLANNER_MODE_NO_TOOL- Modo legadoUNKNOWN- Modo desconhecido
cascade_tool_usage
tool- Identificador da ferramenta (consulte os mapeamentos de ferramentas abaixo)count- Número de vezes que a ferramenta foi usada
Mapeamentos de uso de ferramentas
Exemplo de solicitação
Resposta
array
Array de resultados de consulta, um para cada requisição de consulta
Exemplo de resposta
Observações
- A API retorna dados brutos que podem conter valores “UNKNOWN”
- Para análise de métricas, agrupe por campos específicos de interesse (por exemplo, some
promptsUsedpara identificar padrões de uso) - Dados de modo e de prompt podem estar divididos em várias entradas
- O consumo de créditos (
promptsUsed) é retornado em centavos (100 = 1 crédito)