本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Box 動作整合
<a name="box-action-integration"></a>

使用 Box 動作連接器，您可以存取 Box AI 功能、管理檔案和資料夾，並透過自然語言直接在 Amazon Quick 中樞中組織內容。

Amazon Quick 支援 Box Agent 的下列身分驗證方法。
+ **預設 OAuth 應用程式** – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Box 帳戶直接進行身分驗證。
+ **自訂 OAuth 應用程式** – 使用在 Box Developer Console 中註冊的客戶受管 OAuth 2.0 應用程式。此選項可讓您的組織完全控制 OAuth 組態。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="box-action-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 可存取檔案和資料夾的 Box 帳戶。
+ 對於**自訂 OAuth 應用程式**：存取 Box Developer Console 以建立自訂應用程式。如需詳細資訊，請參閱 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** 並選擇**連線**。

1. 完成 Box 登入流程，並授予請求的許可。

若要改為使用自訂 OAuth 應用程式設定連接器，請使用**為您的團隊建立**索引標籤，如下所述。

### 從為您的團隊建立索引標籤建立
<a name="box-action-full-setup"></a>

如果您使用自訂 OAuth 應用程式身分驗證，請先在 Box Developer Console 中建立自訂應用程式，再設定 Amazon Quick。如需設定說明，請參閱 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 應用程式**：

      不需要額外的登入資料。選擇 **Next** (下一步) 繼續。

   1. 對於**自訂 OAuth 應用程式**，請設定下列欄位：
      + **基本 URL** （選用） – Box API 基本 URL。範例：`https://mcp.box.com`
      + **用戶端 ID** – 來自您 Box 應用程式的用戶端 ID。
      + **用戶端秘密** – 來自您 Box 應用程式的用戶端秘密。

1. 選擇**下一步**。

1. Box 授權視窗隨即開啟。檢閱請求的許可，然後選擇**授予對 Box 的存取權**。

1. 在**檢閱**頁面上，檢閱連接器的可用動作。選擇**下一步**。

1. 在**發佈**頁面上，選擇誰可以存取連接器。您可以為組織中的每個人啟用存取權，或搜尋特定的團隊或群組。

1. 選擇**發布**。

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

設定連接器之後，可以使用下列動作。


**Box Agent 可用的動作**  

| Category | Action | 說明 | 
| --- | --- | --- | 
| AI | AI Q&A (Hub) | 使用 Box AI 向 Box Hub 提出問題。 | 
| AI | AI Q&A （單一檔案） | 使用 Box AI 向單一檔案提出問題。 | 
| AI | AI Q&A （多個檔案） | 使用 Box AI 向多個檔案提出問題。 | 
| AI | AI 擷取 （自由格式） | 使用自由格式的 Box AI 從檔案擷取中繼資料。 | 
| AI | AI 擷取 （結構化） | 根據自訂欄位或中繼資料範本，使用 Box AI 從檔案擷取結構化中繼資料。 | 
| 檔案 | 取得檔案內容 | 擷取和傳回 50 MB 以下檔案的文字格式檔案內容。 | 
| 檔案 | 取得檔案詳細資訊 | 取得完整的檔案資訊，包括中繼資料、許可和版本詳細資訊。 | 
| 檔案 | 更新檔案屬性 | 更新檔案中繼資料，包括名稱、描述、標籤和集合。 | 
| 檔案 | 上傳檔案 | 將新檔案上傳至 Box。 | 
| 檔案 | 上傳檔案版本 | 上傳現有檔案的新版本。 | 
| 檔案 | 搜尋檔案 | 使用關鍵字搜尋檔案，並支援中繼資料篩選條件和副檔名篩選。 | 
| 資料夾 | 建立資料夾 | 在 Box 中建立新資料夾。 | 
| 資料夾 | 取得資料夾詳細資訊 | 擷取完整的資料夾資訊，包括中繼資料和協同合作設定。 | 
| 資料夾 | 列出資料夾內容 | 列出資料夾中的檔案、資料夾和 Web 連結。 | 
| 資料夾 | 更新資料夾屬性 | 更新資料夾中繼資料，包括名稱、描述、標籤和集合。 | 
| 資料夾 | 搜尋資料夾 | 使用關鍵字比對依名稱搜尋資料夾。 | 
| 中樞 | 建立中樞 | 建立新的中樞以組織內容。 | 
| 中樞 | 取得中樞詳細資訊 | 擷取特定中樞的相關資訊。 | 
| 中樞 | 取得中樞項目 | 在中樞內擷取項目，包括檔案、資料夾和 Web 連結。 | 
| 中樞 | 列出中樞 | 列出目前使用者可存取的所有中樞。 | 
| 中樞 | 更新中樞 | 更新中樞的標題或描述。 | 
| 中樞 | 將項目新增至中樞 | 將檔案、資料夾或 Web 連結新增至中樞。 | 
| 評論和任務 | 建立檔案註解 | 對檔案建立新的註解。 | 
| 評論和任務 | 列出檔案註解 | 列出檔案的所有註解。 | 
| 評論和任務 | 列出任務 | 列出與檔案相關聯的所有任務。 | 
| 使用者 | 我是誰 | 傳回目前驗證使用者的相關資訊。 | 

## 管理和疑難排解
<a name="box-action-troubleshooting"></a>

如需編輯、共用或刪除連接器的指示，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。
+ **身分驗證快顯視窗失敗** – 驗證您的瀏覽器是否允許來自 Amazon Quick 主控台網域的快顯視窗。
+ **無效用戶端登入資料 （自訂 OAuth 應用程式）** – 確認用戶端 ID 和用戶端秘密符合您 Box 開發人員主控台應用程式中的值。
+ **許可不足** – 確認您的 Box 帳戶可存取您嘗試存取的檔案、資料夾或中樞。