本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 盒子动作集成
<a name="box-action-integration"></a>

借助 Box 操作连接器，您可以直接在 Amazon Quick 中使用自然语言访问 Box AI 功能、管理文件和文件夹以及整理中心中的内容。

Amazon Quick 支持 Box Agent 的以下身份验证方法。
+ **默认 OAuth 应用程序**-使用 AWS由托管的 OAuth 应用程序。无需其他凭证。您可以直接使用您的 Box 帐户进行身份验证。
+ **自定义 OAuth 应用程序**-使用在 Box 开发者控制台中注册的客户管理的 OAuth 2.0 应用程序。此选项可让您的组织完全控制 OAuth 配置。

有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅[身份验证方法](quick-action-auth.md)。

## 开始前的准备工作
<a name="box-action-prerequisites"></a>

在设置集成之前，请确保您具备以下条件。
+ 一个有权访问文件和文件夹的 Box 账户。
+ 对于**自定义 OAuth 应用程序**：访问 Box 开发者控制台以创建自定义应用程序。有关更多信息，请参阅 [Box 文档中的 OAuth 2.0 设置](https://developer.box.com/guides/authentication/oauth2/oauth2-setup)。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 在 Amazon Quick 中设置连接器
<a name="box-action-quicksuite-setup"></a>

### 从 “可用” 选项卡连接
<a name="box-action-quick-connect"></a>

如果要使用默认 OAuth 应用程序身份验证，则无需额外配置即可直接从 “**可用**” 选项卡进行连接。

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 在 “**可用**” 选项卡上，找到 **Box Agent**，然后选择 **Connect**。

1. 完成 Box 登录流程并授予所请求的权限。

要改为使用自定义 OAuth 应用程序配置连接器，请使用**为团队创建**选项卡，如下所述。

### 从 “为你的团队创建” 选项卡创建
<a name="box-action-full-setup"></a>

如果您使用自定义 OAuth 应用程序身份验证，请在配置 Amazon Quick 之前在 Box 开发者控制台中创建自定义应用程序。有关设置说明，请参阅 [Box 文档中的 OAuth 2.0 设置](https://developer.box.com/guides/authentication/oauth2/oauth2-setup)。

1. 在 Amazon Quick 控制台中，选择**连接器**。

1. 选择 “**为你的团队创建**” 选项卡。

1. 找到并选择 **Box Agent**。
**注意**  
如果 Box Agent 连接器已经存在，则会出现一个包含现有连接器的对话框。要使用现有的连接器，请选择它。要创建新的，请选择 “**否，新建**”。

1. 输入连接器的**名称**。（可选）选择 **\+ 添加描述**以添加描述。

1. 对于**连接类型**，请选择**公共网络**。

1. 对于 **OAuth 配置**，请选择以下选项之一：

   1. 对于**默认 OAuth 应用程序：**

      无需其他凭证。选择**下一步**以继续。

   1. 对于**自定义 OAuth 应用程序**，请配置以下字段：
      + **基本网址**（可选）— Box API 基础网址。示例：`https://mcp.box.com`
      + **客户端 ID** — 来自您的 Box 应用程序的客户端 ID。
      + **客户密钥** — 来自您的 Box 应用程序的客户机密钥。

1. 选择**下一步**。

1. 将打开 Box 授权窗口。查看请求的权限，然后选择 “向 **Box 授予访问权限”**。

1. 在 “**查看**” 页面上，查看连接器的可用操作。选择**下一步**。

1. 在 “**发布**” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

1. 选择**发布**。

## 可用操作
<a name="box-action-available-actions"></a>

设置连接器后，可以执行以下操作。


**Box Agent 可用操作**  

| 类别 | 处理建议 | 说明 | 
| --- | --- | --- | 
| AI | 人工智能问答 (Hub) | 使用 Box AI 向 Box Hub 提问。 | 
| AI | AI 问答（单文件） | 使用 Box AI 向单个文件提问。 | 
| AI | AI 问答（多个文件） | 使用 Box AI 向多个文件提问。 | 
| AI | AI 提取物（自由格式） | 使用自由格式的 Box AI 从文件中提取元数据。 | 
| AI | AI 提取（结构化） | 根据自定义字段或元数据模板使用 Box AI 从文件中提取结构化元数据。 | 
| 文件 | 获取文件内容 | 对于小于 50 MB 的文件，以文本格式提取并返回文件内容。 | 
| 文件 | 获取文件详情 | 获取全面的文件信息，包括元数据、权限和版本详细信息。 | 
| 文件 | 更新文件属性 | 更新文件元数据，包括名称、描述、标签和集合。 | 
| 文件 | 上传文件 | 将新文件上传到 Box。 | 
| 文件 | 上传文件版本 | 上传现有文件的新版本。 | 
| 文件 | 搜索文件 | 使用支持元数据过滤器和文件扩展名筛选的关键字搜索文件。 | 
| 文件夹 | Create Folder | 在 Box 中创建一个新文件夹。 | 
| 文件夹 | 获取文件夹详情 | 检索全面的文件夹信息，包括元数据和协作设置。 | 
| 文件夹 | 列出文件夹内容 | 列出文件夹中的文件、文件夹和 Web 链接。 | 
| 文件夹 | 更新文件夹属性 | 更新文件夹元数据，包括名称、描述、标签和收藏夹。 | 
| 文件夹 | 搜索文件夹 | 使用关键字匹配按名称搜索文件夹。 | 
| 集线器 | 创建中心 | 创建用于组织内容的新中心。 | 
| 集线器 | 获取集线器详情 | 检索有关特定集线器的信息。 | 
| 集线器 | 获取中心物品 | 检索中心内的项目，包括文件、文件夹和 Web 链接。 | 
| 集线器 | 列出集线器 | 列出当前用户可以访问的所有集线器。 | 
| 集线器 | 更新中心 | 更新集线器的标题或描述。 | 
| 集线器 | 将物品添加到中心 | 向中心添加文件、文件夹或 Web 链接。 | 
| 评论和任务 | 创建文件评论 | 在文件上创建新评论。 | 
| 评论和任务 | 列出文件评论 | 列出对文件的所有评论。 | 
| 评论和任务 | 列出任务 | 列出与文件关联的所有任务。 | 
| Users | 我是谁 | 返回有关当前已通过身份验证的用户的信息。 | 

## 管理和故障排除
<a name="box-action-troubleshooting"></a>

有关编辑、共享或删除连接器的说明，请参阅[管理现有集成](integration-workflows.md#managing-existing-integrations)。
+ **身份验证弹出窗口失败** — 确认您的浏览器允许来自 Amazon Quick 控制台域的弹出窗口。
+ **无效的客户端凭证（自定义 OAuth 应用程序）**-验证客户端 ID 和客户端密钥是否与 Box 开发者控制台应用程序中的值相匹配。
+ **权限不足**-验证您的 Box 帐户是否有权访问您尝试访问的文件、文件夹或集线器。