Files
xiaoyin-gateway/.gitignore
T
api-gateway c0706d1846 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 全绿。
2026-09-29 13:22:12 +08:00

61 lines
2.2 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# ── 缓存 / 构建产物 ──
__pycache__/
*.pyc
*.pyo
.pytest_cache/
.venv/
venv/
*.log
# ── 本地敏感文件 ──
.env
.env.*
!.env.example
# 账号体系数据:密码哈希 + API Key 哈希,属凭证材料,不入库
data/users.json
# 前端历史(提示词/回答正文属隐私)
data/history.json
# 意见反馈(正文 + 图片,属隐私)
data/feedback.json
data/feedback_media/
# 单测运行时会往项目根写这几个临时数据文件(test_gateway.py 用),别入库
.test_users.json
.test_history.json
.test_feedback.json
.test_feedback_media/
.test_sessions.json
.test_video_owners.json
.test_env
# 运行期状态(第三十轮):会话落盘 / 视频归属落盘 —— 都是运行数据,且含账号名与凭证哈希,
# 属"可重新生成、不该进版本库"的一类(重启后从空开始,语义上无害)
data/sessions.json
data/video_owners.json
# 智能体运行记录(第三十八轮):运行时数据(谁在什么时候用了哪个智能体),
# 与 sessions.json 同理 —— 可重新生成、不该进版本库。
# 注意 data/agents.yaml 是**配置**(不含秘密),按计划 ⑯ **要入库**。
data/agent_runs.json
data/agents.yaml.bak
# 配置自动备份(每存一次网关配置就多一对):不该跟着源码走,也不该在仓库里堆历史版本
data/*.bak
# 说明:data/gateway.yaml 不含明文 Key —— 三家供应商密钥统一在 .env(已被上面忽略),
# 由 yaml 各供应商的 token_env 引用。只要 .env 不提交,密钥就不会进版本库。
# ── 设计稿(不入库,历史上从未入库)──────────────────────────────────
# design/v1、v2、v3 是"出设计图"用的脚本 + 渲染出的 PNG(约 11MB)。
# 它们与产品构建、网关运行完全无关,且 2026-09-13 曾被清理归档到
# /root/.trash/<归档>/design/(cp -a 可恢复)。
# 需要时本地恢复即可,不进版本库。
design/
# ── 依赖与构建产物(不入库,均可重新生成:npm ci && npm run build)──
node_modules/
frontend/node_modules/
frontend/dist/
dist/
*.egg-info/
.DS_Store