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

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

**注意**  
本指南涵蓋經過第三方 MCP 伺服器驗證的整合。Visier 會管理 MCP 伺服器的設定和可用性。

透過 Amazon Quick 中的 Visier 整合，您可以透過模型內容協定 (MCP) 伺服器連線直接存取 Visier 的人員分析平台。您可以查詢即時人力資源資料、分析人數趨勢、評估保留運作狀態、產生人力資源簡報等，而無需離開 Amazon Quick。

Visier 可在 Amazon Quick 中做為 MCP 型連接器使用。若要設定此整合，請完成下列兩個步驟。首先，使用必要的 API 存取和 MCP 伺服器組態準備您的 Visier 帳戶。然後，在 Amazon Quick 中建立整合，並使用您的 Visier 登入資料進行驗證。

## 先決條件
<a name="visier-integration-prerequisites"></a>

設定整合之前，請確定您擁有下列資源和存取權。
+ 啟用 API 存取和 MCP 伺服器的有效 Visier 帳戶。如需有關啟用 MCP 伺服器和設定身分驗證的資訊，請參閱 [Visier MCP 伺服器文件](https://docs.visier.com/developer/agents/mcp/mcp-server-set-up.htm)。
+ 針對您要查詢的人力資源資料，在您的 Visier 帳戶中設定適當的資料存取範圍。
+ 如需訂閱需求的相關資訊，請參閱 [在主控台中設定整合](integration-console-setup-process.md)。

## 驗證您的 Visier 帳戶
<a name="visier-account-setup"></a>

設定 Amazon Quick 之前，請確認您的 Visier 帳戶符合下列要求。
+ 您的 Visier 帳戶處於作用中狀態，您可以登入您的 Visier 環境。
+ 您已在**設定**、**API 和整合**下的 Visier 管理員主控台中啟用 MCP Server 功能。
+ 您想要查詢的人力資源資料和分析可供您的帳戶存取。

## 在 Amazon Quick 中設定整合
<a name="visier-integration-setup"></a>

驗證 Visier 帳戶存取權後，請在 Amazon Quick 中建立整合。安裝精靈有四個步驟：連線、驗證、檢閱和共用整合。

### 連接
<a name="visier-integration-setup-connect"></a>

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

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

1. 尋找並選擇**模型內容通訊協定 (MCP)**。

1. 在**建立整合**頁面上，輸入下列欄位：
   + **名稱** – Visier 整合的描述性名稱。
   + **描述** （選用） – 有關計劃如何使用此連線的備註。
   + **MCP 伺服器端點** – 來自 Visier 管理員主控台的 MCP 伺服器端點 URL。
   + **連線類型** – 選擇**公有網路**。

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

### 驗證
<a name="visier-integration-setup-authenticate"></a>

1. 在**身分驗證設定**下，輸入來自 Visier MCP 伺服器組態的 OAuth 憑證：
   + **用戶端 ID** – OAuth 用戶端 ID。
   + **用戶端秘密** – OAuth 用戶端秘密。
   + **權杖 URL** – OAuth 權杖端點。
   + **授權 URL** – OAuth 授權端點。

   Amazon Quick 會預先填入**重新導向 URL**。

1. 選擇**建立並繼續**。

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

### 檢閱
<a name="visier-integration-setup-review"></a>

1. 在**檢閱**頁面上，Amazon Quick 探索 Visier MCP 伺服器公開的工具，並將其顯示在資料表中。檢閱可用的動作清單，以確認預期的工具存在。

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

### 共用整合
<a name="visier-integration-setup-share"></a>

1. （選用） 在**共用整合**頁面上，搜尋要與其共用整合的團隊或群組。

1. 選擇**完成**。

整合會出現在**現有動作**面板中，狀態為**可用**。

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

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


**Visier 可用的動作**  

| Action | Description | 
| --- | --- | 
| 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 和整合**下啟用 MCP 伺服器功能。確認您已在 Amazon Quick 中正確輸入端點 URL 和登入資料。
+ **資料存取錯誤** – 確認您的 Visier 帳戶中設定的資料存取範圍包含您嘗試查詢的人力資源資料。請聯絡您的 Visier 管理員以檢閱您的帳戶許可。
+ **未發現任何工具** – 如果 Amazon Quick 在您輸入 MCP 伺服器 URL 後未發現任何工具，請確認 MCP 伺服器處於作用中狀態。同時確認您的身分驗證憑證尚未過期。