Vai al contenuto principale
POST
Recupera le analisi di Cascade

Panoramica

Recupera dati analitici specifici di Cascade, incluse righe suggerite/accettate, utilizzo del modello, consumo di crediti e statistiche di utilizzo degli strumenti.

Richiesta

service_key
string
obbligatorio
La tua chiave di servizio con l’autorizzazione “Teams Read-only”
group_name
string
Filtra i risultati per gli utenti di un gruppo specifico. Non può essere utilizzato con il parametro emails.
start_timestamp
string
Ora di inizio nel formato RFC 3339 (ad es. 2023-01-01T00:00:00Z)
end_timestamp
string
Ora di fine nel formato RFC 3339 (ad es. 2023-12-31T23:59:59Z)
emails
array
Array di indirizzi email per filtrare i risultati. Non può essere utilizzato con il parametro group_name.
ide_types
array
Filtra per tipo di IDE. Opzioni disponibili:
  • "editor" - Devin Desktop Editor
  • "jetbrains" - JetBrains Plugin
  • "cli" - Devin CLI
Se omesso, restituisce dati per tutti gli IDE.
Quando filtri per Devin CLI ("cli"), solo cascade_runs restituisce dati. Le fonti di dati cascade_lines e cascade_tool_usage non sono supportate per Devin CLI e restituiranno risultati vuoti.
query_requests
array
obbligatorio
Array di query delle fonti di dati da eseguire. Ogni oggetto deve contenere una delle fonti di dati supportate.

Fonti dati

cascade_lines

Recupera le righe giornaliere di Cascade suggerite e accettate.
Campi della risposta:
  • day - Data nel formato RFC 3339
  • linesSuggested - Numero di righe suggerite
  • linesAccepted - Numero di righe accettate

cascade_runs

Recupera i dati sull’utilizzo del modello, sul consumo di crediti e sulle modalità.
Campi della risposta:
  • day - Data in formato RFC 3339
  • model - Nome del modello utilizzato
  • mode - Modalità Cascade (vedi le modalità riportate di seguito)
  • messagesSent - Numero di messaggi inviati
  • cascadeId - ID univoco della conversazione
  • promptsUsed - Crediti consumati (in centesimi)
Modalità Cascade:
  • CONVERSATIONAL_PLANNER_MODE_DEFAULT - Modalità di scrittura
  • CONVERSATIONAL_PLANNER_MODE_READ_ONLY - Modalità di sola lettura
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modalità legacy
  • UNKNOWN - Modalità sconosciuta

cascade_tool_usage

Recupera le statistiche sull’utilizzo degli strumenti (conteggi aggregati).
Campi della risposta:
  • tool - Identificatore dello strumento (vedi la mappatura degli strumenti di seguito)
  • count - Numero di volte in cui lo strumento è stato utilizzato

Mappature dell’utilizzo degli strumenti

Esempio di richiesta

Risposta

queryResults
array
Array di risultati delle query, uno per ogni query richiesta

Risposta di esempio

Note

  • L’API restituisce dati grezzi che possono contenere valori “UNKNOWN”
  • Per l’analisi delle metriche, aggrega i dati in base a campi specifici di interesse (ad es. somma promptsUsed per analizzare i pattern di utilizzo)
  • I dati relativi alla modalità e ai prompt possono essere suddivisi in più voci
  • Il consumo di crediti (promptsUsed) viene restituito in centesimi (100 = 1 credito)