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

# Nutzungsexporte

> Exportiere Nutzungsanalysen aus deinem Langdock-Workspace als CSV für externe Analysen, Berichte und Compliance.

<Info>
  Nutzungsexporte sind für Workspace-Administratoren verfügbar und bieten bis zu 12 Monate historische Daten über Nutzer, Agenten, API-Schlüssel, Projekte und Modelle.
</Info>

## Zugriff auf Nutzungsexporte

Du kannst Nutzungsdaten in der Langdock-Oberfläche exportieren oder programmatisch über die [Usage Export API](/de/developer/usage-export-api/intro-to-usage-export-api) abrufen.

Um den Export in der Oberfläche zu starten, öffne die Analyseseite deines Workspaces und klicke oben rechts auf **Export**.

<Steps>
  <Step title="Öffne Analysen">
    Gehe in den Workspace-Einstellungen zu deiner [Workspace-Analyseseite](https://app.langdock.com/settings/workspace/analytics).
  </Step>

  <Step title="Klicke auf Export">
    Wähle oben rechts den **Export**-Button.
  </Step>

  <Step title="Konfiguriere den Export">
    Wähle Datentyp und Datumsbereich im Export-Dialog.
  </Step>

  <Step title="CSV generieren">
    Klicke auf **CSV generieren**, um die Exportdatei zu erstellen und herunterzuladen.
  </Step>
</Steps>

## Export-Konfiguration

### Datentypen

Wähle aus, welche Nutzungsdaten exportiert werden sollen:

* **Nutzer** - Nutzeraktivität, Nachrichtenanzahl und Feature-Nutzung im gewählten Zeitraum
* **Agenten** - Agenten-Nutzungsstatistiken, Interaktionen und KPI-Metriken
* **API-Schlüssel** - API-Nutzung und Kosten gruppiert nach API-Schlüssel
* **Projekte** - Nutzungsdaten auf Projektebene
* **Modelle** - Modellnutzung, Anfragen und BYOK-Token-Verbrauch

### Datumsbereich

Wähle einen vordefinierten Bereich oder einen benutzerdefinierten Zeitraum:

* **Dieser Monat**
* **Letzter Monat**
* **Diese Woche**
* **Letzte Woche**
* **Nutzerdefinierten Bereich wählen**

<Warning>
  Historische Daten sind auf 12 Monate begrenzt. Du kannst keine Daten exportieren, die älter als 12 Monate sind.
</Warning>

<Note>
  Wenn ein benutzerdefinierter Zeitraum zu groß für einen einzelnen Export ist, exportiere jeweils einen Monat und füge die CSV-Dateien anschließend zusammen.
</Note>

## Export-Datenstruktur

Jeder Export erzeugt eine CSV-Datei mit einer Zeile pro Entität im gewählten Zeitraum.

<Info>
  Einige Spalten sind nur für Workspaces mit [Bring Your Own Key (BYOK)](/de/admin/byok/byok) verfügbar. Diese sind unten als **Nur bei BYOK-Workspaces** gekennzeichnet.
</Info>

## Nutzungsexporte

<Tabs>
  <Tab title="Nutzer">
    Der Nutzer-Export enthält individuelle Nutzeraktivität im gewählten Zeitraum.

    <Warning>
      Für Workspaces mit deaktivierten Daten auf Nutzerebene werden identifizierende Spalten wie Name und E-Mail aus Exporten ausgeschlossen.
    </Warning>

    ### Spaltendefinitionen

    | Spalte                         | Beschreibung                                           |
    | ------------------------------ | ------------------------------------------------------ |
    | `period_start`                 | Startdatum des Berichts                                |
    | `period_end`                   | Enddatum des Berichts                                  |
    | `org_id`                       | ID des Workspaces                                      |
    | `user_id`                      | ID des Nutzers                                         |
    | `name`                         | Name des Nutzers                                       |
    | `email`                        | E-Mail des Nutzers                                     |
    | `role`                         | Rolle des Nutzers                                      |
    | `joined_at`                    | Datum, an dem der Nutzer dem Workspace beigetreten ist |
    | `department`                   | Abteilung des Nutzers                                  |
    | `company_name`                 | Firmenname des Nutzers                                 |
    | `license_type`                 | Aktuelle Lizenzstufe                                   |
    | `payg_limit_current`           | Aktuelles Extra-Usage-Limit                            |
    | `payg_consumption_in_period`   | Extra-Usage-Verbrauch im gewählten Zeitraum            |
    | `payg_utilization_pct_current` | `payg_consumption_in_period / payg_limit_current`      |
    | `messages_total`               | Gesamtzahl der Nachrichten                             |
    | `messages_total_rank`          | Rang nach Gesamtnachrichten                            |
    | `messages_chat`                | Nachrichten in normalen Chats                          |
    | `messages_chat_rank`           | Rang nach Chat-Nachrichten                             |
    | `messages_assistants`          | Nachrichten an Agenten                                 |
    | `messages_assistants_rank`     | Rang nach Agenten-Nachrichten                          |
    | `assistants_messaged`          | Anzahl unterschiedlicher Agenten                       |
    | `assistants_to_messages`       | JSON-Zuordnung von Agent-ID zu Nachrichtenanzahl       |
    | `messages_projects`            | Nachrichten in Projekten                               |
    | `messages_projects_rank`       | Rang nach Projekt-Nachrichten                          |
    | `projects_messaged`            | Anzahl unterschiedlicher Projekte                      |
    | `projects_to_messages`         | JSON-Zuordnung von Projekt-ID zu Nachrichtenanzahl     |
    | `model_to_messages_total`      | JSON-Zuordnung von Modellname zu Nachrichtenanzahl     |
    | `action_messages`              | Durch Aktionen erzeugte Nachrichten                    |
    | `action_messaged`              | Anzahl unterschiedlicher ausgelöster Aktionen          |
    | `action_to_messages`           | JSON-Zuordnung von Aktionsname zu Nachrichtenanzahl    |

    ### Zusätzliche Spalten für BYOK-Workspaces

    | Spalte                  | Beschreibung                                |
    | ----------------------- | ------------------------------------------- |
    | `total_input_tokens`    | Gesamte Input-Tokens des Nutzers            |
    | `total_output_tokens`   | Gesamte Output-Tokens des Nutzers           |
    | `cached_prompt_tokens`  | Cache-Read-Input-Tokens                     |
    | `cache_creation_tokens` | Cache-Write-Input-Tokens                    |
    | `no_cache_tokens`       | Input-Tokens, die nicht aus dem Cache kamen |
    | `total_cost_usd`        | Geschätzte Provider-Kosten in USD           |

    ### Zeilen unterteilen

    Nutze im Export-Dialog **Zeilen unterteilen**, um jeden Nutzer in eine Zeile pro verwendetem Modell aufzuteilen. Wähle **Keine Gruppierung**, um eine Zeile pro Nutzer zu behalten.

    Bei Unterteilung nach **Modell** werden Ranking-, JSON-Aufschlüsselungs- und Aktionsspalten sowie `projects_messaged` ausgelassen.

    ***
  </Tab>

  <Tab title="Agenten">
    Der Agenten-Export zeigt Nutzungsstatistiken pro Agent.

    <Warning>
      Für Workspaces mit deaktivierten Daten auf Nutzerebene werden identifizierende Spalten wie Name und E-Mail aus Exporten ausgeschlossen.
    </Warning>

    ### Spaltendefinitionen

    | Spalte                  | Beschreibung                                       |
    | ----------------------- | -------------------------------------------------- |
    | `period_start`          | Startdatum des Berichts                            |
    | `period_end`            | Enddatum des Berichts                              |
    | `org_id`                | ID des Workspaces                                  |
    | `assistant_id`          | ID des Agenten                                     |
    | `assistant_name`        | Name des Agenten                                   |
    | `assistant_description` | Beschreibung des Agenten                           |
    | `assistant_url`         | Link zum Agenten                                   |
    | `assistant_owner_id`    | ID des Agenten-Owners                              |
    | `assistant_owner_email` | E-Mail des Agenten-Owners                          |
    | `messages`              | Anzahl der Nutzernachrichten an den Agenten        |
    | `unique_users`          | Anzahl der Nutzer, die den Agenten verwendet haben |
    | `active_users`          | Aktive Nutzer aus den Agenten-Analytics-KPIs       |
    | `conversations`         | Unterhaltungen aus den Agenten-Analytics-KPIs      |
    | `messages_per_user`     | Durchschnittliche Nachrichten pro aktivem Nutzer   |

    ### Zusätzliche Spalten für BYOK-Workspaces

    | Spalte                      | Beschreibung                                |
    | --------------------------- | ------------------------------------------- |
    | `sum_prompt_tokens`         | Gesamte Input-Tokens                        |
    | `avg_prompt_tokens`         | Durchschnittliche Input-Tokens pro Anfrage  |
    | `min_prompt_tokens`         | Minimale Input-Tokens pro Anfrage           |
    | `max_prompt_tokens`         | Maximale Input-Tokens pro Anfrage           |
    | `sum_completion_tokens`     | Gesamte Output-Tokens                       |
    | `avg_completion_tokens`     | Durchschnittliche Output-Tokens pro Anfrage |
    | `min_completion_tokens`     | Minimale Output-Tokens pro Anfrage          |
    | `max_completion_tokens`     | Maximale Output-Tokens pro Anfrage          |
    | `sum_cached_prompt_tokens`  | Cache-Read-Input-Tokens                     |
    | `sum_cache_creation_tokens` | Cache-Write-Input-Tokens                    |
    | `sum_no_cache_tokens`       | Input-Tokens, die nicht aus dem Cache kamen |

    ### Zeilen unterteilen

    Nutze im Export-Dialog **Zeilen unterteilen**, um jeden Agenten in eine Zeile pro verwendetem Modell aufzuteilen. Wähle **Keine Gruppierung**, um eine Zeile pro Agent zu behalten.

    Bei Unterteilung nach **Modell** werden Agenten-KPI-Spalten (`active_users`, `conversations`, `messages_per_user`) ausgelassen.

    ***
  </Tab>

  <Tab title="API-Schlüssel">
    Der API-Schlüssel-Export zeigt Nutzung und Kosten pro API-Schlüssel.

    | Spalte           | Beschreibung              |
    | ---------------- | ------------------------- |
    | `period_start`   | Startdatum des Berichts   |
    | `period_end`     | Enddatum des Berichts     |
    | `org_id`         | ID des Workspaces         |
    | `api_key_id`     | ID des API-Schlüssels     |
    | `api_key_name`   | Name des API-Schlüssels   |
    | `requests`       | Anzahl der API-Anfragen   |
    | `total_cost_usd` | API-Nutzungskosten in USD |

    ### Zusätzliche Spalten für BYOK-Workspaces

    | Spalte                  | Beschreibung                                |
    | ----------------------- | ------------------------------------------- |
    | `sum_prompt_tokens`     | Gesamte Input-Tokens                        |
    | `sum_completion_tokens` | Gesamte Output-Tokens                       |
    | `cached_prompt_tokens`  | Cache-Read-Input-Tokens                     |
    | `cache_creation_tokens` | Cache-Write-Input-Tokens                    |
    | `no_cache_tokens`       | Input-Tokens, die nicht aus dem Cache kamen |

    ### Zeilen unterteilen

    Nutze im Export-Dialog **Zeilen unterteilen**, um jeden API-Schlüssel in eine Zeile pro Modell aufzuteilen. Wähle **Keine Gruppierung**, um eine Zeile pro API-Schlüssel zu behalten.

    ***
  </Tab>

  <Tab title="Projekte">
    Der Projekte-Export zeigt Nutzungsdaten für Projekte.

    <Warning>
      Für Workspaces mit deaktivierten Daten auf Nutzerebene werden identifizierende Spalten wie Name und E-Mail aus Exporten ausgeschlossen.
    </Warning>

    | Spalte                | Beschreibung                            |
    | --------------------- | --------------------------------------- |
    | `period_start`        | Startdatum des Berichts                 |
    | `period_end`          | Enddatum des Berichts                   |
    | `org_id`              | ID des Workspaces                       |
    | `project_id`          | ID des Projekts                         |
    | `project_name`        | Name des Projekts                       |
    | `project_owner_id`    | ID des Projekt-Owners                   |
    | `project_owner_email` | E-Mail des Projekt-Owners               |
    | `messages`            | Anzahl der Nachrichten in Projekt-Chats |
  </Tab>

  <Tab title="Modelle">
    Der Modelle-Export zeigt Nutzungsstatistiken pro KI-Modell.

    | Spalte            | Beschreibung                             |
    | ----------------- | ---------------------------------------- |
    | `period_start`    | Startdatum des Berichts                  |
    | `period_end`      | Enddatum des Berichts                    |
    | `org_id`          | ID des Workspaces                        |
    | `name`            | Normalisierter Modellname                |
    | `provider`        | Modellanbieter                           |
    | `bring_your_keys` | Ob die Nutzung über ein BYOK-Modell lief |
    | `requests`        | Anzahl der Anfragen                      |

    ### Zusätzliche Spalten für BYOK-Workspaces

    | Spalte                      | Beschreibung                                |
    | --------------------------- | ------------------------------------------- |
    | `sum_prompt_tokens`         | Gesamte Input-Tokens                        |
    | `sum_completion_tokens`     | Gesamte Output-Tokens                       |
    | `sum_cached_prompt_tokens`  | Cache-Read-Input-Tokens                     |
    | `sum_cache_creation_tokens` | Cache-Write-Input-Tokens                    |
    | `no_cache_tokens`           | Input-Tokens, die nicht aus dem Cache kamen |
    | `total_cost_usd`            | Geschätzte Provider-Kosten in USD           |

    ### Zeilen unterteilen

    Nutze im Export-Dialog **Zeilen unterteilen**, um Modellnutzung detaillierter aufzuteilen. Wähle **Keine Gruppierung**, um eine Zeile pro normalisiertem Modellnamen, Provider und BYOK-Status zu behalten.

    Verfügbare Unterteilungen:

    * **Quelle** - eine Zeile pro Modell und Quelle, zum Beispiel `WEB` oder `MOBILE`
    * **Deployment** - eine Zeile pro Modell und Deployment; nur für BYOK-Workspaces verfügbar

    ***
  </Tab>
</Tabs>

## Im Nutzer-Export referenzierte Aktionen

Die folgenden Aktionen können in der Spalte `action_to_messages` erscheinen:

<Accordion title="Canvas">
  Wird verwendet, um Dokumente und Code in einer strukturierten Oberfläche zu bearbeiten.
</Accordion>

<Accordion title="Websuche">
  Wird verwendet, um externe Webquellen nach Echtzeitinformationen zu durchsuchen.
</Accordion>

<Accordion title="Dateianalyse">
  Wird verwendet, um hochgeladene Dokumente, Tabellen und andere Dateitypen zu analysieren.
</Accordion>

<Accordion title="Code-Ausführung">
  Wird verwendet, um Code in verschiedenen Programmiersprachen auszuführen und zu testen.
</Accordion>

<Accordion title="Integrations-Aktionen">
  Aktionen aus verbundenen Integrationen, zum Beispiel `Hubspot_create_contact` oder `Slack_send_message`.
</Accordion>

## Datenverarbeitung und Datenschutz

### Null-Werte

Leere oder nicht verfügbare Datenfelder werden so behandelt:

* Numerische Felder: `0` oder leer
* Textfelder: leere Zeichenketten
* JSON-Objekte: leere Objekte `{}`

### Datenspeicherung

* Historische Daten sind bis zu 12 Monate verfügbar.
* Exportdaten spiegeln den Stand zum Zeitpunkt des Exports wider.
* Nutzerrollen, Namen und andere Attribute zeigen Werte zum Enddatum des Zeitraums.