Skip to main content
Verwende dieses Rezept, wenn ein Agent-Turn sicher mehrere unabhängige lokale Tools aufrufen kann und die Laufzeit sie parallel ausführen soll, ohne die feste Reihenfolge der Ergebnisse zu verändern.

Wann du es verwenden solltest

Verwende toolExecution.toolConcurrency, wenn:
  • das Modell in einem Turn mehrere lokale Tool-Aufrufe ausgeben kann
  • die Tools nicht von den Ergebnissen der anderen abhängen
  • eine serielle Ausführung Worker-Zeit verschwenden würde
  • gespeicherte Tool-Ergebnismeldungen weiterhin in der ursprünglichen Aufrufreihenfolge stehen sollen
Verwende keine hohe Parallelität, wenn ein Tool gemeinsam genutzten Zustand verändert oder spätere Tools von vorherigen Ergebnissen abhängen.

Beispiel

Die enthaltene Version findest du unter packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.

Was die Laufzeit garantiert

  • lokale Tools können bis zur konfigurierten Grenze toolConcurrency parallel ausgeführt werden
  • die Ereignisse tool.started und tool.completed werden weiterhin für jedes Tool ausgegeben
  • gespeicherte Tool-Ergebnismeldungen behalten die ursprüngliche Aufrufreihenfolge
  • nach Abschluss der Tool-Phase wird weiterhin ein Checkpoint gespeichert
  • Zeitlimits gelten über timeoutMs weiterhin für jedes Tool

Betriebshinweise

  • beginne mit einer niedrigen Parallelität, etwa 2 oder 3
  • halte lokale Tools idempotent und mit möglichst wenigen Nebenwirkungen
  • verwende timeoutMs, damit eine hängende Abhängigkeit nicht alle Worker blockiert
  • füge store nur hinzu, wenn deine Anwendung tatsächlich Fortsetzung oder Fernkoordination benötigt

Validierung

Nachdem du dieses Muster aktiviert hast:
  • führe die Agent-Schleifentests für Turns mit mehreren Tools aus
  • prüfe, ob der Workflow Tool-Ergebnismeldungen weiterhin in der richtigen Reihenfolge erzeugt
  • prüfe, ob die Betriebsprotokolle weiterhin die erwarteten Ereignisse tool.started und tool.completed enthalten
Zuletzt geändert am 2. Oktober 2026