> ## 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.

# Cascade-Analysen abrufen

> Cascade-spezifische Nutzungsmetriken abfragen, darunter vorgeschlagene/akzeptierte Zeilen, Modellnutzung, Credit-Verbrauch und Tool-Nutzungsstatistiken.

<div id="overview">
  ## Überblick
</div>

Rufen Sie Cascade-spezifische Analysedaten ab, einschließlich Statistiken zu vorgeschlagenen/akzeptierten Zeilen, zur Modellnutzung, zum Credit-Verbrauch und zur Tool-Nutzung.

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

<ParamField body="service_key" type="string" required>
  Ihr Service-Schlüssel mit „Teams Read-only“-Berechtigungen
</ParamField>

<ParamField body="group_name" type="string">
  Filtert die Ergebnisse auf Nutzer in einer bestimmten group. Kann nicht zusammen mit dem Parameter `emails` verwendet werden.
</ParamField>

<ParamField body="start_timestamp" type="string">
  Startzeit im RFC-3339-Format (z. B. `2023-01-01T00:00:00Z`)
</ParamField>

<ParamField body="end_timestamp" type="string">
  Endzeit im RFC-3339-Format (z. B. `2023-12-31T23:59:59Z`)
</ParamField>

<ParamField body="emails" type="array">
  Array von E-Mail-Adressen zum Filtern der Ergebnisse. Kann nicht zusammen mit dem Parameter `group_name` verwendet werden.
</ParamField>

<ParamField body="ide_types" type="array">
  Nach IDE-Typ filtern. Verfügbare Optionen:

  * `"editor"` - Devin Desktop Editor
  * `"jetbrains"` - JetBrains Plugin
  * `"cli"` - Devin CLI

  Wenn nicht angegeben, werden Daten für alle IDEs zurückgegeben.

  <Note>Beim Filtern nach Devin CLI (`"cli"`) liefert nur `cascade_runs` Daten. Die Datenquellen `cascade_lines` und `cascade_tool_usage` werden für Devin CLI nicht unterstützt und geben leere Ergebnisse zurück.</Note>
</ParamField>

<ParamField body="query_requests" type="array" required>
  Array von Datenquellenabfragen, die ausgeführt werden sollen. Jedes Objekt sollte eine der unterstützten Datenquellen enthalten.
</ParamField>

<div id="data-sources">
  ## Datenquellen
</div>

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

Abfrage der täglich vorgeschlagenen und akzeptierten Cascade-Zeilen.

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

**Antwortfelder:**

* `day` - Datum im RFC-3339-Format
* `linesSuggested` - Anzahl der vorgeschlagenen Zeilen
* `linesAccepted` - Anzahl der übernommenen Zeilen

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

Abfrage zu Modellnutzung, Credit-Verbrauch und Modusdaten.

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

**Antwortfelder:**

* `day` - Datum im RFC-3339-Format
* `model` - Name des verwendeten Modells
* `mode` - Cascade-Modus (siehe Modi unten)
* `messagesSent` - Anzahl der gesendeten Nachrichten
* `cascadeId` - Eindeutige ID der Unterhaltung
* `promptsUsed` - Verbrauchte Credits (in Cent)

**Cascade-Modi:**

* `CONVERSATIONAL_PLANNER_MODE_DEFAULT` - Schreibmodus
* `CONVERSATIONAL_PLANNER_MODE_READ_ONLY` - Lesemodus
* `CONVERSATIONAL_PLANNER_MODE_NO_TOOL` - Legacy-Modus
* `UNKNOWN` - Unbekannter Modus

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

Abfrage von Statistiken zur Tool-Nutzung (aggregierte Anzahlen).

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

**Antwortfelder:**

* `tool` - Tool-Identifikator (siehe Tool-Zuordnungen unten)
* `count` - Anzahl der Tool-Verwendungen

<div id="tool-usage-mappings">
  ## Zuordnungen zur Tool-Nutzung
</div>

| Tool-Identifikator  | Anzeigename              |
| ------------------- | ------------------------ |
| `CODE_ACTION`       | Code bearbeiten          |
| `VIEW_FILE`         | Datei anzeigen           |
| `RUN_COMMAND`       | Befehl ausführen         |
| `FIND`              | Find-Tool                |
| `GREP_SEARCH`       | Grep-Suche               |
| `VIEW_FILE_OUTLINE` | Dateigliederung anzeigen |
| `MQUERY`            | Riptide                  |
| `WORKFLOWS_USED`    | Verwendete Workflows     |
| `LIST_DIRECTORY`    | Verzeichnis auflisten    |
| `MCP_TOOL`          | MCP-Tool                 |
| `PROPOSE_CODE`      | Code vorschlagen         |
| `SEARCH_WEB`        | Web durchsuchen          |
| `MEMORY`            | Speicher                 |
| `PROXY_WEB_SERVER`  | Browser-Vorschau         |
| `DEPLOY_WEB_APP`    | Web-App bereitstellen    |

<div id="example-request">
  ## Beispielanfrage
</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">
  ## Antwort
</div>

<ResponseField name="queryResults" type="array">
  Array von Abfrageergebnissen, eines für jede Abfrage

  <Expandable title="Ergebnis der Cascade-Zeilen">
    <ResponseField name="cascadeLines" type="object">
      <ResponseField name="cascadeLines" type="array">
        Array täglicher Zeilenstatistiken

        <ResponseField name="day" type="string">
          Datum im RFC-3339-Format
        </ResponseField>

        <ResponseField name="linesSuggested" type="string">
          Anzahl der an diesem Tag vorgeschlagenen Zeilen
        </ResponseField>

        <ResponseField name="linesAccepted" type="string">
          Anzahl der an diesem Tag akzeptierten Zeilen
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Ergebnis der Cascade-Ausführungen">
    <ResponseField name="cascadeRuns" type="object">
      <ResponseField name="cascadeRuns" type="array">
        Array von Statistiken zur Modellnutzung

        <ResponseField name="day" type="string">
          Datum im RFC-3339-Format
        </ResponseField>

        <ResponseField name="model" type="string">
          Name des für die Ausführung verwendeten Modells
        </ResponseField>

        <ResponseField name="mode" type="string">
          Kennung des Cascade-Modus
        </ResponseField>

        <ResponseField name="messagesSent" type="string">
          Anzahl der gesendeten Nachrichten
        </ResponseField>

        <ResponseField name="cascadeId" type="string">
          Eindeutige Kennung der Unterhaltung
        </ResponseField>

        <ResponseField name="promptsUsed" type="string">
          Verbrauchte Credits in Cent (z. B. "100" = 1 Credit)
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>

  <Expandable title="Ergebnis der Cascade-Tool-Nutzung">
    <ResponseField name="cascadeToolUsage" type="object">
      <ResponseField name="cascadeToolUsage" type="array">
        Array von Statistiken zur Tool-Nutzung

        <ResponseField name="tool" type="string">
          Tool-Identifikator
        </ResponseField>

        <ResponseField name="count" type="string">
          Anzahl der Tool-Verwendungen
        </ResponseField>
      </ResponseField>
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="example-response">
  ### Beispielantwort
</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">
  ## Hinweise
</div>

* Die API gibt Rohdaten zurück, die möglicherweise „UNKNOWN“-Werte enthalten.
* Für die Analyse von Metriken nach relevanten spezifischen Feldern aggregieren (z. B. `promptsUsed` summieren, um Nutzungsmuster zu erkennen)
* Modus- und Prompt-Daten können sich auf mehrere Einträge verteilen.
* Der Creditverbrauch (`promptsUsed`) wird in Cent zurückgegeben (100 = 1 Credit).