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

# 访客集成
<a name="visier-integration"></a>

**注意**  
本指南涵盖了通过第三方 MCP 服务器验证的集成。Visier 管理 MCP 服务器的设置和可用性。

借助 Amazon Quick 中的 Visier 集成，您可以通过模型上下文协议 (MCP) 服务器连接直接访问 Visier 的人物分析平台。您无需离开 Amazon Quick 即可查询实时员工数据、分析员工人数趋势、评估留存状况、生成员工简报等。

Visier 可作为 MCP-based 连接器在 Amazon Quick 中使用。要设置此集成，请完成以下两个步骤。首先，使用所需的 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 环境。
+ 您在 Visier 管理员控制台的 **“设置、**API 和**集成”** 下启用了 MCP 服务器功能。
+ 您的账户可以访问您要查询的劳动力数据和分析。

## 在 Amazon Quick 中设置集成
<a name="visier-integration-setup"></a>

验证您的 Visier 账户访问权限后，在 Amazon Quick 中创建集成。安装向导分为四个步骤：Connect、Authenticate、Review 和 Share 集成。

### Connect
<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 客户端密钥。
   + **令牌网址**-OAuth 令牌端点。
   + **授权网址**-OAuth 授权端点。

   Amazon Quick 会预填**重定向网址**。

1. 选择**创建并继续**。

1. 在出现的 Visier 登录弹出窗口中，输入您的 Visier 凭据并选择 “**登录**” 以授权 Amazon Quick 代表您访问 Visier。

### Review
<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 服务器将其人员分析功能作为可调用工具公开。


**访客可用操作**  

| 处理建议 | 说明 | 
| --- | --- | 
| ask\_vee\_question | 向 Visier's 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 服务器处于活动状态。此外，请确认您的身份验证凭证未过期。