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

# Visier Agent 整合
<a name="visier-integration"></a>

使用 Visier Agent 動作連接器，您可以透過自然語言直接在 Amazon Quick 中存取 Visier 的人員分析平台。您可以查詢即時人力資源資料、分析人數趨勢、評估保留運作狀態、產生人力資源簡報等，而無需離開 Amazon Quick。

Visier Agent 使用自訂 OAuth 應用程式身分驗證。如需 Amazon Quick 支援的身分驗證方法的詳細資訊，請參閱 [身分驗證方法](quick-action-auth.md)。

## 開始之前
<a name="visier-integration-prerequisites"></a>

在設定整合之前，請確定您有下列項目。
+ 啟用 API 存取和 Visier Agent 的作用中 Visier 帳戶。如需有關啟用 Visier Agent 和設定身分驗證的資訊，請參閱 [Visier MCP Server 文件](https://docs.visier.com/developer/agents/mcp/mcp-server-set-up.htm)。
+ 針對您要查詢的人力資源資料，在您的 Visier 帳戶中設定適當的資料存取範圍。
+ 來自 Visier 管理員的 OAuth 登入資料 （用戶端 ID 和用戶端秘密）。
+ 如需 Amazon Quick 訂閱需求，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

## 設定 Visier
<a name="visier-source-setup"></a>

設定 Amazon Quick 之前，請先在 Visier 管理員主控台中完成下列步驟。

1. 登入您的 Visier 管理員主控台，並確認您的帳戶處於作用中狀態。

1. 在**設定**、**API 和整合**下啟用 Visier Agent 功能。

1. 註冊 Amazon Quick 的 OAuth 用戶端，並將 Amazon Quick 回呼 URL 新增至重新導向 URIs 清單： `https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   將AWS{{{region}}} 取代為您的區域 （例如 `us-east-1`)。

1. 記錄**用戶端 ID** 和**用戶端秘密**。您在設定 Amazon Quick 時需要它們。

1. 確認您要查詢的人力資源資料和分析可供您的帳戶存取。

## 在 Amazon Quick 中設定連接器
<a name="visier-quicksuite-setup"></a>

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

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

1. 尋找並選擇 **Visier Agent**。

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

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

1. 針對 **OAuth 組態**，選擇**自訂 OAuth 應用程式**並設定下列欄位：
   + **基本 URL** – Visier Agent MCP 基本 URL，由 Amazon Quick 預先填入。
   + **用戶端 ID** – 來自 Visier 管理員主控台的 OAuth 用戶端 ID。
   + **Public OAuth 用戶端** （選用） – 如果您的 Visier OAuth 用戶端設定為公有用戶端 （無用戶端秘密），請選取此選項。
   + **用戶端秘密** – 來自 Visier 管理員主控台的 OAuth 用戶端秘密。
   + **權杖 URL** – Amazon Quick 預先填入的 OAuth 權杖端點。
   + **授權 URL** – 由 Amazon Quick 預先填入的 OAuth 授權端點。
   + **重新導向 URL** – 預先填入 Amazon Quick 回呼 URL。

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

1. 在出現的 Visier 登入快顯視窗中，輸入您的 Visier 登入資料，然後選擇**登入**以授權 Amazon Quick 代表您存取 Visier。

1. 在**檢閱**頁面上，Amazon Quick 探索 Visier Agent 公開的工具，並將其顯示在資料表中。檢閱可用的動作清單，然後選擇**下一步**。

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

1. 選擇**發布**。

## 可用動作
<a name="visier-integration-actions"></a>

設定連接器之後，您可以使用下列動作。Visier Agent 將其人員分析功能公開為可呼叫的工具。


**Visier Agent 可用的動作**  

| Action | 說明 | 
| --- | --- | 
| ask\_vee\_question | 向 Visier 的 Vee AI 詢問自然語言人力資源問題，例如人數、流動率或申請。 | 
| aggregate\_metric\_values | 計算指標的彙總值，選擇性地依維度分組，並依特定成員篩選。 | 
| sample\_vee\_questions | 傳回您可以要求 Vee 開始使用的範例問題清單。 | 
| search\_analytic\_objects | 尋找符合搜尋字串的分析物件 （例如，員工或申請人）。 | 
| search\_analytic\_object\_properties | 傳回指定分析物件的所有可用屬性。 | 
| list\_analytic\_object\_property\_values | 列出特定分析物件成員的屬性值，例如員工年資或薪資。 | 
| search\_metrics | 尋找符合搜尋字串的指標。 | 
| search\_dimensions\_for\_metric | 尋找可用於指定指標的維度，可用於分組或篩選。 | 
| search\_dimensions\_for\_analytic\_object | 尋找特定分析物件可用的維度。 | 
| search\_filter\_dimension\_members | 傳回指定維度的可篩選成員。 | 
| get\_object\_reference\_graph | 傳回參考圖表，顯示指定的分析物件如何連接到其他物件。 | 

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

若要編輯、共用或刪除連接器，請參閱 [管理現有的整合](integration-workflows.md#managing-existing-integrations)。

### 驗證問題
<a name="visier-troubleshooting-auth"></a>
+ **MCP 伺服器連線失敗** – 確認您已在 Visier 管理員主控台的設定****、**API 和整合**下啟用 Visier Agent 功能。確認您已在 Amazon Quick 中正確輸入基本 URL、權杖 URL 和授權 URL。
+ **無效的用戶端登入**資料 – 驗證用戶端 ID 和用戶端秘密是否與 Visier 管理員主控台中的值相符。確認 Visier OAuth 用戶端中的重新導向 URI 符合 Amazon Quick 回呼 URL。
+ **資料存取錯誤** – 確認您的 Visier 帳戶中設定的資料存取範圍包含您嘗試查詢的人力資源資料。請聯絡您的 Visier 管理員以檢閱您的帳戶許可。
+ **未發現任何工具** – 如果 Amazon Quick 在您建立連接器後未發現任何工具，請確認 Visier Agent 處於作用中狀態，且您的身分驗證憑證尚未過期。