File Manager 智能体工作区文件管理工具节点
节点核心功能 (What is it?)
File Manager 工具节点是一个专用的文件系统 I/O 构件,可作为 Tool 外挂赋能给 AI 智能体(Agent),允许大模型在当前工作区目录(Workspace Directory)中自主执行安全的文件读写与文件系统管理操作。
典型适用场景 (When would I use it?)
在以下情况下使用该节点:
- 赋能 AI Agent 自主读取、解析并向磁盘写入文件的能力;
- 让智能体管理特定工作区目录中的资产与项目文件;
- 执行复制、移动、重命名或删除文件等自动化文件管理任务。
使用指南 (How to use it)
基础配置流程 (Basic Setup)
- 在工作流画布中添加 File Manager 节点。
- 将该节点的
tool输出引脚连接至需要文件操作能力的节点(例如Agent的tools输入插槽)。
输出引脚 (Outputs)
- tool:封装配置完成的文件管理工具对象工件(供下游 Agent 节点注册并挂载使用)。
典型工作流示例 (Example)
构建一个能够自动整理与分类工作区文件的代码/文件整理智能体:
- 在工作流画布中添加一个 File Manager 节点。
- 添加一个
Agent节点,并为其编写处理文件整理任务的 Prompt。 - 将 File Manager 的
tool输出端连接至Agent的tools插槽。 - 在交互中,Agent 可以自主调起该工具读取文件内容、重构并持久化保存修改后的版本。
实现细节 (Implementation Details)
File Manager 工具底层基于 Griptape 原生 FileManagerTool 类并搭配 LocalFileManagerDriver 本地驱动实现,为 Agent 提供了规范且严格限制在工作区根路径范围内的安全文件操作能力。
注意:云端存储(Cloud Storage)扩展功能当前已做安全锁定,将在后续版本更新中正式开放。