Feishu Drive 工具用于管理飞书云存储中的文件。它提供单一工具 feishu_drive,用于执行云空间操作。
用途:当用户提及云空间、文件夹或 drive 时激活,帮助管理飞书云存储中的文件和文件夹。
主要能力:
- 列出文件夹内容:可列出根目录或指定文件夹的内容,返回文件 token、名称、类型、URL 和时间戳。
- 获取文件信息:通过 file_token 和类型搜索根目录中的文件,注意文件必须在根目录,或先使用 list 浏览文件夹。
- 创建文件夹:可在根目录或指定父文件夹中创建新文件夹。
- 移动文件:将文件移动到指定文件夹。
- 删除文件:删除指定文件。
使用方式:
- Token 提取:从 URL https://xxx.feishu.cn/drive/folder/ABC123 中提取 folder_token = ABC123。
- 操作示例:
- 列出文件夹内容:{ "action": "list" } 或 { "action": "list", "folder_token": "fldcnXXX" }
- 获取文件信息:{ "action": "info", "file_token": "ABC123", "type": "docx" }
- 创建文件夹:{ "action": "create_folder", "name": "New Folder" } 或 { "action": "create_folder", "name": "New Folder", "folder_token": "fldcnXXX" }
- 移动文件:{ "action": "move", "file_token": "ABC123", "type": "docx", "folder_token": "fldcnXXX" }
- 删除文件:{ "action": "delete", "file_token": "ABC123", "type": "docx" }
文件类型:支持 doc(旧格式文档)、docx(新格式文档)、sheet(电子表格)、bitable(多维表格)、folder(文件夹)、file(上传文件)、mindnote(思维导图)、shortcut(快捷方式)。
配置:在 channels.feishu.tools.drive 中设置,默认值为 true。
权限:
- drive:drive:完全访问(创建、移动、删除)
- drive:drive:readonly:只读(列出、信息)
已知限制:
- 机器人没有根文件夹:飞书机器人使用 tenant_access_token,没有自己的“我的空间”。根文件夹概念仅存在于用户账户。这意味着:
- 不带 folder_token 的 create_folder 将失败(400 错误)。
- 机器人只能访问已共享给它的文件或文件夹。
- 变通方法:用户必须首先手动创建文件夹并共享给机器人,然后机器人才能在其中创建子文件夹。