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

string
obbligatorio
La tua chiave di servizio con l’autorizzazione “Teams Read-only”
string
Filtra i risultati per gli utenti di un gruppo specifico. Non può essere utilizzato con il parametro emails.
string
Ora di inizio nel formato RFC 3339 (ad es. 2023-01-01T00:00:00Z)
string
Ora di fine nel formato RFC 3339 (ad es. 2023-12-31T23:59:59Z)
array
Array di indirizzi email per filtrare i risultati. Non può essere utilizzato con il parametro group_name.
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"), il campo mode di cascade_runs non viene popolato. cascade_lines e cascade_tool_usage coprono l’attività di Devin CLI e Devin Local, ma includono solo i dati registrati dopo che questi agenti hanno iniziato a segnalarli.
array
obbligatorio
Array di query delle origini dati da eseguire. Ogni oggetto deve contenere una delle origini 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_PLANNING - Modalità di pianificazione (pianifica le modifiche prima di implementarle)
  • CONVERSATIONAL_PLANNER_MODE_AUTO - Modalità Auto (implementa le modifiche e le convalida con testing end-to-end automatico)
  • CONVERSATIONAL_PLANNER_MODE_NO_TOOL - Modalità legacy
  • UNKNOWN - Modalità sconosciuta
In futuro potrebbero essere aggiunte nuove modalità: i client devono quindi gestire anche valori di modalità non elencati qui.

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
I conteggi degli strumenti per utente e l’accesso tramite un’API key dell’utente di servizio Devin sono disponibili con l’endpoint v2 Get Tools.

Mappature dell’utilizzo degli strumenti

Esempio di richiesta

Risposta

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)