SuperAPI AI 工具集

box-automation

办公与效率

查看项目

更新于 10-15 10:59

技能介绍

Box Automation 通过 Rube MCP 自动化 Box 云存储操作,底层使用 Composio 的 Box 工具包,覆盖文件上传/下载、内容搜索、文件夹管理、协作与共享、元数据查询以及 Box Sign 签名请求等任务。

用途 该技能用于在自动化流程中操作 Box:查找和浏览文件或文件夹、上传与下载文件、创建和调整文件夹结构、管理共享链接与协作权限、按元数据检索内容,以及查看或取消签名请求。

主要能力

  • 文件上传与下载:使用 BOX_UPLOAD_FILE 上传文件到指定文件夹,使用 BOX_DOWNLOAD_FILE 按 file_id 下载文件,也可通过 BOX_CREATE_ZIP_DOWNLOAD 将多个文件或文件夹打包为 zip。
  • 搜索与浏览:使用 BOX_SEARCH_FOR_CONTENT 进行全文搜索,支持按类型、文件夹范围、文件扩展名、内容类型和日期范围过滤;使用 BOX_LIST_ITEMS_IN_FOLDER 浏览文件夹内容,使用 BOX_GET_FILE_INFORMATION 和 BOX_GET_FOLDER_INFORMATION 获取详细信息,使用 BOX_QUERY_FILES_FOLDERS_BY_METADATA 按元数据模板查询,使用 BOX_LIST_RECENTLY_ACCESSED_ITEMS 列出最近访问项。
  • 文件夹管理:使用 BOX_CREATE_FOLDER 创建文件夹,BOX_UPDATE_FOLDER 重命名、移动或更新设置,BOX_COPY_FOLDER 复制文件夹,BOX_DELETE_FOLDER 移入回收站,BOX_PERMANENTLY_REMOVE_FOLDER 永久删除。
  • 共享与协作:使用 BOX_LIST_FILE_COLLABORATIONS 列出协作者,BOX_UPDATE_COLLABORATION 调整访问级别或接受/拒绝邀请,BOX_GET_COLLABORATION 获取协作详情,BOX_UPDATE_FILE 和 BOX_UPDATE_FOLDER 创建共享链接、锁定文件或更新权限。
  • Box Sign:使用 BOX_LIST_BOX_SIGN_REQUESTS 列出签名请求,BOX_GET_BOX_SIGN_REQUEST_BY_ID 获取详情,BOX_CANCEL_BOX_SIGN_REQUEST 取消待处理请求。

使用方式 前置条件:Rube MCP 必须已连接(RUBE_SEARCH_TOOLS 可用),并且通过 RUBE_MANAGE_CONNECTIONS 使用 toolkit box 建立有效的 Box 连接。设置时,在客户端配置中添加 https://rube.app/mcp 作为 MCP 服务器,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 并指定 toolkit box,若连接未处于 ACTIVE 状态,按返回的授权链接完成 Box OAuth,确认状态为 ACTIVE 后再执行工作流。每次操作前应先调用 RUBE_SEARCH_TOOLS 获取当前工具 schema。

适用场景 适合需要在自动化流程中批量管理 Box 文件、按名称或内容查找资料、调整文件夹结构、管理共享与协作权限、按元数据筛选文件,以及处理 Box Sign 签名请求的场景。

限制

  • 超过 50MB 的文件应使用分块上传 API,标准工具不支持。
  • 搜索的 offset 超过 10000 会被拒绝(HTTP 400)。
  • 布尔运算符 AND、OR、NOT 必须大写。
  • 删除非空文件夹需要 recursive: true;根文件夹(ID "0")不能复制或删除。
  • 文件夹名称不能包含 /、\、不可打印 ASCII 字符或结尾空格。
  • 嵌套参数使用双下划线表示,例如 parent__id、lock__access。
  • 协作角色和权限受企业设置限制,部分共享选项可能被禁用。
  • Box Sign 需要企业账户启用该功能,且只有创建者可以取消签名请求。
  • 所有 ID 均为数字字符串,根文件夹固定为 "0"。
  • Box API 存在按端点的速率限制,批量操作应加入延迟。
  • 上传时 attributes 部分必须位于 file 部分之前,否则会返回 HTTP 400(metadata_after_file_contents)。
  • 分页支持 offset 和 marker 两种方式,大数据集建议使用 marker(usemarker: true),并应分页到结束以避免部分结果。