> ## 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ă date și metrici de utilizare specifice Cascade, inclusiv numărul de linii sugerate/acceptate, utilizarea modelelor AI, consumul de credite și statistici privind utilizarea instrumentelor.

<div id="overview">
  ## Prezentare generală
</div>

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

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

<ParamField body="service_key" type="string" required>
  Cheia ta de serviciu cu permisiuni „Teams Read-only”
</ParamField>

<ParamField body="group_name" type="string">
  Filtrează rezultatele la utilizatorii dintr-un grup anume. Nu poate fi folosit împreună cu parametrul `emails`.
</ParamField>

<ParamField body="start_timestamp" type="string">
  Ora de început în format RFC 3339 (de ex. „2023-01-01T00:00:00Z”)
</ParamField>

<ParamField body="end_timestamp" type="string">
  Ora de sfârșit în format RFC 3339 (de ex. „2023-12-31T23:59:59Z”)
</ParamField>

<ParamField body="emails" type="array">
  Array de adrese de email pentru filtrarea rezultatelor. Nu poate fi folosit împreună cu parametrul `group_name`.
</ParamField>

<ParamField body="ide_types" type="array">
  Filtrează după tipul de IDE. Opțiuni disponibile:

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

  Dacă este omis, returnează date pentru ambele IDE-uri.
</ParamField>

<ParamField body="query_requests" type="array" required>
  Array de interogări ale surselor de date de executat. Fiecare obiect trebuie să conțină una dintre sursele de date acceptate.
</ParamField>

<div id="data-sources">
  ## Surse de date
</div>

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

Interogare pentru liniile zilnice Cascade sugerate și acceptate.

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

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

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

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

Interogare a utilizării modelului AI, a consumului de credite și a datelor despre moduri.

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

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

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

**Moduri Cascade:**

* `CONVERSATIONAL_PLANNER_MODE_DEFAULT` - Mod de scriere
* `CONVERSATIONAL_PLANNER_MODE_READ_ONLY` - Mod de citire
* `CONVERSATIONAL_PLANNER_MODE_NO_TOOL` - Mod vechi
* `UNKNOWN` - Mod necunoscut

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

Interogare pentru statistici privind utilizarea uneltelor (totaluri agregate).

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

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

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

<div id="tool-usage-mappings">
  ## Mapări pentru utilizarea uneltelor
</div>

| Tool Identifier     | Display Name                 |
| ------------------- | ---------------------------- |
| `CODE_ACTION`       | Editare cod                  |
| `VIEW_FILE`         | Vizualizare fișier           |
| `RUN_COMMAND`       | Executare Command            |
| `FIND`              | Unealtă 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 de cod             |
| `SEARCH_WEB`        | Căutare pe web               |
| `MEMORY`            | Memorie                      |
| `PROXY_WEB_SERVER`  | Previzualizare în browser    |
| `DEPLOY_WEB_APP`    | Implementare aplicație web   |

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

<div id="response">
  ## Răspuns
</div>

<ResponseField name="queryResults" type="array">
  Listă de rezultate ale interogărilor, câte unul pentru fiecare cerere de interogare

  <Expandable title="Rezultat Cascade Lines">
    <ResponseField name="cascadeLines" type="object">
      <ResponseField name="cascadeLines" type="array">
        Listă cu statistici zilnice pe linii

        <ResponseField name="day" type="string">
          Dată în format RFC 3339
        </ResponseField>

        <ResponseField name="linesSuggested" type="string">
          Numărul de linii sugerate în această zi
        </ResponseField>

        <ResponseField name="linesAccepted" type="string">
          Numărul de linii acceptate în această zi
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Rezultat Cascade Runs">
    <ResponseField name="cascadeRuns" type="object">
      <ResponseField name="cascadeRuns" type="array">
        Listă cu statistici de utilizare a modelului AI

        <ResponseField name="day" type="string">
          Dată în format RFC 3339
        </ResponseField>

        <ResponseField name="model" type="string">
          Numele modelului folosit pentru această execuție
        </ResponseField>

        <ResponseField name="mode" type="string">
          Identificatorul modului Cascade
        </ResponseField>

        <ResponseField name="messagesSent" type="string">
          Numărul de mesaje trimise
        </ResponseField>

        <ResponseField name="cascadeId" type="string">
          Identificator unic al conversației
        </ResponseField>

        <ResponseField name="promptsUsed" type="string">
          Credite consumate în cenți (de ex. „100” = 1 credit)
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Rezultat Cascade Tool Usage">
    <ResponseField name="cascadeToolUsage" type="object">
      <ResponseField name="cascadeToolUsage" type="array">
        Listă cu statistici de utilizare a instrumentelor

        <ResponseField name="tool" type="string">
          Identificatorul instrumentului
        </ResponseField>

        <ResponseField name="count" type="string">
          Numărul de utilizări ale instrumentului
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Exemplu de răspuns
</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>

* API-ul returnează date brute care pot conține valori „UNKNOWN”
* Pentru analiza metricilor, agregați în funcție de câmpuri specifice de interes (de ex., suma `promptsUsed` pentru modele de utilizare)
* Datele privind modul și promptul pot fi împărțite în mai multe intrări
* Consumul de credite (`promptsUsed`) este returnat în cenți (100 = 1 credit)