toolExecution.toolConcurrency,让 TypeScript Agent SDK 同时运行同一模型轮次中的多个独立工具调用,而不是逐个运行。完成后,你会得到一个智能体:它并行收集文档、状态和事故信息,同时仍按模型请求的顺序记录结果。
这些工具返回固定的示例数据,因此该脚本仅作演示;请将它们替换为你自己的只读查询。打包好的版本位于 packages/sdk/agent-sdk-ts/examples/parallel-tool-agent.ts。
构建
1
安装
2
编写智能体
parallel-agent.ts
3
运行
检查是否成功
- 当模型在一个轮次中请求全部三个工具时,三行
tool.started会在对应的tool.completed之前打印,且时间戳相近。 - 无论工具按什么顺序完成,
result.messages都会按模型工具调用的顺序列出工具结果。 - 运行结束时,
result.output中会有一段摘要。
哪些调用会一起运行
每次调用仍会触发
tool.started 和 tool.completed,工具阶段结束后,运行会保存一次检查点。
保持安全
只对不依赖彼此输出、也不更改共享状态的工具使用并发。从2 或 3 开始,让工具保持幂等、副作用少,并像上面那样用 inputSchema 验证每个参数。只有在需要恢复运行时,才像持久化循环中那样添加 state 访问器。在依赖并发之前,运行覆盖多工具轮次的测试,并检查结果顺序。