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

# Obține Analytics pentru Cascade

> Interoghează metrici și date de utilizare specifice Cascade, inclusiv linii sugerate/acceptate, utilizarea modelului AI, consumul de credite și statistici de utilizare a instrumentelor.

## Prezentare generală

Preluare de date Analytics specifice Cascade, inclusiv linii sugerate/acceptate, utilizarea modelului, consumul de credite și statistici privind utilizarea instrumentelor.

## Cerere

**service\_key** `string` *required*

Cheia ta de serviciu cu permisiuni „Teams Read-only”

**group\_name** `string`

Filtrează rezultatele la utilizatorii dintr-un grup specific. Nu poate fi utilizat împreună cu parametrul `emails`.

**start\_timestamp** `string`

Ora de început în format RFC 3339 (de ex. „2023-01-01T00:00:00Z”)

**end\_timestamp** `string`

Ora de sfârșit în format RFC 3339 (de ex. „2023-12-31T23:59:59Z”)

**emails** `array`

Array de adrese de e-mail pentru filtrarea rezultatelor. Nu poate fi utilizat împreună cu parametrul `group_name`.

**ide\_types** `array`

Filtrează după tipul IDE. Opțiuni disponibile:

* `"editor"` - Windsurf Editor
* `"jetbrains"` - JetBrains Plugin

Dacă este omis, returnează date pentru ambele IDE-uri.

**query\_requests** `array` *required*

Array de interogări ale surselor de date de executat. Fiecare obiect trebuie să conțină una dintre sursele de date acceptate.

## Surse de date

### cascade\_lines

Interogare pentru liniile Cascade zilnice sugerate și acceptate.

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

**Câmpuri de răspuns:**

* `day` - Dată în formatul RFC 3339
* `linesSuggested` - Numărul de linii sugerate
* `linesAccepted` - Numărul de linii acceptate

### cascade\_runs

Interogați pentru a obține informații privind utilizarea modelului AI, consumul de credite și datele despre moduri.

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

**Câmpuri de răspuns:**

* `day` - Dată în formatul RFC 3339
* `model` - Numele modelului AI utilizat
* `mode` - Modul Cascade (vedeți modurile de mai jos)
* `messagesSent` - Numărul de mesaje trimise
* `cascadeId` - ID unic al conversației
* `promptsUsed` - Credite consumate (în cenți)

**Moduri Cascade:**

* `CONVERSATIONAL_PLANNER_MODE_DEFAULT` - Mod scriere
* `CONVERSATIONAL_PLANNER_MODE_READ_ONLY` - Mod citire
* `CONVERSATIONAL_PLANNER_MODE_NO_TOOL` - Mod vechi (legacy)
* `UNKNOWN` - Mod necunoscut

### cascade\_tool\_usage

Interogare pentru statistici privind utilizarea instrumentelor (număruri agregate).

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

**Câmpuri de răspuns:**

* `tool` - Identificatorul instrumentului (consultați mapările de instrumente de mai jos)
* `count` - Numărul de utilizări ale instrumentului

## Mapări ale utilizării instrumentelor

| Tool Identifier | Nume afișat |
| - | - |
| `CODE_ACTION` | Editare cod |
| `VIEW_FILE` | Vizualizare fișier |
| `RUN_COMMAND` | Rulare Command |
| `FIND` | Instrument de căutare |
| `GREP_SEARCH` | Căutare grep |
| `VIEW_FILE_OUTLINE` | Vizualizare structură fișier |
| `MQUERY` | Riptide |
| `WORKFLOWS_USED` | Fluxuri de lucru utilizate |
| `LIST_DIRECTORY` | Listare director |
| `MCP_TOOL` | Instrument MCP |
| `PROPOSE_CODE` | Propunere cod |
| `SEARCH_WEB` | Căutare web |
| `MEMORY` | Memorie |
| `PROXY_WEB_SERVER` | Previzualizare în browser |
| `DEPLOY_WEB_APP` | Publicare aplicație web |

## Exemplu de solicitare

```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@windsurf.com", "user2@windsurf.com"],
  "ide_types": ["editor"],
  "query_requests": [
    {
      "cascade_lines": {}
    },
    {
      "cascade_runs": {}
    },
    {
      "cascade_tool_usage": {}
    }
  ]
}' \
https://server.codeium.com/api/v1/CascadeAnalytics
```

## Răspuns

**queryResults** `array`

Array de rezultate ale interogărilor, câte unul pentru fiecare interogare

**Rezultat pentru Cascade Lines**

**cascadeLines** `object`

**cascadeLines** `array`

Array de statistici zilnice pe linii

**day** `string`

Dată în format RFC 3339

**linesSuggested** `string`

Numărul de linii sugerate în ziua respectivă

**linesAccepted** `string`

Numărul de linii acceptate în ziua respectivă

**Rezultat pentru Cascade Runs**

**cascadeRuns** `object`

**cascadeRuns** `array`

Array de statistici de utilizare a modelelor AI

**day** `string`

Dată în format RFC 3339

**model** `string`

Numele modelului AI folosit pentru rulare

**mode** `string`

Identificatorul modului Cascade

**messagesSent** `string`

Numărul de mesaje trimise

**cascadeId** `string`

Identificator unic al conversației

**promptsUsed** `string`

Credite consumate în cenți (de ex. „100” = 1 credit)

**Rezultat pentru Cascade Tool Usage**

**cascadeToolUsage** `object`

**cascadeToolUsage** `array`

Array de statistici de utilizare a instrumentelor

**tool** `string`

Identificatorul instrumentului

**count** `string`

Numărul de utilizări ale instrumentului

### Exemplu de răspuns

```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"
          }
        ]
      }
    }
  ]
}
```

## Note

* API-ul returneaza date brute care pot contine valori „UNKNOWN”
* Pentru analiza metricilor, agregati in functie de campuri specifice de interes (de ex., suma `promptsUsed` pentru identificarea tiparelor de utilizare)
* Datele despre mod si prompt pot fi divizate in mai multe intrari
* Consumarea creditelor (`promptsUsed`) este returnata in centi (100 = 1 credit)
