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.
Zugriff auf Nutzungsexporte
Du kannst Nutzungsdaten in der Langdock-Oberfläche exportieren oder programmatisch über die Usage Export API abrufen. Um den Export in der Oberfläche zu starten, öffne die Analyseseite deines Workspaces und klicke oben rechts auf Export.Öffne Analysen
Gehe in den Workspace-Einstellungen zu deiner Workspace-Analyseseite.
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
Export-Datenstruktur
Jeder Export erzeugt eine CSV-Datei mit einer Zeile pro Entität im gewählten Zeitraum.Einige Spalten sind nur für Workspaces mit Bring Your Own Key (BYOK) verfügbar. Diese sind unten als Nur bei BYOK-Workspaces gekennzeichnet.
Nutzungsexporte
- Nutzer
- Agenten
- API-Schlüssel
- Projekte
- Modelle
Der Nutzer-Export enthält individuelle Nutzeraktivität im gewählten Zeitraum.
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 sowieprojects_messaged ausgelassen.Im Nutzer-Export referenzierte Aktionen
Die folgenden Aktionen können in der Spalteaction_to_messages erscheinen:
Canvas
Canvas
Wird verwendet, um Dokumente und Code in einer strukturierten Oberfläche zu bearbeiten.
Websuche
Websuche
Wird verwendet, um externe Webquellen nach Echtzeitinformationen zu durchsuchen.
Dateianalyse
Dateianalyse
Wird verwendet, um hochgeladene Dokumente, Tabellen und andere Dateitypen zu analysieren.
Code-Ausführung
Code-Ausführung
Wird verwendet, um Code in verschiedenen Programmiersprachen auszuführen und zu testen.
Integrations-Aktionen
Integrations-Aktionen
Aktionen aus verbundenen Integrationen, zum Beispiel
Hubspot_create_contact oder Slack_send_message.Datenverarbeitung und Datenschutz
Null-Werte
Leere oder nicht verfügbare Datenfelder werden so behandelt:- Numerische Felder:
0oder 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.