Eine Nachricht in einer Chat-Sitzung senden

POST

/v1/chat

curl --request POST \
  --url https://example.com/v1/chat \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "input": "Was ist ein Endpoint-Pool?" }'

• Adresse aus config.json → api.addr, Standard 127.0.0.1:2330

Wie /v1/agent/run, aber mit persistenter Historie. Ohne session_id wird eine neue Sitzung angelegt (die Antwort trägt ihre session_id). Nach dem ersten Austausch benennt ein kleines Modell die Sitzung asynchron im Hintergrund (title in einer späteren Antwort/GET /v1/sessions/{id} kann daher nachträglich wechseln). stream:true verhält sich wie bei /v1/agent/run, das result-Event trägt zusätzlich session_id, title und context.

Authorizations

• bearerAuth

Request Body^required

Media typeapplication/json

object

input

required

Die Nachricht/Aufgabe an den Agent.

string

category

Task-Kategorie, überspringt die automatische Klassifikation (z. B. chat, code, summarize).

string

model

Erzwingt ein konkretes Modell statt der Task-Präferenzliste.

string

skill

Lädt diesen Skill von vornherein in den Kontext.

string

system

Überschreibt den Standard-System-Prompt für diesen Lauf.

string

stream

True = Server-Sent Events statt einer einzelnen JSON-Antwort.

boolean

session_id

Nur /v1/chat — leer legt eine neue Sitzung an.

string

Examples

{
  "input": "Was ist ein Endpoint-Pool?"
}

{
  "input": "Und was passiert bei einem Ausfall?",
  "session_id": "3f9a2c1e"
}

Responses

200

Ergebnis inklusive Sitzungskontext (oder SSE bei stream:true).

Result-Felder plus Sitzungskontext, flach in einem Objekt (Go embedding).

object

session_id

string

title

string

context

object

tokens

Geschätzte Token-Zahl der aktuellen Historie

integer

limit

Effektives Kontextfenster des Modells, gemessen per Benchmark

integer

percent

Tokens / limit * 100

number

output

string

model

string

category

string

skill

string

tool_calls

Array<object>

object

tool

string

args

Rohes JSON der Tool-Argumente

object

result

string

error

string

salvaged

True, wenn der Tool-Call aus unstrukturiertem Text gerettet wurde (Salvage-Parser)

boolean

iterations

integer

usage

object

prompt_tokens

integer

output_tokens

integer

Example^generated

{
  "session_id": "example",
  "title": "example",
  "context": {
    "tokens": 1,
    "limit": 1,
    "percent": 1
  },
  "output": "example",
  "model": "example",
  "category": "example",
  "skill": "example",
  "tool_calls": [
    {
      "tool": "example",
      "args": {},
      "result": "example",
      "error": "example",
      "salvaged": true
    }
  ],
  "iterations": 1,
  "usage": {
    "prompt_tokens": 1,
    "output_tokens": 1
  }
}

SSE-Ereignisse: delta, result (inkl. session_id/title/context), error.

string

400

Ungültiger Body oder leeres input.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}

503

Kein Endpoint mit dem gewünschten Modell erreichbar.

Media typeapplication/json

object

error

string

Example^generated

{
  "error": "example"
}