Dropbox
在 Dropbox 中上传、下载、分享和管理文件
Dropbox 是一个流行的云存储和协作平台，能够让个人和团队安全地存储、访问和分享文件，无论身在何处。Dropbox 专为便捷的文件管理、同步和强大的协作而设计，无论您是单独工作还是与团队合作。
在 Sim 中使用 Dropbox，您可以：
- 上传和下载文件：无缝上传任何文件到您的 Dropbox 或按需检索内容
- 列出文件夹内容：浏览任何 Dropbox 目录中的文件和文件夹
- 创建新文件夹：通过编程方式在您的 Dropbox 中创建新文件夹以组织文件
- 搜索文件和文件夹：通过名称或内容定位文档、图片或其他项目
- 生成共享链接：快速为文件和文件夹创建可分享的公共或私人链接
- 管理文件：在自动化工作流中移动、删除或重命名文件和文件夹
这些功能使您的 Sim 代理能够直接在工作流中自动化 Dropbox 操作——从备份重要文件到分发内容以及维护有序的文件夹。将 Dropbox 用作文件的来源和目的地，使云存储管理成为您业务流程的一部分。
将 Dropbox 集成到您的工作流中，用于文件管理、分享和协作。上传文件、下载内容、创建文件夹、管理共享链接等。
上传文件到 Dropbox
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 文件应保存到 Dropbox 的路径 (例如：/folder/document.pdf) |
fileContent | string | 是 | 要上传文件的 base64 编码内容 |
fileName | string | 否 | 可选文件名 (如果路径是文件夹时使用) |
mode | string | 否 | 写入模式：add (默认) 或 overwrite |
autorename | boolean | 否 | 如果为 true，在发生冲突时重命名文件 |
mute | boolean | 否 | 如果为 true，不通知用户此上传 |
从 Dropbox 下载文件并获取临时链接
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 要下载文件的路径 (例如：/folder/document.pdf) |
列出 Dropbox 文件夹的内容
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 要列出内容的文件夹路径 (根目录使用 "") |
recursive | boolean | 否 | 如果为 true，则递归列出内容 |
includeDeleted | boolean | 否 | 如果为 true，则包括已删除的文件/文件夹 |
includeMediaInfo | boolean | 否 | 如果为 true，则包括照片/视频的媒体信息 |
limit | number | 否 | 要返回的最大结果数 (默认值：500) |
| 参数 | 类型 | 描述 |
|---|
entries | array | 目录中的文件和文件夹列表 |
在 Dropbox 中创建一个新文件夹
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 创建文件夹的路径 (例如：/new-folder) |
autorename | boolean | 否 | 如果有冲突，是否重命名文件夹 |
| 参数 | 类型 | 描述 |
|---|
folder | object | 创建的文件夹元数据 |
删除 Dropbox 中的文件或文件夹（移至回收站）
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 要删除的文件或文件夹的路径 |
| 参数 | 类型 | 描述 |
|---|
metadata | object | 已删除项目的元数据 |
复制 Dropbox 中的文件或文件夹
| 参数 | 类型 | 必需 | 描述 |
|---|
fromPath | string | 是 | 要复制的文件或文件夹的源路径 |
toPath | string | 是 | 复制文件或文件夹的目标路径 |
autorename | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 |
| 参数 | 类型 | 描述 |
|---|
metadata | object | 已复制项目的元数据 |
移动或重命名 Dropbox 中的文件或文件夹
| 参数 | 类型 | 必需 | 描述 |
|---|
fromPath | string | 是 | 要移动的文件或文件夹的源路径 |
toPath | string | 是 | 移动文件或文件夹的目标路径 |
autorename | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 |
| 参数 | 类型 | 描述 |
|---|
metadata | object | 已移动项目的元数据 |
获取 Dropbox 中文件或文件夹的元数据
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 要获取元数据的文件或文件夹路径 |
includeMediaInfo | boolean | 否 | 如果为 true，则包含照片/视频的媒体信息 |
includeDeleted | boolean | 否 | 如果为 true，则在结果中包含已删除的文件 |
| 参数 | 类型 | 描述 |
|---|
metadata | object | 文件或文件夹的元数据 |
为 Dropbox 中的文件或文件夹创建可共享链接
| 参数 | 类型 | 必需 | 描述 |
|---|
path | string | 是 | 要共享的文件或文件夹路径 |
requestedVisibility | string | 否 | 可见性：public、team_only 或 password |
linkPassword | string | 否 | 共享链接的密码（仅当可见性为 password 时） |
expires | string | 否 | ISO 8601 格式的过期日期（例如：2025-12-31T23:59:59Z） |
| 参数 | 类型 | 描述 |
|---|
sharedLink | object | 创建的共享链接 |
在 Dropbox 中搜索文件和文件夹
| 参数 | 类型 | 必需 | 描述 |
|---|
query | string | 是 | 搜索查询 |
path | string | 否 | 将搜索限制在特定文件夹路径内 |
fileExtensions | string | 否 | 用逗号分隔的文件扩展名列表进行过滤（例如：pdf,xlsx） |
maxResults | number | 否 | 返回的最大结果数（默认值：100） |
