View a markdown version of this page

Box Agent 整合 - Amazon Quick
開始之前在 Amazon Quick 中設定連接器可用動作管理和疑難排解

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

Box Agent 整合

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

Amazon Quick 支援 Box Agent 的下列身分驗證方法。

  • 預設 OAuth 應用程式 – 使用 AWS受管 OAuth 應用程式。不需要額外的登入資料。您使用 Box 帳戶直接進行身分驗證。

  • 自訂 OAuth 應用程式 – 使用在 Box Developer Console 中註冊的客戶受管 OAuth 2.0 應用程式。此選項可讓您的組織完全控制 OAuth 組態。

如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 身分驗證方法。

開始之前

在設定整合之前，請確定您有下列項目。

  • 可存取檔案和資料夾的 Box 帳戶。

  • 對於自訂 OAuth 應用程式：存取 Box Developer Console 以建立自訂應用程式。如需詳細資訊，請參閱 Box 文件中的 OAuth 2.0 設定。

  • 如需 Amazon Quick 訂閱需求，請參閱 在主控台中設定整合。

在 Amazon Quick 中設定連接器

從可用索引標籤連線

如果您想要使用預設 OAuth 應用程式身分驗證，您可以直接從可用索引標籤連線，而不需要其他組態。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 在可用索引標籤上，尋找 Box Agent，然後選擇連線。

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

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

從為您的團隊建立索引標籤建立

如果您使用自訂 OAuth 應用程式身分驗證，請先在 Box Developer Console 中建立自訂應用程式，再設定 Amazon Quick。如需設定說明，請參閱 Box 文件中的 OAuth 2.0 設定。

  1. 在 Amazon Quick 主控台中，選擇連接器。

  2. 選擇為您的團隊建立索引標籤。

  3. 尋找並選擇 Box Agent。

    注意

    如果 Box Agent 連接器已存在，則會顯示一個對話方塊，其中包含您現有的連接器。若要使用現有的連接器，請選擇它。若要建立新的，請選擇否，建立新的。

  4. 輸入連接器的名稱。或者，選擇 + 新增描述以新增描述。

  5. 針對連線類型，選擇公有網路。

  6. 針對 OAuth 組態，選擇下列其中一項：

    1. 對於預設 OAuth 應用程式：

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

    2. 對於自訂 OAuth 應用程式，請設定下列欄位：

      • 基本 URL （選用） – Box API 基本 URL。範例：https://mcp.box.com

      • 用戶端 ID – 來自您 Box 應用程式的用戶端 ID。

      • 用戶端秘密 – 來自您 Box 應用程式的用戶端秘密。

  7. 選擇下一步。

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

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

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

  11. 選擇發布。

可用動作

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

Box Agent 可用的動作
Category Action Description
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 連結新增至中樞。
評論和任務 建立檔案註解 對檔案建立新的註解。
評論和任務 列出檔案註解 列出檔案的所有註解。
評論和任務 列出任務 列出與檔案相關聯的所有任務。
使用者 我是誰 傳回目前驗證使用者的相關資訊。

管理和疑難排解

如需編輯、共用或刪除連接器的指示，請參閱 管理現有的整合。

  • 身分驗證快顯視窗失敗 – 驗證您的瀏覽器是否允許來自 Amazon Quick 主控台網域的快顯視窗。

  • 無效用戶端登入資料 （自訂 OAuth 應用程式） – 確認用戶端 ID 和用戶端秘密符合您 Box 開發人員主控台應用程式中的值。

  • 許可不足 – 確認您的 Box 帳戶可存取您嘗試存取的檔案、資料夾或中樞。