---
title: Dropbox
description: 在 Dropbox 中上传、下载、分享和管理文件
---

import { BlockInfoCard } from "@/components/ui/block-info-card"

<BlockInfoCard 
  type="dropbox"
  color="#0061FF"
/>

{/* MANUAL-CONTENT-START:intro */}
[Dropbox](https://dropbox.com/) 是一个流行的云存储和协作平台，能够让个人和团队安全地存储、访问和分享文件，无论身在何处。Dropbox 专为便捷的文件管理、同步和强大的协作而设计，无论您是单独工作还是与团队合作。

在 Sim 中使用 Dropbox，您可以：

- **上传和下载文件**：无缝上传任何文件到您的 Dropbox 或按需检索内容
- **列出文件夹内容**：浏览任何 Dropbox 目录中的文件和文件夹
- **创建新文件夹**：通过编程方式在您的 Dropbox 中创建新文件夹以组织文件
- **搜索文件和文件夹**：通过名称或内容定位文档、图片或其他项目
- **生成共享链接**：快速为文件和文件夹创建可分享的公共或私人链接
- **管理文件**：在自动化工作流中移动、删除或重命名文件和文件夹

这些功能使您的 Sim 代理能够直接在工作流中自动化 Dropbox 操作——从备份重要文件到分发内容以及维护有序的文件夹。将 Dropbox 用作文件的来源和目的地，使云存储管理成为您业务流程的一部分。
{/* MANUAL-CONTENT-END */}

## 使用说明

将 Dropbox 集成到您的工作流中，用于文件管理、分享和协作。上传文件、下载内容、创建文件夹、管理共享链接等。

## 工具

### `dropbox_upload`

上传文件到 Dropbox

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 文件应保存到 Dropbox 的路径 \(例如：/folder/document.pdf\) |
| `fileContent` | string | 是 | 要上传文件的 base64 编码内容 |
| `fileName` | string | 否 | 可选文件名 \(如果路径是文件夹时使用\) |
| `mode` | string | 否 | 写入模式：add \(默认\) 或 overwrite |
| `autorename` | boolean | 否 | 如果为 true，在发生冲突时重命名文件 |
| `mute` | boolean | 否 | 如果为 true，不通知用户此上传 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `file` | object | 上传文件的元数据 |

### `dropbox_download`

从 Dropbox 下载文件并获取临时链接

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 要下载文件的路径 \(例如：/folder/document.pdf\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `file` | object | 文件的元数据 |

### `dropbox_list_folder`

列出 Dropbox 文件夹的内容

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 要列出内容的文件夹路径 \(根目录使用 ""\) |
| `recursive` | boolean | 否 | 如果为 true，则递归列出内容 |
| `includeDeleted` | boolean | 否 | 如果为 true，则包括已删除的文件/文件夹 |
| `includeMediaInfo` | boolean | 否 | 如果为 true，则包括照片/视频的媒体信息 |
| `limit` | number | 否 | 要返回的最大结果数 \(默认值：500\) |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `entries` | array | 目录中的文件和文件夹列表 |

### `dropbox_create_folder`

在 Dropbox 中创建一个新文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 创建文件夹的路径 \(例如：/new-folder\) |
| `autorename` | boolean | 否 | 如果有冲突，是否重命名文件夹 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `folder` | object | 创建的文件夹元数据 |

### `dropbox_delete`

删除 Dropbox 中的文件或文件夹（移至回收站）

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 要删除的文件或文件夹的路径 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `metadata` | object | 已删除项目的元数据 |

### `dropbox_copy`

复制 Dropbox 中的文件或文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | 是 | 要复制的文件或文件夹的源路径 |
| `toPath` | string | 是 | 复制文件或文件夹的目标路径 |
| `autorename` | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `metadata` | object | 已复制项目的元数据 |

### `dropbox_move`

移动或重命名 Dropbox 中的文件或文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `fromPath` | string | 是 | 要移动的文件或文件夹的源路径 |
| `toPath` | string | 是 | 移动文件或文件夹的目标路径 |
| `autorename` | boolean | 否 | 如果为 true，则在目标位置存在冲突时重命名文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `metadata` | object | 已移动项目的元数据 |

### `dropbox_get_metadata`

获取 Dropbox 中文件或文件夹的元数据

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 要获取元数据的文件或文件夹路径 |
| `includeMediaInfo` | boolean | 否 | 如果为 true，则包含照片/视频的媒体信息 |
| `includeDeleted` | boolean | 否 | 如果为 true，则在结果中包含已删除的文件 |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `metadata` | object | 文件或文件夹的元数据 |

### `dropbox_create_shared_link`

为 Dropbox 中的文件或文件夹创建可共享链接

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `path` | string | 是 | 要共享的文件或文件夹路径 |
| `requestedVisibility` | string | 否 | 可见性：public、team_only 或 password |
| `linkPassword` | string | 否 | 共享链接的密码（仅当可见性为 password 时） |
| `expires` | string | 否 | ISO 8601 格式的过期日期（例如：2025-12-31T23:59:59Z） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `sharedLink` | object | 创建的共享链接 |

### `dropbox_search`

在 Dropbox 中搜索文件和文件夹

#### 输入

| 参数 | 类型 | 必需 | 描述 |
| --------- | ---- | -------- | ----------- |
| `query` | string | 是 | 搜索查询 |
| `path` | string | 否 | 将搜索限制在特定文件夹路径内 |
| `fileExtensions` | string | 否 | 用逗号分隔的文件扩展名列表进行过滤（例如：pdf,xlsx） |
| `maxResults` | number | 否 | 返回的最大结果数（默认值：100） |

#### 输出

| 参数 | 类型 | 描述 |
| --------- | ---- | ----------- |
| `matches` | array | 搜索结果 |
