Skip to main content
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

string
obrigatório
Sua chave de serviço com a permissão “Teams Read-only”
string
Filtra os resultados para usuários em 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
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"), o campo mode de cascade_runs não é preenchido. cascade_lines e cascade_tool_usage abrangem a atividade do Devin CLI e do Devin Local, mas incluem apenas dados registrados depois que esses agentes começaram a reportá-los.
array
obrigatório
Array 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_PLANNING - Modo de planejamento (planeja as alterações antes de implementá-las)
  • CONVERSATIONAL_PLANNER_MODE_AUTO - Modo Auto (faz o build das alterações e as valida com testes automáticos de ponta a ponta)
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modo legado
  • UNKNOWN - Modo desconhecido
Novos modos podem ser adicionados ao longo do tempo; portanto, os clientes devem estar preparados para lidar com valores de modo não listados aqui.

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
As contagens de ferramentas por usuário, assim como o acesso com uma chave de API do usuário de serviço do Devin, estão disponíveis no endpoint Get Tools da v2.

Mapeamentos de uso das ferramentas

Exemplo de requisição

Resposta

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)