---
name: trial-reply-matching
description: 当业务后端或 Agent 需要查找 2-1 试听课的历史老师话术时使用，返回脱敏案例及来源引用。不用于查询当期排课、个人权益或正式政策，也不用于发送消息。
compatibility: 需要能发起 HTTPS 请求的服务端或授权工具，以及拥有 rag:2-1:search 权限的服务 Token。
---

# 2-1 相似话术检索

## 调用

1. 在调用方核验请求者的历史案例访问权限。提取本轮问题或话术，去除与匹配无关的个人信息。
2. 公司环境的检索地址为 `POST https://ai.tongchongpet.cn/api/ai/v1/knowledge/2-1/search`。在服务端配置中保存中台地址，设置 `Content-Type: application/json`，由服务端密钥配置注入 `Authorization: Bearer <服务 Token>`。浏览器和 Agent 上下文只接触业务入参和已授权的结果。
3. 发送包含 `question` 和可选 `topK` 的 JSON。`question` 去除首尾空白后长 1–4,000 字符，`topK` 为 1–10 的整数，默认 5。

```json
{
  "question": "三天试听课的直播入口一般什么时候发？",
  "topK": 5
}
```

## 使用结果

- HTTP 200 返回 `requestId`、`knowledgeVersion`、`retrievalVersion` 和 `results`。按 `rank` 展示脱敏 `excerpt`，为每条保留完整 `sourceRef`（`knowledgeVersion`、`caseId`、`fragmentId`）。完整会话由有原会话权限的应用另行查询。
- `results: []` 时报告暂无匹配的历史案例。候选话术作为历史参考，具体课程时间、权益或政策由对应业务服务核实。
- 遇到 `401` 或 `403` 时检查服务凭据和权限。参数错误时按返回说明修正。遇到服务错误时报告检索暂不可用，保留响应头 `X-Request-Id` 供排查。