> ## 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.
# Agenten-Nutzung exportieren
> API-Endpunkt zum Exportieren von Agenten-Nutzungsdaten.
Dieser Endpunkt exportiert Agenten-Nutzungsdaten für den gewählten Zeitraum.
**Dedicated Deployment?**
Ersetze `api.langdock.com` durch `/api/public` in allen Anfragen.
Details zu Voraussetzungen und Rate Limits findest du in der [Hauptdokumentation zur Usage Export API](/de/developer/usage-export-api/intro-to-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](/de/admin/ai-adoption-and-rollout/best-practices/api-key-best-practices).
## 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
Mit `group_by=model` erhältst du eine Zeile pro Agent und Modell. Agenten-KPI-Spalten werden im gruppierten Modus ausgelassen.
## OpenAPI
````yaml POST /export/assistants
openapi: 3.0.0
info:
title: Langdock API
version: 3.0.0
servers:
- url: https://api.langdock.com
description: Production
security:
- bearerAuth: []
paths:
/export/assistants:
post:
tags:
- Usage Export
summary: Export assistant usage data
description: Export detailed usage data for all assistants in the workspace
parameters: []
requestBody:
required: true
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportModelGroupByRequest'
example:
from:
date: '2024-01-01T00:00:00.000Z'
timezone: UTC
to:
date: '2024-01-31T23:59:59.999Z'
timezone: UTC
responses:
'200':
description: Export successful
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportResponse'
example:
success: true
data:
filePath: >-
assistants-usage/workspace-id/assistants-usage-2024-01-01-2024-01-31-abc12345.csv
downloadUrl: https://storage.example.com/signed-url
dataType: assistants
recordCount: 1250
dateRange:
from: '2024-01-01T00:00:00.000Z'
to: '2024-01-31T23:59:59.999Z'
'400':
description: Bad Request - Export too large or invalid date range
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
example:
error: Export too large
message: >-
Export too large: 1500000 rows exceeds limit of 1000000.
Please narrow the date range.
'401':
description: Unauthorized - Invalid or missing API key
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
example:
error: Unauthorized
message: Invalid or missing API key
'404':
description: No data found for the selected period
content:
application/json:
schema:
$ref: '#/components/schemas/UsageExportError'
example:
error: No data found
message: No usage data found for the selected period
components:
schemas:
UsageExportModelGroupByRequest:
allOf:
- $ref: '#/components/schemas/UsageExportRequest'
- type: object
properties:
group_by:
type: string
description: Optional aggregation dimension.
enum:
- model
UsageExportResponse:
type: object
description: Successful response from usage export endpoints
properties:
success:
type: boolean
description: Indicates if the export was successful
example: true
data:
type: object
description: Export data information
properties:
filePath:
type: string
description: Path to the generated export file
example: >-
agents-usage/workspace-id/agents-usage-2024-01-01-2024-01-31-abc12345.csv
downloadUrl:
type: string
format: uri
description: Signed URL to download the export file
example: https://storage.example.com/signed-url
dataType:
type: string
description: Type of data exported
enum:
- assistants
- agents
- api_keys
- users
- projects
- models
example: assistants
recordCount:
type: integer
description: Number of records in the export
example: 1250
dateRange:
type: object
description: Actual date range of the exported data
properties:
from:
type: string
format: date-time
description: Start date of the export
example: '2024-01-01T00:00:00.000Z'
to:
type: string
format: date-time
description: End date of the export
example: '2024-01-31T23:59:59.999Z'
required:
- from
- to
required:
- filePath
- downloadUrl
- dataType
- recordCount
- dateRange
required:
- success
- data
UsageExportError:
type: object
description: Error response from usage export endpoints
properties:
error:
type: string
description: Error type
example: No data found
message:
type: string
description: Detailed error message
example: No usage data found for the selected period
required:
- error
- message
UsageExportRequest:
type: object
description: Request body for usage export endpoints
properties:
from:
type: object
description: Start date and timezone for the export
properties:
date:
type: string
format: date-time
description: Start date in ISO 8601 format
example: '2024-01-01T00:00:00.000Z'
timezone:
type: string
description: Timezone for the date range
example: UTC
required:
- date
- timezone
to:
type: object
description: End date and timezone for the export
properties:
date:
type: string
format: date-time
description: End date in ISO 8601 format
example: '2024-01-31T23:59:59.999Z'
timezone:
type: string
description: Timezone for the date range
example: UTC
required:
- date
- timezone
required:
- from
- to
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: API Key
description: API key as Bearer token. Format "Bearer YOUR_API_KEY"
````