用途：在已连接 Beaker 的仓库中，通过 beaker CLI 启动和管理智能体优化运行，不修改集成、应用、测试、数据集、CI/CD 或配置。
主要能力：检查 CLI 与技能版本；发现所选智能体与配置路径；列出分支与托管数据集；检查托管 required_env 就绪；启动运行、比较模型、查询状态、拉取结果、取消运行。
必要用法：先运行 beaker --version；版本不符按资料方式升级。项目根目录执行，非默认配置路径时保持全局选择器：beaker --config-file services/invoices/.beaker/beaker.yaml <command>。常用命令包括 beaker agent list --json、beaker github branches --repo <owner/repository> --json、beaker dataset list --agent <selected-agent> --json、beaker agent env check --integration-id <id> --agent <selected-agent>，启动示例：beaker run trigger --integration-id <id> --agent <selected-agent> --dataset <dataset-ref> --json；模型比较重复 --optimization-model provider:model（1–8 个）。状态退出码 0 完成、1 终态失败、2 查询或客户端错误、3 运行中（非失败）。监控可用 beaker run status <full-run-id> --watch --poll-interval 15 --poll-timeout 45 --json。拉取：beaker run pull <full-run-id> --output-dir .beaker/results/<full-run-id>。取消：beaker run cancel <full-run-id> --json。
限制：需开发者明确授权后启动；不暴露 .beaker/.env 等密钥；--ref 仅接受远程分支，不接受 tag 或 commit SHA；集成配置损坏应改用 $beaker-setup；不新增 Beaker 相关测试或 CI/CD；不把未推送本地改动纳入托管运行；文档 ChangeSet 仅显式请求时应用。其他功能、收费或平台细节暂未提供。