Agent-RPA/praxis.config.example at develop · WW-AI-Lab/Agent-RPA · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
# praxis.config.example · praxisd 配置样例（YAML）
#
# 复制为 praxis.config 后按需修改。定位优先级：
#   --config <path> > $PRAXIS_CONFIG > ./praxis.config > ~/.praxis/praxis.config
# 全部段均可省略；省略时使用下方注释标注的内置默认值。
# 机密只允许以 %vault:<key>% 占位符引用（I-5）：配置校验会拒载明文机密，
# 任何日志 / /statusz 输出只会看到占位符本身。

daemon:
  # 健康/状态端点监听地址。默认仅允许 loopback；
  # 监听非 loopback 地址必须同时设置 allow_remote: true。
  listen: "127.0.0.1:7420"        # 默认 127.0.0.1:7420
  # allow_remote: false           # 默认 false

  # 优雅停止预算：超时未完成则强制退出（非零退出码）。
  shutdown_timeout: "10s"         # 默认 10s

  log:
    format: "text"                # text | json，默认 text
    level: "info"                 # debug | info | warn | error，默认 info

# ── cognition：外部 Agent 驱动（Cognition Port outbound）配置（蓝图 10 §6）──
#
# 整段可完全省略：无任何 Agent/LLM 配置时 praxisd 照常启动（I-6），
# 0 Token 确定性回放/批量不受影响；L2/L3 认知需求经 fallback 升级人工。
cognition:
  # 在场 Agent 发起的 Run 触发认知需求时，优先回给发起的那个 Agent。
  attached_prefer_caller: true    # 默认 true

  # detached（批量/cron/Webhook）模式下自愈类请求
  # （relocate / repair_subflow / validate）的默认驱动。
  default_healer:
    adapter: codex-mcp            # 必须是下方 adapters 中已定义的名称
    model: fable-5                # 子 Agent 模型，默认 fable-5
    budget_tokens_per_step: 4000  # 单步认知请求的 token 预算上限

  # detached 模式下探索类请求
  # （plan / decide_step / assist_crystallize）的默认驱动。
  default_explorer:
    adapter: claude-api
    model: fable-5                # 默认 fable-5
    budget_tokens_per_run: 200000 # 单次探索 Run 的 token 预算上限

  # 命名适配器表：适配器是配置项而非代码依赖。
  # type 合法取值：mcp-server-inbound | mcp-client | openai-compatible | cli
  # 除 type / sandbox 外的字段作为适配器连接参数（只接受标量值）。
  adapters:
    # inbound 对称形态：Agent 经 MCP 主动连入 praxisd（工具面属 M5）。
    cursor-mcp:
      type: mcp-server-inbound

    # 以 MCP client 拉起/连接外部 Agent 进程。
    codex-mcp:
      type: mcp-client
      command: codex
      args: mcp-server

    # OpenAI 兼容 HTTP API。机密只能写 %vault:...% 占位，明文启动即拒载。
    claude-api:
      type: openai-compatible
      base_url: https://api.anthropic.com/v1
      api_key: "%vault:llm.claude%"

    # CLI/守护类 Agent（openclaw 系）。安全约束（design 决策 5）：
    # type: cli 未声明 sandbox: isolated 时不得担任 detached 默认驱动。
    openclaw:
      type: cli
      endpoint: http://127.0.0.1:9800
      sandbox: isolated           # 当前唯一合法非空取值：isolated

  # 未配置驱动 / 路由失败时的兜底路径。当前契约唯一取值：human
  # （升级人工，零 LLM 调用）。
  fallback: human                 # 默认 human

# ── runtime：浏览器运行时（会话池 / 护栏 / 代理出口）配置（蓝图 04 §2/§3）──
#
# 整段可省略：省略时使用下方标注的内置默认值。会话池管理浏览器的暖复用与
# 空闲回收，护栏按域限制并发/速率，代理出口默认关闭（本地直连最一致，03 §7）。
runtime:
  # 会话池：暖复用 + LRU + TTL（session-pool）。
  pool:
    max_idle: 8                   # Parked 池容量上限，触及即 LRU 淘汰，默认 8
    ttl: "5m"                     # 单个 Parked 会话的 TTL，达到即回收关闭，默认 5m
    warm_reuse: true             # 是否启用暖复用；false 则一律冷启动，默认 true
    idle_timeout: "2m"           # Ready 会话空闲多久进入 Draining，默认 2m

  # 崩溃恢复：从检查点续跑的重建重试上限（browser-lifecycle）。
  recovery:
    max_retries: 3               # 重建重试上限，超限转 Failed，默认 3

  # 按域并发/速率护栏（session-pool）。未在 domains 列出的域用 default_*。
  guardrail:
    default_concurrency: 4       # 每域默认并发会话上限，默认 4
    default_rate: 0             # 每域默认速率上限（次/秒），0 表示不限速，默认 0
    domains:
      example.com:
        concurrency: 2           # 覆盖该域并发上限
        rate: 1                  # 覆盖该域速率上限（次/秒）

  # 可选代理出口：默认关闭；仅策略要求或声誉风险时启用（本地优先，03 §7）。
  proxy:
    enabled: false               # 默认 false

# ── 以下为占位段：本阶段仅做结构解析与透传，不产生任何行为 ──

# adapters：inbound 适配器（MCP Server / REST/gRPC）配置，属后续变更。
# adapters:
#   mcp:
#     enabled: true

# vault：机密库配置，属后续变更。机密值只能以 %vault:<key>% 形式被其他段引用。
# vault:
#   backend: "file"