ToolList 多工具聚合打包节点
节点核心功能 (What is it?)
ToolList 节点用于将多个分散的独立工具（Tools）整合成一个统一的工具列表集合。它允许创作者将多路不同功能的工具打包成一个复合包，直接一次性接入下游 Agent 节点的 tools 输入参数插槽。
典型适用场景 (When would I use it?)
在以下情况下使用该节点：
- 将多个异构工具（如 Calculator、WebSearch、FileManager 等）聚合成一个复合工具集；
- 构建兼具多种执行能力（搜索、运算、I/O 读写）的综合全功能复合型智能体；
- 整合来自工作流不同模块与分支的各类自定义扩展工具。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 ToolList 节点。
- 将各个独立的工具输出引脚依次连接至该节点的
tools输入插槽。 - 将输出端
tool_list直接连入下游 Agent 节点的tools插槽。
参数输入插槽 (Parameters)
- tools：待聚合为列表的各个独立工具对象序列（支持多路连接）。
输出引脚 (Outputs)
- tool_list：打包汇总后的完整工具列表工件（
list[Tool]）。
典型工作流示例 (Example)
为全能研究型智能体一次性挂载计算与搜索能力：
- 在画布中添加一个
Calculator节点和一个WebSearchTool节点。 - 添加一个 ToolList 节点，并将上述两个工具的
tool引脚分别接入 ToolList 的输入端。 - 将 ToolList 的
tool_list输出引脚接入Agent节点的tools输入端。 - 此时智能体便同时具备了联网检索实时信息与精准核算数据的双重外挂技能。
关键技术特性 (Important Notes)
- 运行时工具完备性：工作流执行时，必须确保接入
ToolList的各个前置工具节点已完成初始化； - 自动扁平化机制 (Auto-flattening)：如果输入插槽接入了嵌套的子工具列表，节点底层会自动将其展开扁平化为一个单层的一维工具清单。
常见问题与排查 (Common Issues)
- 工具非法或空指针 (Invalid Input Tools)：请确保接入的各个节点均输出合法的 Griptape Tool 工具对象。
- 嵌套列表自动展开：注意嵌套的列表结构会被自动拍平成扁平列表，无需额外使用列表处理算子。