使用 AI 自动化管理 Box 云存储文件与签名请求

解决云端文档管理繁琐的问题：通过 AI 调用 Box Toolkit，实现从文件搜索、组织管理到协作共享，乃至电子签名请求全流程的自动化操作。

为什么需要这个技能

在处理企业级文档时，手动在 Box 中寻找特定文件、管理复杂的文件夹层级或跟踪电子签名状态非常耗时。

本技能允许 AI 直接操作 Box API，将重复的文档管理工作（如：搜索某个特定元数据的合同 下载 修改 上传 发起签名请求）转化为一个简单的自然语言指令，极大提升了企业文档流转的效率。

适用场景

• 自动化文档归档：AI 根据文件内容自动创建文件夹并完成上传。
• 智能内容检索：通过全文本搜索或元数据过滤，快速定位海量文件。
• 协作权限管理：快速为团队成员分配文件的查看或编辑权限。
• 电子签名跟踪：自动列出所有待处理的 Box Sign 请求并跟进状态。

核心工作流

1. 文件与文件夹操作

• 上传/下载：使用 BOX_SEARCH_FOR_CONTENT 定位目标文件夹 ID（根目录为 "0"），随后调用 BOX_UPLOAD_FILE 或 BOX_DOWNLOAD_FILE。
• 目录维护：通过 BOX_CREATE_FOLDER 创建目录，利用 BOX_UPDATE_FOLDER 进行重命名或移动。删除非空文件夹时必须设置 recursive: true。

2. 内容搜索与浏览

• 多维度检索：使用 BOX_SEARCH_FOR_CONTENT 进行全文本搜索，支持 AND、OR、NOT（必须大写）运算符。
• 元数据查询：利用 BOX_QUERY_FILES_FOLDERS_BY_METADATA 基于特定模板值快速筛选文件。

3. 协作与签名

• 权限控制：通过 BOX_LIST_FILE_COLLABORATIONS 查看权限，并使用 BOX_UPDATE_COLLABORATION 修改角色（如 editor 或 viewer）。
• 签名管理：调用 BOX_LIST_BOX_SIGN_REQUESTS 监控签名进度，必要时使用 BOX_CANCEL_BOX_SIGN_REQUEST 取消请求。

关键技术细节

• ID 识别：Box 所有实体 ID 均为数字字符串。可以通过 Box 网页版 URL 直接提取（例如 .../files/123 即 file_id: "123"）。
• 分页处理：面对大量数据时，优先使用 usemarker: true 的标记分页法而非偏移量分页，以避免 10000 条记录的上限限制。
• 参数命名：注意嵌套参数使用双下划线表示，例如 parent__id 和 lock__access。

下载和安装

下载 box-automation 中文版 Skill ZIP

解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。

你可能还需要

暂无推荐