Export assistant usage data
Usage Export API
Agenten-Nutzung exportieren
API-Endpunkt zum Exportieren von Agenten-Nutzungsdaten.
POST
Export assistant usage data
Dieser Endpunkt exportiert Agenten-Nutzungsdaten für den gewählten Zeitraum.
Details zu Voraussetzungen und Rate Limits findest du in der Hauptdokumentation zur Usage Export API.
Langdock blockiert bewusst Browser-basierte Anfragen, um deinen API-Schlüssel zu schützen. Verwende API-Schlüssel serverseitig und speichere sie sicher. Mehr dazu findest du unter Best Practices für API-Schlüssel.
Enthaltene Daten
Standardmäßig gibt der Agenten-Export eine Zeile pro Agent zurück.| 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 |
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 |
conversations | Unterhaltungen aus den Agenten-Analytics |
messages_per_user | Durchschnittliche Nachrichten pro aktivem Nutzer |
assistant_description | Beschreibung des Agenten; entfällt, wenn Daten auf Nutzerebene deaktiviert sind |
assistant_url | Link zum Agenten; entfällt, wenn Daten auf Nutzerebene deaktiviert sind |
assistant_owner_id | ID des Agenten-Owners; entfällt, wenn Daten auf Nutzerebene deaktiviert sind |
assistant_owner_email | E-Mail des Agenten-Owners; entfällt, wenn Daten auf Nutzerebene deaktiviert sind |
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 |
Gruppierter Export
Mitgroup_by=model erhältst du eine Zeile pro Agent und Modell. Agenten-KPI-Spalten werden im gruppierten Modus ausgelassen.Autorisierungen
API key as Bearer token. Format "Bearer YOUR_API_KEY"
Body
application/json