View a markdown version of this page

访客代理集成 - Amazon Quick
开始前的准备工作配置访客在 Amazon Quick 中设置连接器可用操作管理和故障排除

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

访客代理集成

使用 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}替换为您AWS所在的地区（例如，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 处于活动状态并且您的身份验证凭证尚未过期。