Gong
索引内容
Gong 连接器会为每份通话转录创建一个可搜索文档。它会把转录数据与 Gong extensive-call 端点返回的通话详情组合起来。
当前管理表单未暴露连接器内部的说话人匿名化选项。规划访问时，应把 API 返回的参与方姓名与邮箱视为已索引内容。
前置条件
- 为专用集成用户创建 Gong API access key 与 access-key secret。
- 授予列举工作区、读取通话转录，以及读取包含 parties 的 extensive call details 的权限。
- 确定账号使用默认美国 API 主机还是区域专用 Gong API 主机。
- 如需限制范围，请收集每个准确的工作区 ID 或区分大小写的准确工作区名称。
- 连接器 worker 只需通过 HTTPS 访问所选 Gong API 主机；它会保存 Gong 返回的引用 URL，但不会打开该 URL。
- 最终用户浏览器必须能访问 Gong 返回的引用 URL 所在主机，才能打开源通话。
- 确定部署级
GONG_CONNECTOR_START_TIME是否应该限制历史摄取，并考虑连接器向前重叠一天的行为。
凭据
对于非美国数据驻留，请输入 Gong 为该账号提供的区域专用 HTTPS 主机。OpenCore 接受 api.gong.io 或以 .api.gong.io 结尾的子域，在省略时补上 https://，并拒绝 HTTP 或非 Gong 主机。
在 OpenCore 中配置
- 在管理后台打开连接器，选择 Gong，并创建 access-key 凭据。仅在账号要求时设置可选区域 Base URL。
- 在工作区中输入零个或多个准确工作区名称或 ID。仅在已批准凭据可见的全部工作区时才留空。
- 配置多个条目时，OpenCore 会保留所有能解析的条目。无效条目会被记录并跳过；如果一个都无法解析，索引会失败，而不会扩大到全部工作区。
- 对受限通话内容选择私有并分配 OpenCore 群组。仅当每个 OpenCore 账号都可以搜索范围内全部转录与参与方标识时才使用公开。
- 设置刷新与清理选项，创建连接器并运行首次索引。
首次 checkpoint 调用会解析工作区 ID 并缓存一个时间范围，然后在不获取转录页的情况下返回。后续调用每次处理一个工作区的一页数据。
权限
Gong key pair 控制 OpenCore 可以摄取哪些工作区、通话、转录、详情与参与方。Gong 工作区成员关系、call library 访问、团队权限与单通话访问不会同步到 OpenCore；该连接器没有源 ACL 或查询时 Gong 访问检查。
索引后，搜索访问由连接器的 OpenCore 私有群组或公开模式控制。任何能访问连接器的用户都可以搜索完整的已索引转录与返回的参与方标识，即使该用户无法在 Gong 中打开对应通话。应使用最小权限 Gong 集成用户、明确工作区范围，并为不得共享通话的受众使用独立连接器与 OpenCore 群组。
验证
- 运行连接器，并确认已配置工作区名称或 ID 解析为预期工作区 ID。
- 持续执行 checkpoint 调用直到运行完成，然后为每个已配置工作区搜索一个通话标题和一句独特转录文本。
- 确认未配置工作区中的通话不存在。工作区列表为空时，确认全工作区范围确实符合预期。
- 检查一个结果中的通话 purpose、说话人标识、通话开始时间与 Gong 引用 URL。
- 根据
GONG_CONNECTOR_START_TIME与向前一天重叠核对最早索引通话；不要把该部署值视为严格的禁止摄取边界。 - 测试每个已分配的 OpenCore 群组，因为搜索时不会重新检查 Gong 权限。