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

# 访客代理集成
<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 代理的活跃访客账户。有关启用 Visier 代理和配置身份验证的信息，请参阅 [Visier MCP](https://docs.visier.com/developer/agents/mcp/mcp-server-set-up.htm) 服务器文档。
+ 在您的 Visier 帐户中为要查询的员工数据配置相应的数据访问范围。
+ 来自 Visier 管理员的 OAuth 凭据（客户端 ID 和客户端密钥）。
+ 有关 Amazon Quick 订阅要求，请参阅[在控制台中设置集成](integration-console-setup-process.md)。

## 配置访客
<a name="visier-source-setup"></a>

在配置 Amazon Quick 之前，请在 Visier 管理控制台中完成以下步骤。

1. 登录您的 Visier 管理控制台并确认您的帐户处于活动状态。

1. 在 “**设置”、“**API 和集成**”** 下启用 Visier 代理功能。

1. 为 Amazon Quick 注册 OAuth 客户端，然后将 Amazon Quick 回传 URI 添加到重定向 URI 列表中：`https://{{{region}}}.quicksight.aws.amazon.com/sn/oauthcallback`

   {{{region}}}替换为您AWS所在的地区（例如，`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 应用程序**并配置以下字段：
   + **基本网址** — Visier Agent MCP 基本网址，由 Amazon Quick 预先填充。
   + **客户端 ID** — 来自 Visier 管理员控制台的 OAuth 客户端 ID。
   + **公共 OAuth 客户端**（可选）— 如果您的 Visier OAuth 客户端配置为公共客户端（无客户端密钥），请选择此选项。
   + **客户端密钥** — 来自 Visier 管理员控制台的 OAuth 客户端密钥。
   + **令牌网址** — OAuth 令牌终端节点，由 Amazon Quick 预先填充。
   + **授权网址** — OAuth 授权终端节点，由 Amazon Quick 预先填充。
   + **重定向 URL** — Pre-filled 使用 Amazon 快速回传网址。

1. 选择**下一步**。

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

1. 在 “**查看**” 页面上，Amazon Quick 会发现 Visier Agent 公开的工具并将其显示在表格中。查看可用操作列表，然后选择 “**下一步**”。

1. 在 “**发布**” 页面上，选择谁可以访问连接器。您可以为组织中的所有人启用访问权限，也可以搜索特定的团队或群组。

1. 选择**发布**。

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

设置连接器后，您可以使用以下操作。Visier Agent 将其人员分析功能作为可调用工具公开。


**Visier Agent 可用操作**  

| 处理建议 | 说明 | 
| --- | --- | 
| 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** 和集成”** 下启用了 Visier 代理功能。确认您在 Amazon Quick 中正确输入了基本网址、令牌网址和授权网址。
+ **无效的客户端凭证**-验证客户端 ID 和客户端密钥是否与 Visier 管理员控制台中的值相匹配。确认您的 Visier OAuth 客户端中的重定向 URI 与 Amazon Quick 回传网址相匹配。
+ **数据访问错误**-验证在您的 Visier 帐户中配置的数据访问范围是否包含您正在尝试查询的员工数据。请联系您的 Visier 管理员以查看您的账户权限。
+ **未发现任何工具** — 如果 Amazon Quick 在您创建连接器后未发现任何工具，请确认 Visier Agent 处于活动状态并且您的身份验证凭证尚未过期。