> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fetchhive.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Box

> 通过已连接的账户进行安全的文件存储、共享、协作和治理。

# Box

当你的工作流需要安全的文件和文件夹管理、共享或审阅时，请使用 Box。你也可以用它来搜索内容、添加评论，以及将文档路由以供签名。

## 配置

| 选项 | 必填 | 描述 |
| - | - | - |
| 名称 | 否 | 工作流画布中此步骤的标签。 |
| Authentication | 是 | 此步骤要使用的已连接 Box 账户。 |
| Action | 是 | 要执行的 Box 操作（例如 Get file information、Update file、Download file、Copy file）。 |
| Arguments | 是 | 根据操作的 schema 生成的各操作表单字段。每个文本字段都有一个 **Insert Variable** 按钮，用于注入 `{{placeholder}}` 值。高级用法还可使用 **Raw JSON** 选项卡。 |
| When the step fails | 否 | 控制当此步骤失败时，工作流应 **Terminate Workflow** 还是 **Continue**。 |

在配置此步骤之前，请通过登录流程在你工作区的 **Integrations** 中连接 Box。如果没有可用的活动连接，该步骤会显示一个带有指向 **Integrations** 链接的警告，而不是账户选择器。

## 参数表单

当你选择某个操作时，**Arguments** 部分会渲染一个由该操作输入 schema 驱动的表单。

如果你更喜欢手动编写完整的参数对象，请切换到 **Raw JSON** 选项卡。任一选项卡中的更改都会保持同步。

## 常用操作

| 操作 | 描述 |
| - | - |
| **Get file information** | 检索文件的详细信息。 |
| **Update file** | 更新文件的详细信息或属性。 |
| **Download file** | 以二进制格式下载文件内容。 |
| **Copy file** | 在另一个文件夹中创建文件副本。 |
| **Get folder information** | 检索文件夹及其前几个项目的详细信息。 |
| **Create folder** | 创建一个新的空文件夹。 |
| **Update folder** | 更新文件夹的详细信息或设置。 |
| **List folder items** | 列出文件夹中的项目。 |
| **List file comments** | 列出文件上的所有评论。 |
| **Create comment** | 向文件添加评论或回复评论。 |
| **Get comment** | 检索评论的内容和元数据。 |
| **List file collaborations** | 列出文件上的所有有效和待处理协作。 |
| **List folder collaborations** | 列出文件夹上的所有有效和待处理协作。 |

破坏性操作，例如删除记录，在工作流操作选择器中不可用。

## 输出

此步骤会将 Box 响应存储为步骤输出。响应的结构取决于操作。

在后续步骤中使用完整的输出引用：

```text theme={null}
{{STEP_IDENTIFIER.output}}
```

## 示例

1. 打开 **Integrations**，如果你还没有这样做，请连接 Box。
2. 在你的工作流中添加一个 **Box** 步骤。
3. 在 **Authentication** 中选择一个已连接的账户。
4. 在 **Action** 中选择 **Get file information**。
5. 填写所需字段。对任何字段值，都可使用 **Insert Variable** 引用前一步的输出。
6. 点击步骤标题栏中的 **Run** 来测试该操作，然后在 **Output** 中查看返回的有效负载。

## 使用场景

### 审阅文件并添加评论

1. 搜索内容
2. 获取文件信息
3. 创建评论

### 与同事共享文件夹

1. 获取文件夹信息
2. 创建协作
3. 添加共享链接

### 发送文档以供签名

1. 获取文件信息
2. 创建 Box Sign 请求
3. 获取 Box Sign 请求

## 注意事项

* 此步骤依赖于你工作区中的已连接 Box 集成。
* 工作流操作选择器会显示一组精选操作。拥有 Box 工具的代理可以使用更多操作。
* 登录界面可能会显示第三方授权品牌标识。

## 将 Box 用作代理工具

你也可以在 **Agent Editor** 中将 Box 作为工具添加。打开代理，点击 **Add tool**，然后选择 **Box**。在工具设置面板中，选择代理应使用的已连接账户。代理会在 Box 操作与对话相关时调用它们。

另请参阅：[Integrations](https://docs.fetchhive.com/zh/workspace/integrations.md)、[Creating and Editing](https://docs.fetchhive.com/zh/workflows/creating-and-editing.md) 和 [Testing and Iteration](https://docs.fetchhive.com/zh/workflows/testing-and-iteration.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.