Files
agent/app/README.md
T
kicer 9deebe8883 MCP 服务支持配置单次工具调用超时(mcp_servers[].timeout_ms)
原来 tools/call 的 60s 写死在 mcp.js,对搜索和图/视频生成这类耗时差一个数量级的服务没法兼顾。现按服务配置:config.js 归一化缺省 60s、夹在 1s~10min(YAML 写成字符串也吃,非法值回落缺省),callTool 取 server.timeout_ms。

只管 tools/call:initialize 与 tools/list 仍是固定 15s(协议往返,与服务快慢无关,放大了只会拖慢启动)。上限 10min 的理由是一次工具调用独占一个模型槽位,不允许无限等。

另:rpc() 把超时错误从原生的 This operation was aborted 改为带配置毫秒数与 method 的信息——超时既然可配了,排查时得看得出当时生效的是多少。

文档跟进:config.example.yml 示例与说明、app/README 服务字段清单、ARCHITECTURE 第 9 节与 11.3 扩展点。前端 MCP 编辑页暂未加该字段(改已有服务走逐字段 setIn,手写的 timeout_ms 不会被覆掉)。
2026-09-17 22:00:21 +08:00

61 lines
2.9 KiB
Markdown
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.
# Agent 任务台(app)
按仓库根目录 `README.md` 设计方案实现的自用通用 Agent 系统。
## 目录结构
```
app/
├── server/
│ ├── server.js # 入口:装配配置/DB/总线/路由/静态资源
│ ├── config.js # config.yml 加载与校验
│ ├── db.js # SQLite(better-sqlite3,WAL)
│ ├── engine.js # 会话管理 + 模型池 FIFO 调度 + Agent 主循环
│ ├── llm.js # OpenAI 兼容上游流式调用(SSE 解析/工具分片合并)
│ ├── mcp.js # MCP 客户端:mcp_servers 工具发现(tools/list)与转发(tools/call)
│ ├── sse.js # 按会话分组的 SSE 事件总线
│ ├── routes/
│ │ ├── sessions.js # 会话 CRUD(10.1)
│ │ ├── messages.js # 消息/SSE/start/stop(10.2)
│ │ └── files.js # 文件上传/列表/下载/删除(10.3)
│ ├── tools/
│ │ ├── definitions.json # 内置 16 个工具的 JSON Schema
│ │ └── executor.js # 内置工具执行器(任务目录沙箱;未知工具名转 MCP)
│ ├── templates/system-prompt.txt # System prompt 模板(直接编辑)
│ └── public/ # H5 前端(Vanilla JS + SSE)
├── test/ # mock 上游 + 端到端冒烟测试
├── config.example.yml
├── Dockerfile / docker-compose.yml
```
## 本地运行
```bash
cd app
npm install
cp config.example.yml config.yml # 修改 models(每个模型独立 url/api_key)
npm start # http://localhost:8090
```
## 测试
```bash
cd app
npm test # 启动 mock 上游 + 真实 server 的端到端冒烟测试(25 项断言)
```
## 提示词与工具 schema
System prompt 完全静态(所有会话共用,利于上游前缀缓存),在 `server/templates/system-prompt.txt` 直接编辑;工具定义在 `server/tools/definitions.json`。改完重启服务。
## 关键行为速查
- 会话创建即尝试绑定空闲模型;无空闲则进全局队列 FIFO。
- 每轮 AI 完成(无工具调)或用户终止后释放模型;新消息重新入队。
- 规划阶段点「开始执行」:追加固定模板消息并切 execution。
- 终止:置位标志 + kill 进程组 + 中止模型流,不再发新请求。
- 所有文件路径解析到任务目录内,拒绝越界。
- MCP 服务在 config.yml 的 `mcp_servers` 配置(可多个,每项 name?/url/headers/enable?/timeout_ms?,enable 默认 true、false 时启动不加载其工具;timeout_ms 为该服务单次工具调用最大等待,默认 60s);启动时发现其工具,追加在内置工具之后与 system prompt 一起发给模型;服务不可用仅启动日志告警,工具名重名时加「服务名__」前缀。
部署见 `../docs/DEPLOY.md`。