docs(aihr): reconcile grounded agent production state

This commit is contained in:
key
2026-08-04 23:09:06 +08:00
parent d3d214efb3
commit 09b1085d9e
7 changed files with 34 additions and 17 deletions
+9 -3
View File
@@ -1,6 +1,8 @@
# Grounded Agent ACTIVE 激活运行手册
状态:代码已实现,生产尚未切换。
状态:代码已实现,生产已于 2026-08-04 受控切换为 `ACTIVE`。
当前生产范围:仅文本 `KNOWLEDGE_QA` 和 `LIVE_MY_WORK` 使用 Grounded Agent;不符合严格计划、授权或证据门禁的请求仍回退既有链路。媒体、资源、外网、写入和训练请求继续走旧链路。认证态用户问答尚未完成逐例验收,本次发布不代表召回率达标。
## 配置契约
@@ -30,10 +32,14 @@ Grounded Agent 只把通过授权和证据门禁的结果适配为现有 `AgentR
1. 工作树干净后运行只读 `scripts/release-backend.sh plan`。
2. 仅使用计划输出的完整 `DEPLOY_BACKEND:<hash>` 授权串执行发布,不手工覆盖 JAR。
3. 发布后先保持 `OFF` 做服务、JAR、schema 和认证请求预检。
4. 通过内部账号验证后,再由受控 systemd drop-in 设置 `AIHR_AGENT_GROUNDED_MODE=ACTIVE` 并重启服务。
3. 发布后先核对服务、JAR、schema 和公开接口预检;生产默认仍以仓库配置的 `OFF` 构建。
4. 通过内部账号和受控预检后,才可由 systemd 配置设置 `AIHR_AGENT_GROUNDED_MODE=ACTIVE` 并重启服务。
5. 任一异常将环境变量改回 `OFF`,按同一配置路径重启;不需要回滚数据库结构。
本次已执行的生产事实:后端 JAR SHA-256 为 `74d0cd2acc60ebf52f20eb8bee643f59395ba7cff3583076d671e57406f824ac`,`wygj-aihr.service` 为 `active`,schema 预检 `83/83`,公开根站、租户列表和移动首页均返回 HTTP 200。配置文件为 `/opt/wygj/config/wygj.env`,配置备份为 `/opt/wygj/backups/wygj.env.grounded-active-20260804225348`,JAR 回滚备份为 `/opt/wygj/backups/backend-20260804224941-e9ecc467524d`。
尚未完成:认证态用户逐例问答、客户端各状态 UI 的完整验收,以及 100–300 条人工标注黄金集评测。没有这些证据,不宣称生产召回率达标,也不把当前 ACTIVE 视为完整客户端灰度。
审计只能记录 query hash、run ID、结构化状态、工具/证据计数、差异和耗时,不得写入原问题、答案、手机号、token、附件或工具正文。
没有 100-300 条人工标注黄金集前,不宣称正式召回率达标。