# 自用通用 Agent 系统配置示例 # 复制为 config.yml 后按需修改;容器内通过 AGENT_CONFIG 指定路径。 # 模型池:平台(platforms) → models + keys 两层结构。url/type/models 配在平台层(同一份 models # 被该平台下所有 key 共用),api_key/concurrency 配在 keys 里(每个 key 独立账号/额度)。 # 加载时自动打平:每个 key 复制一份该平台下所有 models,生成全局 cfg.models 列表。 # 暂按每模型 1 会话调度;concurrency 已解析入库,多会话并发后续再接调度。 platforms: - name: proxy-a # 平台名;留空取 url 主机名首段。注意:它是模型唯一键的一部分,改名等于重建其下所有模型(历史会话回绑失效、用量统计分家) url: "https://proxy-a.example.com/v1" # OpenAI 兼容 /v1 地址,该平台下所有模型共用 type: openai # 选填,缺省取 name;余额查询按 type 找适配器(已接 deepseek/bigmodel),未命中返回「暂未接入」 models: # 该平台下所有模型(与 url/type 同级);多 key 共用 - id: ds1 # 上游模型名;只需同平台内唯一(不同平台可同名),内部唯一键 = 平台名/模型id,历史会话按它绑定,页面不可改 display_name: "AMD DeepSeek 1" # 显示名,缺省同 id # vision: true # 选填,默认 false;支持时 read_file 读图会压缩回传(长边≤2000px JPEG),会话上下文会告知 AI # enable: false # 选填,默认 true;禁用后不进模型池,不参与分配/绑定(重启生效) # extra_params: # 选填:每次发往上游都会合并进 body 顶层的对象;同 key 覆盖默认(model/messages/stream/temperature/tools) # top_p: 0.9 # response_format: { type: "json_object" } # thinking_params: # 选填:仅「深度思考」开启时合并进 body(优先级高于 extra_params) # thinking: { type: "enabled", budget_tokens: 4096 } - id: ds2 display_name: "AMD DeepSeek 2" - id: ds3 # display_name 缺省 = id keys: - api_key: "sk-..." # 各 Key 独立(同平台不同账号/额度),留空则不带鉴权头 concurrency: 1 # 该 Key 并发会话数,默认 1(当前仅记录,未参与调度) - api_key: "sk-..." # 同平台的第二个 Key,自动可用上面所有 models - name: proxy-c url: "https://proxy-c.example.com/v1" # type 缺省取 name(=proxy-c),未命中适配器时余额查询会返回「暂未接入」 models: - id: ds4 display_name: "No Auth Model" keys: - api_key: "" - name: bigmodel # 智谱 bigmodel:起名 bigmodel 可省略 type,自动命中 bigmodel 适配器 url: "https://open.bigmodel.cn/api/paas/v4" models: - id: glm-4.6 keys: - api_key: "your-key" workspace_root: "./data/tasks" # 数据根目录:db(默认 .agent.db)与启动 prompt dump(prompt.txt)放这里;相对路径按启动目录展开。 # 容器部署建议指到挂载卷内(如 /workspace/data),否则重建容器会丢数据。 data_root: "./data" # db_path: "/workspace/data/.agent.db" # 显式配置优先;缺省为 data_root/.agent.db # agent-executor(独立命令执行容器,见根目录 executor/):url 非空时 terminal 工具与技能命令 # 都发到该服务执行(SSE 实时回传),core 镜像不再携带 python 等重工具链; # 留空则本地 spawn(裸机开发)。两侧需同路径挂载 ./tasks、./skills; # compose 已用环境变量 EXECUTOR_URL/EXECUTOR_TOKEN 注入,通常无需在这里配。 # executor: # url: "http://agent-executor:9000" # token: "change-me" # 选填;executor 侧配同值才校验 # 日志等级(改后重启生效):debug < info < warn < error < none,只输出 ≥ 该等级的日志;none=全部静默。 # info(默认)=关键动作概述;debug 另加用户/AI 消息全文、工具调用参数/结果等排查细节。 log_level: info terminal: default_timeout_ms: 30000 max_output_chars: 10000 # Skill Manager:技能根目录,所有任务/会话共享(容器内挂 ./skills → /workspace/skills)。 # skills_root 缺省取 workspace_root 的同级 skills 目录(如 /workspace/tasks → /workspace/skills);可显式覆盖。 skills: skills_root: "/workspace/skills" timeout_ms: 120000 # 单个技能执行超时,默认 120 秒 agent: temperature: 1.0 max_tool_iterations: 20 max_retries: 2 # 回复语言:注入到 system prompt 末尾,强制模型用该语言回复用户 # (工具名/代码/命令保持原样);留空则不限制。改后重启生效。 language: "中文" # 大图上传预处理:图片超过 threshold_kb(默认 1.5M)时,浏览器端询问是否压缩; # 同意后在用户本地 canvas 压缩(长边 ≤ image_max_dim,JPEG image_quality)再上传。 upload: image_compress_threshold_kb: 1536 image_max_dim: 2000 image_quality: 0.85 # 模型保持占用(held)租约:AI 答完后不立即释放模型,用户追问可直接复用。 # 页面无人观看超过 idle_release_ms 释放;有人观看最长保持 active_max_ms;sweep_ms 巡检间隔。 # 新建后从未发言的空闲会话也按同一租约自动释放。 model_hold: idle_release_ms: 180000 # 3 分钟 active_max_ms: 1800000 # 30 分钟 sweep_ms: 10000 # 10 秒 # 上下文压缩:顶栏「压缩」按钮触发。压缩指令不作为 user 消息插入会话: # 压缩回合只发一条 system(模板里 {{conversation}} 占位符自动替换为完整历史)+ 一句触发语,且该回合不传 tools。 # 提示词固定在 server/templates/compress-prompt.txt,需要调整压缩策略时直接改该文件。 # 登录认证(推荐启用):多用户,用户名/明文密码直接配在这里(自用场景)。 # 登录页 /login,会话 token 以 HttpOnly cookie 下发(替代 nginx htpasswd: # 手机浏览器原生下载不带 Basic 认证头,cookie 则会自动携带,下载不再失败)。 # 仍兼容 Authorization: Basic 头(curl/API 脚本可用)。 # secret:签名密钥;留空则启动时随机生成(重启后需重新登录),建议固定随机串。 # 登录页支持用 localStorage 里的 token 静默恢复登录态(POST /api/login_restore), # 兼容 Android WebView 封装 APK 杀进程后 cookie 未落盘的场景。 # 整段删除或 users 留空则不启用认证。 # auth: # secret: "change-me" # 选填;建议固定,避免重启掉登录态 # ttl_ms: 2592000000 # 选填,登录态有效期,默认 30 天 # users: # - user: admin # password: "change-me" # - user: alice # password: "s3cret" # MCP 服务(可配多个;与内置工具分开)。启动时对每个服务调 tools/list 发现工具, # 追加到内置工具之后一起发给模型;调用经 tools/call 转发。headers 是任意请求头(如 Authorization)。 # enable 选填、默认 true;设为 false 时启动不加载该服务的工具(配置保留,改回 true 重启即恢复)。 # 服务不可用时只在启动日志告警,不影响其他服务与内置工具。 mcp_servers: - name: web-search # 选填,缺省取主机名首段 url: "https://web-search.ai.foresh.com/" enable: true # 选填,默认 true;false 时启动不加载 headers: Authorization: "Basic a2ljZXI6USF3MmUzcjQ="