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 Chave de serviço com permissões “Teams somente leitura”
string
Filtre 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 email 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 do 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 por linhas diárias do Cascade sugeridas e aceitas.
Campos da resposta:
  • day - Data no formato RFC 3339
  • linesSuggested - Número de linhas sugeridas
  • linesAccepted - Número de linhas aceitas

cascade_runs

Consulta o uso do modelo de IA, o consumo de créditos e os dados dos modos.
Campos da resposta:
  • day - Data no formato RFC 3339
  • model - Nome do modelo de IA utilizado
  • mode - Modo do Cascade (consulte os modos abaixo)
  • messagesSent - Número de mensagens enviadas
  • cascadeId - ID único 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 utilizada

Mapeamentos de Uso de Ferramentas

Exemplo de solicitação

Resposta

array
Array de resultados de consulta, um para cada solicitação de consulta

Exemplo de resposta

Observações

  • A API retorna dados brutos que podem conter valores “UNKNOWN”
  • Para análise de métricas, agregue com base em campos específicos de interesse (por exemplo, some promptsUsed para identificar padrões de uso)
  • Os dados de modo e de prompt podem estar distribuídos em várias entradas
  • O consumo de créditos (promptsUsed) é retornado em centavos (100 = 1 crédito)