Zendesk
索引内容
每个 Zendesk 连接器只索引一种内容类型：articles 或 tickets。如果两种类型都需要，请创建两个连接器。管理表单不提供组织、品牌、类别、分区、工单视图或标签范围，因此会读取凭据在该账号内可见的所选内容类型。
前置条件
- 从
https://<ZENDESK_SUBDOMAIN>.zendesk.com确认 Zendesk 账号子域。 - 启用 token 访问，并为获准的 Zendesk 用户创建 API token。
- 允许连接器 worker 通过 HTTPS 访问该账号的 Zendesk API。
- 授予 Help Center 文章与 Guide content tag 的访问权限。当前连接器会验证文章端点，并在任一内容模式运行前加载 content tag。
- 对于 tickets，需保持 Zendesk Support 已启用，并授予 incremental ticket export 与工单评论访问权限。用户端点访问只是可选的作者元数据增强：没有该权限时，提交者与评论作者详情可能缺失，但工单和评论文本仍可索引。
凭据
在 Zendesk 子域中输入账号的租户名称，而不是通用 API Base URL。连接器可以接收以 https:// 开头的值并移除 .zendesk.com 后缀，但使用裸子域可以避免路径或协议歧义。
Zendesk 用户端点访问是可选的作者元数据增强。如果作者查询返回 HTTP 错误，OpenCore 会省略对应提交者或评论作者元数据，并继续构建文章或工单文档。
在 OpenCore 中配置
- 在管理后台打开连接器，选择 Zendesk，并创建包含子域、邮箱与 token 的凭据。
- 在内容类型中选择 articles 或 tickets。单个连接器不能同时索引两种模式。
- 可以设置每分钟 API 调用次数。这是连接器本地上限，会应用于该连接器的文章、工单、评论、用户与 content-tag 请求。
- 对受限支持内容选择私有并分配 OpenCore 群组。仅当每个 OpenCore 账号都可以搜索全部已索引文章或工单时才使用公开。
- 设置刷新与清理选项，创建连接器并运行首次索引。
- 如需同时索引文章与工单，请使用另一内容类型重复以上步骤，创建第二个连接器。
权限
Zendesk 凭据控制连接器可以摄取哪些内容，但 Zendesk 的文章、工单、组织、品牌、角色与终端用户限制不会同步到 OpenCore。连接器的轻量文档路径只返回 ID 与创建日期，不包含源访问记录。
索引后，搜索访问由连接器的 OpenCore 私有群组或公开模式决定。能够访问该连接器的任意用户都可以搜索每个成功索引的文档，即使该用户无法在 Zendesk 中打开对应文章或工单。应尽可能通过范围更窄的 Zendesk 凭据拆分敏感内容，并使用独立的 OpenCore 连接器与群组。
验证
- 验证凭据，并确认其可以调用 Help Center 文章端点。
- 运行一次索引。对于 articles，搜索一篇已发布且非草稿文章的文本；对于 tickets，搜索一个工单主题与一条返回的评论正文。
- 确认草稿文章或已删除工单不存在。
- 确认只有附件中存在的文本无法搜索。
- 使用已获 Zendesk 授权的浏览器会话打开结果链接，确认其指向预期租户及文章或 agent 工单。
- 使用每个已分配的 OpenCore 群组测试搜索访问，因为查询时不会重新检查 Zendesk 权限。