概述

enableWorkspaceFileTools() 默认为 true。开启后，框架会注册 WorkspaceFileTools，Agent 可以在当前 conversation 的 workspace 内读写文件。

内置工具

工具名	行为
read_file	读取文本文件，超过 max-file-bytes 时截断
write_file	覆盖写入文本文件，自动创建父目录
list_files	列出目录内容，最多返回 max-list-size 条
delete_file	删除文件

所有路径都必须是相对路径。绝对路径或 .. 越界路径会被拒绝。

配置

# 单次读取最大字节数（默认 10MB）
liteflow.agent.workspace.max-file-bytes=10485760

# 单次列表最大条目数
liteflow.agent.workspace.max-list-size=1000

关闭文件工具

@Override
protected boolean enableWorkspaceFileTools() {
    return false;
}

安全提示

当前文件工具面向文本内容。如果需要 Agent 写入大文件或二进制文件，建议关闭内置文件工具，改用自定义工具做大小、类型和审计控制。