Zum Hauptinhalt springen
Dieser Endpunkt exportiert Agenten-Nutzungsdaten für den gewählten Zeitraum.

​
Bevor du startest

​
Basis-URL

Dedicated DeploymentsErsetze api.langdock.com durch <your-deployment-url>/api/public in allen Anfragen.
Der veraltete Pfad /export/assistants bleibt verfügbar und liefert dieselben Daten.

​
Enthaltene Daten

Standardmäßig gibt der Agenten-Export eine Zeile pro Agent zurück. private bedeutet, dass der Agent über den Owner hinaus nicht geteilt ist. shared_users bedeutet Personen, Gruppen oder API-Schlüssel. shared_workspace bedeutet den ganzen Workspace und hat Vorrang vor engeren Freigaben. JSON und CSV enthalten beide Spalten auch dann, wenn Daten auf Nutzerebene deaktiviert sind. In BYOK-Workspaces stehen sie hinter den Token-Spalten und vor den Budget-Spalten. Ein Agent kann im Zeitraum mehrere Nutzer haben und trotzdem private sein. agent_budget_limit_current und agent_budget_utilization_pct_current sind in JSON null und in der CSV leere Zellen. always entspricht Immer unter Limit-Verwendung. after_user_limits entspricht Nach Nutzerlimits. none bedeutet, dass der Agent kein eigenes Limit hat oder dass der Workspace in der Langdock Cloud ohne BYOK liegt und Extra-Nutzung aus ist. In der Langdock Cloud ohne BYOK sind Limit und Verbrauch in EUR, bei BYOK in USD, auch bei Dedicated Deployments. Der Verbrauch ist auf zwei Dezimalstellen gerundet und bleibt auch bei none eine Zahl. agent_budget_utilization_pct_current ist ein Verhältnis mit vier Dezimalstellen und kann über 1 liegen. Der Wert ist 0, wenn das Limit positiv ist und im Zeitraum nichts bezahlt wurde. Das Limit ist die Konfiguration zum Zeitpunkt des Exports.

​
Zusätzliche Spalten für BYOK-Workspaces

cache_hit_rate ist sum_cached_prompt_tokens / sum_prompt_tokens als Verhältnis mit vier Dezimalstellen von 0 bis 1, kein Prozentwert. Der Wert ist 0 bei Input ohne Cache-Reads. Er ist leer, wenn der gesamte Input 0 ist. Übersteigen die Cache-Read-Tokens den gesamten Input, ist der Wert höchstens 1.0000. total_cost_usd sind die Kosten des Agenten im gewählten Zeitraum, auf zwei Dezimalstellen gerundet. Enthalten ist der gesamte Betrag, nicht nur der Teil aus dem Agenten-Limit.

​
Gruppierter Export

Mit group_by=model erhältst du eine Zeile pro Agent und Modell. In gruppierten Zeilen steht in model das Modell, das die Nutzung erzeugt hat, nicht das am Agenten konfigurierte Modell. Agenten-KPI-Spalten werden im gruppierten Modus ausgelassen. visibility und assistant_created_at bleiben in jeder Zeile. Die Spalten agent_budget_mode, agent_budget_limit_current, agent_budget_consumption_in_period und agent_budget_utilization_pct_current entfallen. Gruppierte BYOK-Zeilen enthalten total_cost_usd.