toolExecution.toolConcurrency を設定すると、TypeScript Agent SDK は 1 回のモデルターンから出た複数の独立したツール呼び出しを、1 つずつ順にではなく同時に実行します。完成すると、ドキュメント、ステータス、インシデントのコンテキストを並行して集め、その結果をモデルが要求した順序で記録するエージェントができます。
ツールは固定のサンプルデータを返すため、このスクリプトは例示用です。実際には独自の読み取り専用の検索に置き換えてください。パッケージ化した版は packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts にあります。
作成する
1
インストールする
2
エージェントを書く
parallel-agent.ts
3
実行する
動作を確認する
- モデルが 1 回のターンで 3 つすべてを要求した場合、3 つの
tool.startedの行が、対応するtool.completedの行より前に、近いタイムスタンプで出力されます。 result.messagesには、完了した順序にかかわらず、モデルのツール呼び出しの順序でツールの結果が並びます。- 実行は
result.outputの 1 つの要約で終わります。
同時に実行されるもの
tool.started と tool.completed は引き続き呼び出しごとに発生し、ツールのフェーズが終わると実行がチェックポイントを保存します。
安全に使う
並行実行は、互いの出力に依存せず、共有状態を変更しないツールにだけ使ってください。2 か 3 から始め、ツールは副作用の少ない冪等なものにし、上の例のようにすべての引数を inputSchema で検証してください。state アクセサーは、永続化可能なループのように、実行を再開する必要がある場合にだけ追加してください。本番で頼る前に、複数ツールのターンを扱うテストを実行し、結果の順序を確認してください。