docs: sync knowledge base after 帮道 rename and summary-card fix
- rename brand docs to 帮道 prefix; reframe 20260721 plan as historical snapshot - compress AGENTS.md rule detail into API_INTEGRATION.md, keep boundaries only - scrub test phone numbers from design-qa, DEV_SETUP, org-sync and rebuild docs - document summary-card evidence binding contract and 20260725 config migrations - pin relative dates in README and audit baseline
This commit is contained in:
@@ -136,7 +136,7 @@ where a.id is null and o.ext1 in ('aihr-knowledge','aihr-knowledge-staging');
|
||||
|
||||
## 6. 查询、日志与限流观察
|
||||
|
||||
知识底层内部入口为 `POST /api/knowledge/query`,移动端“问”的规范入口是 `/api/aihr/agent/**`,仅在 Agent 识别为知识/资源意图后调用该层。知识查询可带 `conversationId/contextVersion` 启用最近 6 轮、30 分钟不活跃过期的短期会话;外部入口 `POST /api/open/knowledge/query` 始终无状态。内部原文件/视频通过 `GET /api/knowledge/resources/{attachmentId}/content` 在下载时重新鉴权。外部请求使用 `Authorization: Bearer <API_TOKEN>`。查询日志只保存问题哈希、有效空间、来源类型、状态、耗时和提示版本,不保存完整问题或令牌。
|
||||
知识底层内部入口为 `POST /api/knowledge/query`,移动端“问”的规范入口是 `/api/aihr/agent/**`,仅在 Agent 识别为知识/资源意图后调用该层。知识查询可带 `conversationId/contextVersion` 启用最新 6 轮、30 分钟不活跃过期的短期会话;外部入口 `POST /api/open/knowledge/query` 始终无状态。内部原文件/视频通过 `GET /api/knowledge/resources/{attachmentId}/content` 在下载时重新鉴权。外部请求使用 `Authorization: Bearer <API_TOKEN>`。查询日志只保存问题哈希、有效空间、来源类型、状态、耗时和提示版本,不保存完整问题或令牌。
|
||||
|
||||
`aihr_knowledge_conversation` 只保存脱敏截断后的短期上下文,过期记录由查询流量每 5 分钟惰性清理最多 500 条。可只读观察积压:
|
||||
|
||||
@@ -155,6 +155,22 @@ order by last_time desc;
|
||||
|
||||
重点观察 `REJECTED`、`FAILED`、`NO_EVIDENCE`、连续 `429` 和异常高耗时。外部应用的限流依赖 Redis;Redis 不可用时外部查询应失败关闭并返回服务不可用,不能绕过限流继续调用。
|
||||
|
||||
### 6.1 总结卡证据绑定与排障
|
||||
|
||||
总结卡必须复用当前知识回答中的 `DOCUMENT` 引用,不接受客户端自行填写或历史回答残留的片段:
|
||||
|
||||
```json
|
||||
{
|
||||
"queryText": "厕所打扫的 SOP 是什么?",
|
||||
"category": "sop",
|
||||
"fragmentIds": [120535]
|
||||
}
|
||||
```
|
||||
|
||||
`fragmentIds` 最多 5 条。`POST /api/knowledge/summary-card` 会按当前租户、应用和主体授权重新校验,只基于仍有权限的片段生成固定「问题/建议/标准」结构,不再执行第二次检索。引用为空、越权、模型不可用或输出结构不合格都应返回明确错误;前端保留当前答案并允许重试,不展示原文伪造的步骤卡。
|
||||
|
||||
若知识回答正常但总结卡失败,先核对请求片段确实来自同一轮响应,再检查启用的 `category='chat'` 模型。DeepSeek 旧模型名或 SOP Prompt 未兼容部分证据时,按[生产迁移 Runbook](BRD_PRODUCTION_MIGRATION_RUNBOOK.md)执行 `aihr_20260725_deepseek_v4_model_mysql8.sql` 与 `aihr_20260725_sop_answer_partial_evidence_prompt_mysql8.sql`,随后通过管理端连接测试和认证态查询—总结卡链路复核;不要在日志或工单中记录密钥、手机号或完整问题正文。
|
||||
|
||||
## 7. 验证与发布闸门
|
||||
|
||||
自动合同测试:
|
||||
|
||||
Reference in New Issue
Block a user