toolExecution.toolConcurrency, damit das TypeScript Agent SDK mehrere unabhängige Tool-Aufrufe aus einem Modellzug gleichzeitig statt nacheinander ausführt. Am Ende hast du einen Agenten, der Kontext aus Dokumentation, Status und Vorfällen parallel sammelt und die Ergebnisse trotzdem in der Reihenfolge aufzeichnet, in der das Modell sie angefordert hat.
Die Tools liefern feste Beispieldaten, das Skript dient also der Veranschaulichung; ersetze sie durch deine eigenen nur lesenden Abfragen. Eine fertig verpackte Version liegt in packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts.
Agenten bauen
1
Installieren
2
Agenten schreiben
parallel-agent.ts
3
Ausführen
Prüfen, ob es funktioniert hat
- Wenn das Modell alle drei Tools in einem Zug anfordert, erscheinen die drei
tool.started-Zeilen vor den passendentool.completed-Zeilen, mit nah beieinanderliegenden Zeitstempeln. result.messageslistet die Tool-Ergebnisse in der Reihenfolge der Tool-Aufrufe des Modells, egal in welcher Reihenfolge sie fertig wurden.- Der Lauf endet mit einer Zusammenfassung in
result.output.
Was gleichzeitig läuft
tool.started und tool.completed werden weiterhin für jeden Aufruf ausgelöst, und der Lauf setzt einen Checkpoint, sobald die Tool-Phase abgeschlossen ist.
Sicher bleiben
Nutze Parallelität nur für Tools, die nicht von der Ausgabe der anderen abhängen und keinen gemeinsamen Zustand ändern. Beginne mit2 oder 3, halte Tools idempotent mit wenigen Nebenwirkungen und validiere jedes Argument wie oben mit inputSchema. Füge einen state-Accessor wie in der robusten Agent-Schleife nur hinzu, wenn du Läufe fortsetzen musst. Bevor du dich darauf verlässt, führe deine Tests für Züge mit mehreren Tools aus und prüfe die Reihenfolge der Ergebnisse.