Zum Inhalt springen
Developer

ChatbotTurnLog

Chat und Benachrichtigungen2 EndpunkteChat / ChatbotTurnLog

Liefert eine Liste aller ChatbotTurnLogs-Objekte.

GET/api/chat/chatbot_turn_log

Query-Parameter

idstring, SCOPE_LIST
chatroomstring, SCOPE_LIST
personstring, SCOPE_LIST
statusstringok | error | skipped – siehe STATUS_*-Konstanten. | , SCOPE_LIST
modelstring, SCOPE_LIST
finishReasonstringstop | max_iterations | timeout | error – so, wie der Dienst es meldet. | , SCOPE_LIST
createdstring, SCOPE_LIST
searchStringstringText, nach dem in der Liste gesucht wird
orderFieldNamestringName des Bestellfelds
orderFieldSortstringSortiermodusErlaubt: DESCASC
pageintegerSeite der Liste
pageSizeintegerAnzahl der Einträge je Seite
withMaxPageNumberstringgibt die Anzahl verfügbarer Seiten als Header zurück, wenn dies gesetzt ist

Antworten

200Liefert eine Liste aller ChatbotTurnLogs-Objekte.array<ChatbotTurnLog>

Felder anzeigen (11)
  • idinteger

    Primärschlüssel des Chatbot-Gesprächsprotokolls. Interne ID.

  • modelstring

    Für den Durchlauf verwendetes Sprachmodell.

  • prompt_tokensinteger

    Anzahl der verbrauchten Prompt-Tokens.

  • completion_tokensinteger

    Anzahl der verbrauchten Completion-Tokens.

  • llm_callsinteger

    Anzahl der Modellaufrufe im Turn.

  • tool_callsinteger

    Anzahl der Tool-Aufrufe – die Einzelheiten stehen in ai_meta an der Nachricht, hier zählt nur die Menge.

  • duration_msinteger

    Dauer des Gesprächsbeitrags in Millisekunden.

  • finish_reasonstring

    stop | max_iterations | timeout | error – so, wie der Dienst es meldet.

  • statusstring

    ok | error | skipped – siehe STATUS_*-Konstanten.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/chat/chatbot_turn_log \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
[
  {
    "id": 42,
    "model": "string",
    "prompt_tokens": 1,
    "completion_tokens": 1,
    "llm_calls": 1,
    "tool_calls": 1,
    "duration_ms": 1,
    "finish_reason": "string",
    "status": "string",
    "created": "2026-10-15T09:30:00+02:00"
  }
]

Liefert einen einzelnen ChatbotTurnLog-Eintrag.

GET/api/chat/chatbot_turn_log/{identifier}

Pfad-Parameter

identifierPflichtstring

Antworten

200Gibt ein einzelnes ChatbotTurnLog-Objekt zurück.ChatbotTurnLog

Felder anzeigen (11)
  • idinteger

    Primärschlüssel des Chatbot-Gesprächsprotokolls. Interne ID.

  • modelstring

    Für den Durchlauf verwendetes Sprachmodell.

  • prompt_tokensinteger

    Anzahl der verbrauchten Prompt-Tokens.

  • completion_tokensinteger

    Anzahl der verbrauchten Completion-Tokens.

  • llm_callsinteger

    Anzahl der Modellaufrufe im Turn.

  • tool_callsinteger

    Anzahl der Tool-Aufrufe – die Einzelheiten stehen in ai_meta an der Nachricht, hier zählt nur die Menge.

  • duration_msinteger

    Dauer des Gesprächsbeitrags in Millisekunden.

  • finish_reasonstring

    stop | max_iterations | timeout | error – so, wie der Dienst es meldet.

  • statusstring

    ok | error | skipped – siehe STATUS_*-Konstanten.

  • createdstring (date-time)

    Zeitpunkt, zu dem der Datensatz angelegt wurde.

  • updatedstring (date-time)

    Zeitpunkt, zu dem der Datensatz zuletzt aktualisiert wurde.

Anfrage
curl --request GET \
  --url https://eure-instanz.iw-erp.de/api/chat/chatbot_turn_log/42 \
  --header 'x-iw-jwt-token: <TOKEN>'
Antwort 200 application/json
{
  "id": 42,
  "model": "string",
  "prompt_tokens": 1,
  "completion_tokens": 1,
  "llm_calls": 1,
  "tool_calls": 1,
  "duration_ms": 1,
  "finish_reason": "string",
  "status": "string",
  "created": "2026-10-15T09:30:00+02:00"
}