附录：Agent worker 配置

Agent worker 配置#

.ait/agent-workers.json 为一个 AIT Repository 声明具名的消息 worker。 1.0.0 支持 telegram、line、discord 和 slack。默认位置可以用 AIT_AGENT_CONFIG_PATH 覆盖。

先读 ait-agent-worker：消息与回复运行时， 了解这个可执行文件的职责、完整命令面、从消息到回复的路径、传输模式、 原生 Codex provider、运行时接纳和安全限制。这份附录是逐字段的编写参考。

规范文档形状#

{
  "version": 1,
  "workers": {
    "telegram/support": {
      "kind": "telegram",
      "name": "support",
      "mode": "poll",
      "username": "support_bot",
      "env_path": ".ait/agent-runtime/telegram.env",
      "request_timeout_seconds": 30,
      "local_reply": {
        "model": "gpt-5.4-mini",
        "reasoning_effort": "low",
        "sandbox": "workspace-write",
        "turn_timeout_seconds": 300
      }
    }
  }
}

作者要写的就是上面那种直接的 version 加 workers 对象。内部诊断投影 可能会把它包在 config 里；别把那层包装写进仓库文件。

worker 的 key 用确切的 <kind>/<name> 形式。kind 和 name 都必须非空， name 里不能有 /，显式写出的 kind 必须和 key 一致。当前约定下 version 是整数 1。规范化过程中出现问题时，worker 会启动失败并直接 关停。

通用 worker 字段#

运行目标从 .ait/config.json 推导：solo_local 在本地跑；有远程的工作流 则需要一个有效的默认远程 URL。当 worker 没有设置 model 时，Repository 的 default_model 提供 Telegram 的模型回落值。

凭据来源与优先级#

凭据字段必须是非空字符串。解析顺序是：

1. worker 条目本身；
2. 当前进程环境；
3. worker 的 env_path 文件。

其他行为类字段只来自 worker 条目或它们编译期的默认值；env 文件覆盖不了 它们。环境文件接受 KEY=VALUE 行、空行、# 注释，以及值两边配对的一对 单引号或双引号。它们不是 shell 脚本。

别把机密留在提交上去的清单里。优先用仅所有者可读的 env 文件或进程环境， 并使用环境变量附录 里那些确切的变量名。

local_reply#

这个嵌套对象里的未知字段会被拒绝。

sandbox 的取舍是一条执行边界，不是消息偏好。只给这个 worker 完成其 Repository 任务所需的访问权限。

Telegram 字段#

LINE 字段#

Discord 字段#

选用哪条 worker 命令，决定了该服务模式下 public_key、bot_token 是必须 其一还是两者都要。

Slack 字段#

选用哪条 Slack 命令，决定了必须提供的是 socket 凭据还是 HTTP 签名密钥。

验证#

用完整 CLI 参考里的 agent worker 查看和启动命令。诊断输出只报告凭据是否 已设置，不会打印它们的值。webhook 监听器先在环回地址上测试，再通过可信的 反向代理对外暴露。