Einen Prompt einmalig durch den Agent laufen lassen

POST

/v1/agent/run

curl --request POST \
  --url https://example.com/v1/agent/run \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "input": "Fasse die Vorteile von SSDs in drei Sätzen zusammen." }'

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

Zustandslos — keine Sitzung, keine Historie. Für Skript-Aufrufe und Scheduler-Jobs. Mit "stream": true liefert die Antwort statt JSON einen text/event-stream: null oder mehr event: delta mit {"text": "..."} (Teiltext), gefolgt von genau einem event: result mit dem vollständigen Result oder event: error mit {"error": "..."}.

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": "Fasse die Vorteile von SSDs in drei Sätzen zusammen."
}

{
  "input": "def add(a, b):",
  "category": "code",
  "model": "qwen2.5-coder:7b"
}

Responses

200

Ergebnis (oder SSE bei stream:true, siehe Beschreibung).

object

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

{
  "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, error — siehe Beschreibung oben.

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"
}