Pular para o conteúdo principal
POST
Consultar análises do Cascade

Visão geral

Recupere dados de análises específicos do Cascade, incluindo linhas sugeridas/aceitas, uso do modelo, consumo de créditos e estatísticas de uso de ferramentas.

Requisição

service_key
string
obrigatório
Sua chave de serviço com a permissão “Teams Read-only”
group_name
string
Filtra os resultados para usuários em um grupo específico. Não pode ser usado com o parâmetro emails.
start_timestamp
string
Horário de início no formato RFC 3339 (por exemplo, 2023-01-01T00:00:00Z)
end_timestamp
string
Horário de término no formato RFC 3339 (por exemplo, 2023-12-31T23:59:59Z)
emails
array
Lista de endereços de e-mail para filtrar os resultados. Não pode ser usado com o parâmetro group_name.
ide_types
array
Filtra por tipo de IDE. Opções disponíveis:
  • "editor" - Editor do Devin Desktop
  • "jetbrains" - Plugin do JetBrains
  • "cli" - Devin CLI
Se omitido, retorna dados de todas as IDEs.
Ao filtrar por Devin CLI ("cli"), apenas cascade_runs retorna dados. As fontes de dados cascade_lines e cascade_tool_usage não têm suporte para Devin CLI e retornarão resultados vazios.
query_requests
array
obrigatório
Lista de consultas de fontes de dados a serem executadas. Cada objeto deve conter uma das fontes de dados suportadas.

Fontes de dados

cascade_lines

Consulta das 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

Consulte dados sobre uso do modelo, consumo de créditos e modo.
Campos da resposta:
  • day - Data no formato RFC 3339
  • model - Nome do modelo utilizado
  • mode - Modo do Cascade (veja 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 somente leitura
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modo legado
  • UNKNOWN - Modo desconhecido

cascade_tool_usage

Consulta estatísticas de uso da ferramenta (contagens agregadas).
Campos da resposta:
  • tool - Identificador da ferramenta (veja os mapeamentos de ferramentas abaixo)
  • count - Número de vezes que a ferramenta foi usada

Mapeamentos de uso das ferramentas

Exemplo de requisição

Resposta

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

Exemplo de resposta

Notas

  • 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)
  • Os 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)