Files
agent/app/config.example.yml
T

129 lines
7.5 KiB
YAML
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 系统配置示例
# 复制为 config.yml 后按需修改;容器内通过 AGENT_CONFIG 指定路径。
# 模型池:平台(platforms) → Key → 模型 三层层级。url/type 配在平台,api_key/concurrency 配在 Key,
# 模型只声明 {id, display_name, vision, enable}。加载时自动打平成全局模型列表。
# 暂按每模型 1 会话调度;concurrency 已解析入库,多会话并发后续再接调度。
platforms:
- name: proxy-a # 平台名;留空取 url 主机名首段。注意:它是模型唯一键的一部分,改名等于重建其下所有模型(历史会话回绑失效、用量统计分家)
url: "https://proxy-a.example.com/v1" # OpenAI 兼容 /v1 地址,该平台下所有模型共用
type: openai # openai/deepseek/custom,决定余额查询适配器(预留)
keys:
- api_key: "sk-..." # 各 Key 独立(同平台不同账号/额度),留空则不带鉴权头
concurrency: 1 # 该 Key 并发会话数,默认 1(当前仅记录,未参与调度)
models:
- 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"
- api_key: "sk-..." # 同平台的第二个 Key
models:
- id: ds3
display_name: "AMD DeepSeek 3"
- name: proxy-c
url: "https://proxy-c.example.com/v1"
type: custom
keys:
- api_key: ""
models:
- id: ds4
display_name: "No Auth Model"
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 秒
# 上下文压缩:顶栏「压缩」按钮触发时把这段 prompt 作为 user 消息发给 AI,
# 要求它回顾整段对话并生成结构化总结;收到回复后由前端弹窗询问是否物理清空历史,
# 仅保留这条总结作为后续对话的唯一上下文,省 token。可按需改写 prompt(中文/英文均可)。
compress:
prompt: |
请基于以上全部对话历史,生成一段结构化总结,作为之后继续对话的唯一上下文。要求:
1) 提炼关键事实、决定、约束、待办;
2) 保留用户的偏好与命名约定;
3) 忽略寒暄与已完成的工具调用细节;
4) 中文输出,简洁。
直接输出总结正文即可,不要加前言/标题/列表前缀。
# 登录认证(推荐启用):多用户,用户名/明文密码直接配在这里(自用场景)。
# 登录页 /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="