> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Recupera le analisi di Cascade

> Recupera metriche di utilizzo specifiche di Cascade, incluse righe suggerite/accettate, utilizzo del modello, consumo di crediti e statistiche sull'utilizzo degli strumenti.

<div id="overview">
  ## Panoramica
</div>

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

<div id="request">
  ## Richiesta
</div>

<ParamField body="service_key" type="string" required>
  La tua chiave di servizio con l'autorizzazione "Teams Read-only"
</ParamField>

<ParamField body="group_name" type="string">
  Filtra i risultati per gli utenti di un gruppo specifico. Non può essere utilizzato con il parametro `emails`.
</ParamField>

<ParamField body="start_timestamp" type="string">
  Ora di inizio nel formato RFC 3339 (ad es. `2023-01-01T00:00:00Z`)
</ParamField>

<ParamField body="end_timestamp" type="string">
  Ora di fine nel formato RFC 3339 (ad es. `2023-12-31T23:59:59Z`)
</ParamField>

<ParamField body="emails" type="array">
  Array di indirizzi email per filtrare i risultati. Non può essere utilizzato con il parametro `group_name`.
</ParamField>

<ParamField body="ide_types" type="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.

  <Note>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.</Note>
</ParamField>

<ParamField body="query_requests" type="array" required>
  Array di query delle fonti di dati da eseguire. Ogni oggetto deve contenere una delle fonti di dati supportate.
</ParamField>

<div id="data-sources">
  ## Fonti dati
</div>

<div id="cascade_lines">
  ### cascade\_lines
</div>

Recupera le righe giornaliere di Cascade suggerite e accettate.

```json theme={null}
{
  "cascade_lines": {}
}
```

**Campi della risposta:**

* `day` - Data nel formato RFC 3339
* `linesSuggested` - Numero di righe suggerite
* `linesAccepted` - Numero di righe accettate

<div id="cascade_runs">
  ### cascade\_runs
</div>

Recupera i dati sull'utilizzo del modello, sul consumo di crediti e sulle modalità.

```json theme={null}
{
  "cascade_runs": {}
}
```

**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

<div id="cascade_tool_usage">
  ### cascade\_tool\_usage
</div>

Recupera le statistiche sull'utilizzo degli strumenti (conteggi aggregati).

```json theme={null}
{
  "cascade_tool_usage": {}
}
```

**Campi della risposta:**

* `tool` - Identificatore dello strumento (vedi la mappatura degli strumenti di seguito)
* `count` - Numero di volte in cui lo strumento è stato utilizzato

<div id="tool-usage-mappings">
  ## Mappature dell'utilizzo degli strumenti
</div>

| Tool Identifier     | Nome visualizzato           |
| ------------------- | --------------------------- |
| `CODE_ACTION`       | Modifica del codice         |
| `VIEW_FILE`         | Visualizza file             |
| `RUN_COMMAND`       | Esegui comando              |
| `FIND`              | Strumento Trova             |
| `GREP_SEARCH`       | Ricerca Grep                |
| `VIEW_FILE_OUTLINE` | Struttura del file          |
| `MQUERY`            | Riptide                     |
| `WORKFLOWS_USED`    | Flussi di lavoro utilizzati |
| `LIST_DIRECTORY`    | Elenca directory            |
| `MCP_TOOL`          | Strumento MCP               |
| `PROPOSE_CODE`      | Proponi codice              |
| `SEARCH_WEB`        | Cerca nel web               |
| `MEMORY`            | Memoria                     |
| `PROXY_WEB_SERVER`  | Anteprima del browser       |
| `DEPLOY_WEB_APP`    | Distribuisci app web        |

<div id="example-request">
  ## Esempio di richiesta
</div>

```bash theme={null}
curl -X POST --header "Content-Type: application/json" \
--data '{
  "service_key": "your_service_key_here",
  "group_name": "engineering_team",
  "start_timestamp": "2025-01-01T00:00:00Z",
  "end_timestamp": "2025-01-02T00:00:00Z",
  "emails": ["user1@cognition.ai", "user2@cognition.ai"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics
```

<div id="response">
  ## Risposta
</div>

<ResponseField name="queryResults" type="array">
  Array di risultati delle query, uno per ogni query richiesta

  <Expandable title="Risultato delle righe di Cascade">
    <ResponseField name="cascadeLines" type="object">
      <ResponseField name="cascadeLines" type="array">
        Array di statistiche giornaliere sulle righe

        <ResponseField name="day" type="string">
          Data in formato RFC 3339
        </ResponseField>

        <ResponseField name="linesSuggested" type="string">
          Numero di righe suggerite in quel giorno
        </ResponseField>

        <ResponseField name="linesAccepted" type="string">
          Numero di righe accettate in quel giorno
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Risultato dell'utilizzo dello strumento di Cascade">
    <ResponseField name="cascadeRuns" type="object">
      <ResponseField name="cascadeRuns" type="array">
        Array di statistiche di utilizzo del modello

        <ResponseField name="day" type="string">
          Data in formato RFC 3339
        </ResponseField>

        <ResponseField name="model" type="string">
          Nome del modello utilizzato per il run
        </ResponseField>

        <ResponseField name="mode" type="string">
          Identificatore della modalità Cascade
        </ResponseField>

        <ResponseField name="messagesSent" type="string">
          Numero di messaggi inviati
        </ResponseField>

        <ResponseField name="cascadeId" type="string">
          Identificatore univoco della conversazione
        </ResponseField>

        <ResponseField name="promptsUsed" type="string">
          Crediti consumati in centesimi (ad es. "100" = 1 credito)
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Risultato dell'utilizzo dello strumento di Cascade">
    <ResponseField name="cascadeToolUsage" type="object">
      <ResponseField name="cascadeToolUsage" type="array">
        Array di statistiche di utilizzo degli strumenti

        <ResponseField name="tool" type="string">
          Identificatore dello strumento
        </ResponseField>

        <ResponseField name="count" type="string">
          Numero di volte in cui lo strumento è stato utilizzato
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Risposta di esempio
</div>

```json theme={null}
{
  "queryResults": [
    {
      "cascadeLines": {
        "cascadeLines": [
          {
            "day": "2025-05-01T00:00:00Z",
            "linesSuggested": "206",
            "linesAccepted": "157"
          },
          {
            "day": "2025-05-02T00:00:00Z",
            "linesSuggested": "16"
          }
        ]
      }
    },
    {
      "cascadeRuns": {
        "cascadeRuns": [
          {
            "day": "2025-05-01T00:00:00Z",
            "model": "Claude 3.7 Sonnet (Thinking)",
            "mode": "CONVERSATIONAL_PLANNER_MODE_DEFAULT",
            "messagesSent": "1",
            "cascadeId": "0d35c1f7-0a85-41d0-ac96-a04cd2d64444"
          }
        ]
      }
    },
    {
      "cascadeToolUsage": {
        "cascadeToolUsage": [
          {
            "tool": "CODE_ACTION",
            "count": "15"
          },
          {
            "tool": "LIST_DIRECTORY",
            "count": "20"
          }
        ]
      }
    }
  ]
}
```

<div id="notes">
  ## Note
</div>

* 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)