View a markdown version of this page

访客代理集成 - Amazon Quick
开始前的准备工作配置访客在 Amazon Quick 中设置连接器可用操作管理和故障排除
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

访客代理集成

使用 Visier Agent 操作连接器，您可以通过自然语言直接在 Amazon Quick 中访问 Visier 的人物分析平台。您无需离开 Amazon Quick 即可查询实时劳动力数据、分析员工人数趋势、评估留存状况、生成员工简报等。

Visier Agent 使用自定义 OAuth 应用程序身份验证。有关 Amazon Quick 支持的身份验证方法的更多信息，请参阅身份验证方法。

开始前的准备工作

在设置集成之前，请确保您具备以下条件。

  • 具有 API 访问权限并启用 Visier 代理的活跃访客账户。有关启用 Visier 代理和配置身份验证的信息，请参阅 Visier MCP 服务器文档。

  • 在您的 Visier 帐户中为要查询的员工数据配置相应的数据访问范围。

  • 来自 Visier 管理员的 OAuth 凭据（客户端 ID 和客户端密钥）。

  • 有关 Amazon Quick 订阅要求，请参阅在控制台中设置集成。

配置访客

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

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

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

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

    {region}替换为您Amazon所在的地区（例如，us-east-1）。

  4. 记录客户端 ID 和客户机密钥。在配置 Amazon Quick 时，您需要它们。

  5. 确认您的账户可以访问您要查询的员工数据和分析。

在 Amazon Quick 中设置连接器

  1. 在 Amazon Quick 控制台中，选择连接器。

  2. 选择 “为你的团队创建” 选项卡。

  3. 找到并选择 Visier Agent。

  4. 输入连接器的名称。（可选）选择 + 添加描述以添加描述。

  5. 在 “连接类型” 中，选择 “公共网络”。

  6. 对于 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 快速回传网址。

  7. 选择下一步。

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

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

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

  11. 选择发布。

可用操作

设置连接器后，您可以使用以下操作。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 返回显示给定分析对象如何与其他对象连接的参考图。

管理和故障排除

要编辑、共享或删除您的连接器，请参阅管理现有集成。

身份验证问题

  • MCP 服务器连接失败 — 确认您已在 Visier 管理员控制台的 “设置”、“API 和集成” 下启用了 Visier 代理功能。确认您在 Amazon Quick 中正确输入了基本网址、令牌网址和授权网址。

  • 无效的客户端凭证-验证客户端 ID 和客户端密钥是否与 Visier 管理员控制台中的值相匹配。确认您的 Visier OAuth 客户端中的重定向 URI 与 Amazon Quick 回传网址相匹配。

  • 数据访问错误-验证在您的 Visier 帐户中配置的数据访问范围是否包含您正在尝试查询的员工数据。请联系您的 Visier 管理员以查看您的账户权限。

  • 未发现任何工具 — 如果 Amazon Quick 在您创建连接器后未发现任何工具，请确认 Visier Agent 处于活动状态并且您的身份验证凭证尚未过期。