SuperAPI AI 工具集

feishu-drive

办公与效率

查看项目

更新于 10-15 15:45

技能介绍

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 错误)。
    • 机器人只能访问已共享给它的文件或文件夹。
  • 变通方法:用户必须首先手动创建文件夹并共享给机器人,然后机器人才能在其中创建子文件夹。