Skip to main content
POST
Obter Analytics do Cascade

Visão geral

Recupere dados de Analytics específicos do Cascade, incluindo linhas sugeridas/aceitas, uso de modelos de IA, consumo de créditos e estatísticas de uso de ferramentas.

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
Se omitido, retorna dados para ambos os IDEs.
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

Consulta pelas linhas diárias do Cascade sugeridas e aceitas.
Campos de resposta:
  • day - Data no formato RFC 3339
  • linesSuggested - Número de linhas sugeridas
  • linesAccepted - Número de linhas aceitas

cascade_runs

Consulta de uso do modelo de IA, consumo de créditos e dados por modo.
Campos de resposta:
  • day - Data no formato RFC 3339
  • model - Nome do modelo de IA utilizado
  • mode - Modo do Cascade (veja os modos abaixo)
  • messagesSent - Número de mensagens enviadas
  • cascadeId - ID exclusivo da conversa
  • promptsUsed - Créditos consumidos (em centavos)
Modos do Cascade:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Modo de escrita
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Modo de leitura
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modo legado
  • UNKNOWN - Modo desconhecido

cascade_tool_usage

Consulta de estatísticas de uso de ferramentas (contagens agregadas).
Campos de resposta:
  • 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 promptsUsed para 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)