FileSystem
更新时间 2026-05-09 17:56:45
最近更新时间: 2026-05-09 17:56:45
本节介绍FileSystem功能操作能力。
FileSystem 是 AIuse 云电脑面向 Agent 和自动化系统提供的文件操作能力,用于在云电脑环境中读取、写入、搜索、移动和管理文件。
能力概述
FileSystem 当前规划和技术方案覆盖以下能力:
| 能力 | 说明 |
|---|---|
| 读取文件 | 支持按路径读取文件内容,可按偏移量和长度读取片段 |
| 写入文件 | 支持覆盖写入、追加写入和新建写入模式 |
| 创建目录 | 支持创建目录,并可自动补齐父目录 |
| 移动文件 | 支持文件或目录移动,也可用于重命名 |
| 搜索文件 | 支持按通配符、正则或精确文件名搜索 |
| 获取文件信息 | 支持获取文件大小、类型、路径等元数据 |
| 下载文件 | 大文件或二进制文件可通过临时地址传输,具体能力以发布版本为准 |
设计目标
FileSystem 能力的目标是为 Agent 提供统一、可控的文件系统语义。
典型场景
读取应用生成的日志、报表或结果文件。
将 Agent 生成的内容写入云电脑工作目录。
查找指定目录下的文件。
将文件移动到指定目录,完成任务归档。
配合 Computer Use 完成“操作软件生成文件,再读取文件内容”的闭环任务。
示例流程
通过 Computer Use 操作桌面软件生成文件。
使用 FileSystem 搜索输出目录。
读取目标文件内容。
将结果返回业务系统或 Agent。
使用建议
文本文件优先使用读取接口,按需指定
offset和length。写入重要文件前,建议明确写入模式,避免误覆盖。
对文件路径进行白名单或工作目录限制,降低误操作风险。