跳转至

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)

  1. 在工作流画布中添加 File Manager 节点。
  2. 将该节点的 tool 输出引脚连接至需要文件操作能力的节点(例如 Agent 的 tools 输入插槽)。

输出引脚 (Outputs)

  • tool:封装配置完成的文件管理工具对象工件(供下游 Agent 节点注册并挂载使用)。

典型工作流示例 (Example)

构建一个能够自动整理与分类工作区文件的代码/文件整理智能体:

  1. 在工作流画布中添加一个 File Manager 节点。
  2. 添加一个 Agent 节点,并为其编写处理文件整理任务的 Prompt。
  3. 将 File Manager 的 tool 输出端连接至 Agent 的 tools 插槽。
  4. 在交互中,Agent 可以自主调起该工具读取文件内容、重构并持久化保存修改后的版本。

实现细节 (Implementation Details)

File Manager 工具底层基于 Griptape 原生 FileManagerTool 类并搭配 LocalFileManagerDriver 本地驱动实现,为 Agent 提供了规范且严格限制在工作区根路径范围内的安全文件操作能力。

注意:云端存储(Cloud Storage)扩展功能当前已做安全锁定,将在后续版本更新中正式开放。