feat(agents): 新增「智能体」功能模块(路线 A)+ 版本 2.5.0

老板要求「在 ai 网关里做智能体 agent,新的一个菜单」,一期仅管理员、成熟后下发。
完整设计(27 条决策,4 轮评审)见 docs/agents-dev-plan.md。

架构(路线 A):界面与权限在网关,执行在 QwenPaw(独立 profile ai-gateway)。
网关当门面(鉴权/计量/灰度/审计),引擎提供工具能力(文件/命令/浏览器)。

Step -1 技术验证(实测,全部改变或确认了设计):
- 请求级指定模型【无效】:传 model 被忽略,turn_usage 回 provider_id=opencode、
  model_name=deepseek-v4.1-flash;AgentRequest 无 model 字段。模型是 profile 级。
  → 甲案:所有智能体共用 ai-gateway 一个 profile ⇒ 共用同一模型,配置页模型栏只读。
- role:"system"【被接受且生效】:塞入「只用英文回答」后模型真的用英文
  → params.system_suffix 走注入 system 消息。
- SSE 事件谱已录制 → tests/fixtures/sse-tool-flow.sse + docs/qwenpaw-agent-api-sse.md

后端:
- app/agents.py:AgentStore(data/agents.yaml,600/原子写/mtime 热载)+ 严格校验
  (slug 三重查重:模型 id/别名/QwenPaw profile;params 4 键白名单;suffix 限长 2000;
   max_agents=5 软上限,归档不计入;restore 可恢复)
- app/adapters/qwenpaw_engine.py:OpenAI 形状 ↔ AgentScope Agent API + SSE 翻译器
  (text 累积、delta:false 快照忽略、plugin_call→轨迹、call_id 配对 output、turn_usage→计量)
- app/agents_routes.py:GET/POST/PUT/DELETE /agents、/restore、/chat(SSE)、/stop、
  /runs、/sessions、/test + 新增 GET /auth/me(灰度通道,features.agents 后端权威);
  权限唯一入口 can_use_agent();防自指(引擎模型不得指向 agent/*)
- app/history.py:会话类别扩展支持 agent_<slug>(复用现有存储)
- data/agents.yaml(配置,入库);data/agent_runs.json(运行时,gitignore)

前端:
- views/Agents.vue(列表 + 对话/配置/运行记录)+ lib/agents.ts(SSE 解析)
- 菜单核心组第 5 位 + 图标 bot;router meta.admin 双层守卫;i18n 中英对称 871/871

上线实测:真实对话跑通 —— 让智能体 read_file 读 /etc/hostname,前端正确显示
「执行了 1 步」+ 工具参数、正文、计量(wjd · 47196 tokens · 缓存 13696)、终态;
引擎调用经 wangjinding 过网关(计量闭环)。

测试 209 → 217 全过(新增 8 条,含用真实夹具验证 SSE 翻译器);ci_check 全绿。
This commit is contained in:
api-gateway committed 2026-09-29 13:22:12 +08:00
1 parent bccb72bad5
commit 51c9af59c4
19 files changed
+3064 -26

No files matched your search

+114
View File
@@ -0,0 +1,114 @@
data: {"id":"response_f5a2f704a9864e86839393e63d6e8cbc","output":[],"status":"created","created_at":"2026-09-29T04:17:20+00:00","completed_at":null,"metadata":null,"object":"response","session_id":"probe-tool-flow","sequence_number":1}
data: {"id":"response_f5a2f704a9864e86839393e63d6e8cbc","output":[],"status":"in_progress","created_at":"2026-09-29T04:17:20+00:00","completed_at":null,"metadata":null,"object":"response","session_id":"probe-tool-flow","sequence_number":2}
data: {"id":"msg_c9b1cc9ebc644ff4a26a1a88eeb4213e","type":"message","role":"assistant","content":[],"status":"in_progress","metadata":null,"name":"assistant","object":"message","sequence_number":3}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_c9b1cc9ebc644ff4a26a1a88eeb4213e", "text": "I", "sequence_number": 4}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_c9b1cc9ebc644ff4a26a1a88eeb4213e", "text": "'ll read that", "sequence_number": 5}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_c9b1cc9ebc644ff4a26a1a88eeb4213e", "text": " file for", "sequence_number": 6}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_c9b1cc9ebc644ff4a26a1a88eeb4213e", "text": " you.\n\n", "sequence_number": 7}
data: {"type":"text","delta":false,"index":0,"status":null,"object":"content","msg_id":"msg_c9b1cc9ebc644ff4a26a1a88eeb4213e","text":"I'll read that file for you.\n\n","sequence_number":8}
data: {"id":"msg_c9b1cc9ebc644ff4a26a1a88eeb4213e","type":"message","role":"assistant","content":[{"type":"text","delta":false,"index":0,"status":null,"object":"content","msg_id":null,"text":"I'll read that file for you.\n\n"}],"status":"completed","metadata":null,"name":"assistant","object":"message","sequence_number":9}
data: {"id":"msg_72e987ec0cb5460581b85c365b86182f","type":"plugin_call","role":"assistant","content":[],"status":"in_progress","metadata":null,"name":"assistant","object":"message","sequence_number":10}
data: {"type": "data", "delta": true, "index": 0, "status": "in_progress", "object": "content", "msg_id": "msg_72e987ec0cb5460581b85c365b86182f", "data": {"call_id": "chatcmpl-tool-b207f3da7699c9fa", "name": "read_file", "arguments": ""}, "sequence_number": 11}
data: {"type": "data", "delta": true, "index": 0, "status": "in_progress", "object": "content", "msg_id": "msg_72e987ec0cb5460581b85c365b86182f", "data": {"arguments": ""}, "sequence_number": 12}
data: {"type": "data", "delta": true, "index": 0, "status": "in_progress", "object": "content", "msg_id": "msg_72e987ec0cb5460581b85c365b86182f", "data": {"arguments": ""}, "sequence_number": 13}
data: {"type": "data", "delta": true, "index": 0, "status": "in_progress", "object": "content", "msg_id": "msg_72e987ec0cb5460581b85c365b86182f", "data": {"arguments": ""}, "sequence_number": 14}
data: {"type": "data", "delta": true, "index": 0, "status": "in_progress", "object": "content", "msg_id": "msg_72e987ec0cb5460581b85c365b86182f", "data": {"arguments": "{\"file_path\": \"/tmp/probe-agent.txt\"}"}, "sequence_number": 15}
data: {"type":"data","delta":false,"index":null,"status":"completed","object":"content","msg_id":null,"data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","arguments":"{\"file_path\": \"/tmp/probe-agent.txt\"}"},"sequence_number":16}
data: {"id":"msg_72e987ec0cb5460581b85c365b86182f","type":"plugin_call","role":"assistant","content":[{"type":"data","delta":false,"index":null,"status":"completed","object":"content","msg_id":null,"data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","arguments":"{\"file_path\": \"/tmp/probe-agent.txt\"}"},"sequence_number":16}],"status":"completed","metadata":null,"name":"assistant","object":"message","sequence_number":17}
data: {"id":"msg_fcd7df26a1d04ea4adb2b318b82be07e","type":"plugin_call_output","role":"tool","content":[],"status":"in_progress","metadata":null,"name":"assistant","object":"message","sequence_number":18}
data: {"type":"data","delta":false,"index":0,"status":"in_progress","object":"content","msg_id":"msg_fcd7df26a1d04ea4adb2b318b82be07e","data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","output":""},"sequence_number":19}
data: {"type":"data","delta":false,"index":0,"status":"in_progress","object":"content","msg_id":"msg_fcd7df26a1d04ea4adb2b318b82be07e","data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","output":"Error: The file /tmp/probe-agent.txt does not exist."},"sequence_number":20}
data: {"type":"data","delta":false,"index":0,"status":"completed","object":"content","msg_id":null,"data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","output":"Error: The file /tmp/probe-agent.txt does not exist.","state":"error"},"sequence_number":21}
data: {"id":"msg_fcd7df26a1d04ea4adb2b318b82be07e","type":"plugin_call_output","role":"tool","content":[{"type":"data","delta":false,"index":0,"status":"completed","object":"content","msg_id":null,"data":{"call_id":"chatcmpl-tool-b207f3da7699c9fa","name":"read_file","output":"Error: The file /tmp/probe-agent.txt does not exist.","state":"error"},"sequence_number":21}],"status":"completed","metadata":null,"name":"assistant","object":"message","sequence_number":22}
data: {"id":"msg_d4642dbdee5d453493a61c3a167ca2f6","type":"message","role":"assistant","content":[],"status":"in_progress","metadata":null,"name":"assistant","object":"message","sequence_number":23}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "文件", "sequence_number": 24}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "不存在,读不到内容", "sequence_number": 25}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "。", "sequence_number": 26}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "😕\n\n`/tmp/pro", "sequence_number": 27}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "be-agent.txt` 没有", "sequence_number": 28}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "找到", "sequence_number": 29}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": " —— 可能是", "sequence_number": 30}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "路径写", "sequence_number": 31}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "错了,或者文件", "sequence_number": 32}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "还没", "sequence_number": 33}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "创建/已经被", "sequence_number": 34}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "清掉了", "sequence_number": 35}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "。", "sequence_number": 36}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "要我", "sequence_number": 37}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "看看", "sequence_number": 38}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": " `/tmp` 下", "sequence_number": 39}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "有什么别的", "sequence_number": 40}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "文件吗?\n\n", "sequence_number": 41}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 42}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 43}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 44}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 45}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 46}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 47}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 48}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 49}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 50}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 51}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 52}
data: {"type": "text", "delta": true, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "", "sequence_number": 53}
data: {"type": "text", "delta": false, "index": 0, "status": null, "object": "content", "msg_id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "text": "文件不存在,读不到内容。😕\n\n`/tmp/probe-agent.txt` 没有找到 —— 可能是路径写错了,或者文件还没创建/已经被清掉了。要我看看 `/tmp` 下有什么别的文件吗?", "sequence_number": 54}
data: {"id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "type": "message", "role": "assistant", "content": [{"type": "text", "delta": false, "index": 0, "status": null, "object": "content", "msg_id": null, "text": "文件不存在,读不到内容。😕\n\n`/tmp/probe-agent.txt` 没有找到 —— 可能是路径写错了,或者文件还没创建/已经被清掉了。要我看看 `/tmp` 下有什么别的文件吗?"}], "status": "completed", "metadata": null, "name": "assistant", "object": "message", "sequence_number": 55, "usage": {"input_tokens": 13864, "output_tokens": 90}}
data: {"id": "response_f5a2f704a9864e86839393e63d6e8cbc", "output": [{"id": "msg_c9b1cc9ebc644ff4a26a1a88eeb4213e", "type": "message", "role": "assistant", "content": [{"type": "text", "delta": false, "index": 0, "status": null, "object": "content", "msg_id": null, "text": "I'll read that file for you.\n\n"}], "status": "completed", "metadata": null, "name": "assistant", "object": "message", "sequence_number": 9}, {"id": "msg_72e987ec0cb5460581b85c365b86182f", "type": "plugin_call", "role": "assistant", "content": [{"type": "data", "delta": false, "index": null, "status": "completed", "object": "content", "msg_id": null, "data": {"call_id": "chatcmpl-tool-b207f3da7699c9fa", "name": "read_file", "arguments": "{\"file_path\": \"/tmp/probe-agent.txt\"}"}, "sequence_number": 16}], "status": "completed", "metadata": null, "name": "assistant", "object": "message", "sequence_number": 17}, {"id": "msg_fcd7df26a1d04ea4adb2b318b82be07e", "type": "plugin_call_output", "role": "tool", "content": [{"type": "data", "delta": false, "index": 0, "status": "completed", "object": "content", "msg_id": null, "data": {"call_id": "chatcmpl-tool-b207f3da7699c9fa", "name": "read_file", "output": "Error: The file /tmp/probe-agent.txt does not exist.", "state": "error"}, "sequence_number": 21}], "status": "completed", "metadata": null, "name": "assistant", "object": "message", "sequence_number": 22}, {"id": "msg_d4642dbdee5d453493a61c3a167ca2f6", "type": "message", "role": "assistant", "content": [{"type": "text", "delta": false, "index": 0, "status": null, "object": "content", "msg_id": null, "text": "文件不存在,读不到内容。😕\n\n`/tmp/probe-agent.txt` 没有找到 —— 可能是路径写错了,或者文件还没创建/已经被清掉了。要我看看 `/tmp` 下有什么别的文件吗?"}], "status": "completed", "metadata": null, "name": "assistant", "object": "message", "sequence_number": 55, "usage": {"input_tokens": 13864, "output_tokens": 90}}], "status": "completed", "created_at": "2026-09-29T04:17:20+00:00", "completed_at": "2026-09-29T04:17:23+00:00", "metadata": null, "object": "response", "session_id": "probe-tool-flow", "sequence_number": 56, "usage": {"input_tokens": 13864, "output_tokens": 90}}
data: {"type": "turn_usage", "session_id": "probe-tool-flow", "usage": {"provider_id": "opencode", "model_name": "deepseek-v4.1-flash", "prompt_tokens": 27653, "completion_tokens": 141, "total_tokens": 27794, "cache_read_tokens": 17152, "cache_write_tokens": 0, "cache_eligible_input_tokens": 27653, "cache_observed": true, "cache_hit_rate": 62.02581998336528, "context_size": 1000000, "compact_threshold": 0.8, "session_cache_read_tokens": 17152, "session_cache_eligible_input_tokens": 27653, "session_cache_observed": true, "session_cache_hit_rate": 62.02581998336528}, "context_usage": {"estimated_tokens": 149, "max_input_length": 1000000, "context_usage_ratio": 0.014899999999999998}}