メインコンテンツへスキップ
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 アクセサーは、永続化可能なループのように、実行を再開する必要がある場合にだけ追加してください。本番で頼る前に、複数ツールのターンを扱うテストを実行し、結果の順序を確認してください。
最終更新日 2026年11月5日