Agent Runs

POST /v1/agent/run führt eine autonome Agent-Schleife auf dem Server aus. Der Agent arbeitet auf eine Aufgabe hin, ruft die von Ihnen erlaubten Tools auf und kann zurückspringen, wenn sich ein Pfad nicht mehr auszahlt. Sie erhalten die Schleife, ohne sie clientseitig bauen zu müssen.

Parameter

task (erforderlich): das Ziel, 1 bis 32000 Zeichen.
tools: eine Allowlist von Tools, die der Agent aufrufen darf.
max_steps: Obergrenze für Schleifendurchläufe.
max_total_tokens: Gesamt-Token-Budget, mindestens 1024.
max_tokens_per_step: Token-Obergrenze pro Schritt, mindestens 256.
reasoning_effort: none/minimal (fast), low (knappes thinking), medium (thinking), high/xhigh/max (thinking, größeres Reasoning-Budget). Standard medium.
stream: Events über SSE streamen. Standard true.
confidence_threshold: minimale Konfidenz, die der Agent anstrebt.
compression: ein Objekt mit enabled und trigger_tokens, um den Kontext bei wachsender Größe zu komprimieren.
glassbox: Objekt mit Glassbox-Optionen.
refusal_mode: soft oder strict.

Mit JSON-Antwort ausführen

Setzen Sie stream auf false, um einen einzelnen JSON-Body statt eines Event-Streams zu erhalten.

curl https://api.ablatic.ai/v1/agent/run \
  -H "Authorization: Bearer $ABLATIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "task": "Find the three largest cities in Austria and list their populations.",
    "max_steps": 8,
    "stream": false
  }'

Die Antwort enthält einen X-Run-Id-Header, der den Run identifiziert.

Events streamen

Wenn stream auf seinem Standardwert true bleibt, sendet der Run Server-Sent Events. Die Event-Typen sind:

step: der Agent hat einen Schritt gemacht.
tool_result: ein Tool hat ein Ergebnis zurückgegeben.
backtrack: der Agent hat einen Pfad verworfen und ist zurückgegangen.
content: Ausgabeinhalt.
done: der Run ist abgeschlossen.
error: der Run ist fehlgeschlagen.

Einen Run abbrechen

POST /v1/agent/run/{run_id}/cancel

Verwenden Sie den run_id aus dem X-Run-Id-Header des Runs, den Sie stoppen möchten.

Slots

Agent Runs benötigen einen verfügbaren Agent-Slot. Eine Anfrage mit 0 Slots gibt 403 zurück. Jeder laufende Agent belegt einen Slot, und wenn er Subagenten startet, belegt jeder laufende Subagent ebenfalls einen, sodass ein Run, der sich verzweigt, mehrere gleichzeitig belegen kann. Ein Run, der Ihr Slot-Limit überschreiten würde, gibt 429 zurück.

Accounts erhalten standardmäßig 2 Agent-Slots.

Nächste Schritte

Limits