（4385期）Box Automation – 企业云存储一站式自动化

企业云存储一站式自动化 通过 Rube MCP 连接 Box 云端存储，实现文件上传下载、智能搜索、文件夹管理、协作共享及电子签名等自动化操作，无需手动处理 API 密钥。 使用说明 核心用法 Box Automation 技能依托 Rube MCP（Composio 平台）提供企业级云存储自动化能力。用户首先通过 RUBEMANAGECONNECTIONS 建立 Box OAuth 连接，随后调用 RUBESEARCHTOOLS 获取动态工具模式。核心工作流涵盖五大场景： 文件传输：使用 BOXUPLOADFILE 与 BOXDOWNLOADFILE 完成单文件操作，支持 BOXCREATEZIP_DOWNLOAD 批量打包。上传时需构造 FileUploadable 对象（含 s3key、mimetype、name），并注意 attributes 字段须置于 file 之前以避免 HTTP 400 错误。 智能搜索：BOXSEARCHFORCONTENT 支持全文检索与布尔逻辑（AND/OR/NOT 必须大写），可通过 ancestorfolderids 限定目录、fileextensions 过滤类型、content_types 指定搜索维度（文件名/描述/内容/评论/标签）。日期范围采用 RFC3339 格式，结果分页上限 10,000 条。 文件夹管理：BOXCREATEFOLDER/UPDATEFOLDER/COPYFOLDER/DELETE_FOLDER 构成完整生命周期。删除非空文件夹需设置 recursive: true，根目录（ID "0"）不可删除或复制。文件夹名称禁止包含 /、\、首尾空格及特殊符号。 协作与共享：通过 BOXLISTFILECOLLABORATIONS 查看权限，BOXUPDATECOLLABORATION 调整角色（editor/viewer/co-owner 等 8 级权限）。文件锁定使用双下划线嵌套参数 lockaccess、lockexpires_at。 电子签名：BOXLISTBOXSIGNREQUESTS 管理签名流程，支持按发送者筛选、查看状态（converting/created/sent/signed/declined 等 10 种）。 显著优点 零密钥配置：通过 Rube MCP 代理 OAuth，用户无需管理 Box API 密钥 企业级功能完整：覆盖搜索、协作、签名、元数据查询等企业刚需 URL 快速解析：直接从 Box Web 界面 URL 提取文件/文件夹 ID 灵活分页：支持 offset（≤10,000）与 marker 两种模式，适配不同数据规模 潜在局限 大文件限制：50MB 以上文件需分块上传，标准工具集未直接暴露该能力 企业功能依赖：电子签名、协作过期等功能需管理员在 Box 企业后台开启 参数顺序敏感：文件上传时字段顺序错误会导致 metadataafterfile_contents 报错 嵌套参数语法：双下划线表示法（如 parent__id）与常规 REST API 风格差异较大，学习成本存在 适合人群 需自动化企业文档流转的 Box 商业/企业版用户 希望避免直接管理 OAuth 凭证的开发团队 有批量文件同步、跨文件夹搜索、协作权限自动化需求的运维人员 常规风险 权限泄露：canviewpath 参数开启后，邀请方"全部文件"页面加载负担增加，建议每用户限制在 1000 个以内 误删风险：DELETEFOLDER 默认移至回收站，需显式调用 PERMANENTLYREMOVE_FOLDER 才能彻底删除 并发冲突：文件更新建议使用 ETag 配合 if_match 参数实现乐观锁，防止覆盖他人修改 搜索陷阱：空查询或未配置 query/mdfilters 将导致 HTTP 400，复杂过滤条件建议先用小样本验证 原始说明 Automate Box cloud storage operations including file upload/download, search, folder management, sharing, collaborations, and metadata queries via Rube MCP (Composio). Always search tools first for current schemas.