如何用SDK让任意Bot驱动Gajae-Codegjc sdk session与Coordinator MCP集成指南【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-codeGajae-Code 是一款面向编码智能体的 AI 编程运行时它通过Gajae-Code SDKgjc sdk session命令行与 Coordinator MCP 服务让任意聊天机器人、调度器或编排器无需抓取终端文本就能安全地创建会话、下发任务、回答结构化问题并读取产物。本文将用最少代码带你完成 Bot 与 Gajae-Code 的完整集成。为什么需要 Gajae-Code SDK过去让 Bot 驱动 AI 编程工具只能靠盯屏幕解析终端滚屏、猜输出、敲键盘。这种方式脆弱且危险——一旦界面变化Bot 就会失控。Gajae-Code 的做法完全不同SDK 暴露了一套通用的动作/回复协议Bot 只需要调用受控的接口就能完成所有操作。官方内置的 Telegram、Discord、Slack 集成本身就是基于这套 SDK 实现的托管适配器证明了生产级可行性。核心优势一览能力说明会话生命周期管理创建、恢复、分叉、关闭会话全部有幂等保障回合制任务下发一次下发一个有界任务turn状态可查询结构化问答智能体提问时Bot 可按 JSON 契约自动回答事件监听持久化生命周期事件流支持断点续看产物读取白名单目录内的报告、diff、日志安全读取三条集成路径选最适合你的Gajae-Code 为外部控制器提供了三个入口按够用就好的原则选择路径适合谁入口Coordinator MCP推荐任何能发现会话、下发回合、回答问题、读取产物的外部控制器gjc mcp-serve coordinatorSDK session CLI脚本化、Broker 绑定的语义化会话操作输出无凭据 JSONgjc sdk session list\|inspect\|send\|status\|tail\|close\|retire托管适配器单会话的 Telegram / Discord / Slack 机器人预配置的托管适配器一句话总结多会话编排、状态与产物读取用 Coordinator MCP单会话简单操作可以用gjc sdk sessionCLI。详细对比见官方文档 docs/bot-integration.md 和 docs/sdk-session-cli.md。一分钟理解架构谁管什么集成前最重要的认知是职责边界外部控制器 / Bot Gajae-Codegjc ├─ 任务排队策略 ├─ 编码智能体会话 ├─ 身份与权限策略 ├─ 工作流与工具执行 ├─ 凭据保管 ├─ 会话文件与产物 └─ 启动 MCP 服务 └─ 生命周期与证据留痕你的 Bot 拥有排队、身份、策略、凭据Gajae-Code 拥有编码会话、工作流、工具、产物和证据SDK 核心保留所有端点凭据Bot永远拿不到URL/token只能使用不透明的附加能力attachment。这意味着即使 Bot 被攻陷也拿不到会话通道的密钥——这是 SDK 的安全设计核心详见 docs/sdk.md。第一步启动并验证 Coordinator MCP只需一条命令启动 MCP 服务hermes是兼容别名指向同一个契约gjc mcp-serve coordinator启动前先跑一次只读自检它不会修改任何状态只验证工具目录与 Broker 发现状态gjc mcp-serve coordinator --check --json gjc mcp coordinator doctor --json第二条命令会输出workdir_roots、session_mutations、session_command、namespace、event_webhook等检查项快速定位配置缺失。实现入口是 packages/coding-agent/src/commands/coordinator.ts契约常量集中在 packages/coding-agent/src/coordinator/contract.ts。第二步配置 Bot 的 MCP 客户端在你的 Bot 的 MCP 配置中加入 Gajae-Code关键是几个环境变量变量作用GJC_COORDINATOR_MCP_WORKDIR_ROOTS工作目录与产物路径白名单必填保持收窄GJC_COORDINATOR_MCP_MUTATIONS开启的变更类别sessions、questions、reports或allGJC_COORDINATOR_MCP_SESSION_COMMAND启动真实 GJC 会话的命令生成配置中默认gjc --worktreeGJC_COORDINATOR_MCP_PROFILE/_REPO命名空间防止一个 Bot 枚举另一个的会话一个最小可用的配置骨架{ mcp_servers: { gjc_coordinator: { command: gjc, args: [mcp-serve, coordinator], env: { GJC_COORDINATOR_MCP_WORKDIR_ROOTS: /home/bot/src/project, GJC_COORDINATOR_MCP_MUTATIONS: sessions,questions,reports, GJC_COORDINATOR_MCP_PROFILE: my-bot, GJC_COORDINATOR_MCP_REPO: project } } } }也可以用官方的渲染器生成配置预览不修改系统gjc setup hermes --root /path/to/repo --profile my-bot --repo my-repo需要时再加--install写入目标目录。该适配器的行为细节在 docs/hermes-mcp-bridge.md 中有完整说明。第三步认识 MCP 工具集Coordinator MCP 默认只读共 20 余个工具分三类 只读工具—— 无需任何授权即可调用gjc_coordinator_list_sessions/read_status/read_tail/read_turn—— 发现与观察会话gjc_coordinator_await_turn/watch_events—— 有界等待回合完成gjc_coordinator_list_questions/list_artifacts/read_artifact—— 问题与产物gjc_coordinator_read_coordination_status/read_codex_handoff—— 协作状态✍️ 变更工具—— 需要启动时开启对应类别 每次调用allow_mutation: true 调用方提供的idempotency_key三者缺一即拒绝fail closedgjc_coordinator_start_session/register_session/activate_sessiongjc_coordinator_send_prompt/submit_question_answergjc_coordinator_report_status/stop_session 高层委托工具—— 把常用流程打包成一次调用gjc_delegate_plan/gjc_delegate_execute—— 委托完整的规划或执行回合第四步跑通一个最小任务循环一个标准回合循环只需 5 步创建会话调用gjc_coordinator_start_session传入白名单内的cwd、可选的初始prompt、幂等键与allow_mutation: true返回session_id若有 prompt 还有turn_id下发任务后续任务用gjc_coordinator_send_prompt发送一个有界回合。一个会话默认只有一个活动回合第二个 prompt 需传queue: true排队或force: true顶替监听事件以gjc_coordinator_watch_events为主循环持久化next_after_seq游标以便重启后续传。关注turn.completed、turn.failed、turn.waiting_for_answer、question.opened等元数据事件回答问题智能体被结构化问题阻塞时用gjc_coordinator_list_questions拉取待答行按行内answer_schema提交gjc_coordinator_submit_question_answer收尾读取产物与报告向用户返回脱敏后的摘要。 不要用终端输出来推断任务是否完成SDK 的持久回合状态才是权威。如果你更习惯在终端操作gjc sdk session的七个语义动词与 MCP 一一对应list、inspect、send支持--wait有界等待、status、tail支持--until-idle、close、retire。机器调用请始终显式加--json。官方还为外部脚本提供了技能指引包sdk-skills/gjc-sdk-discover/SKILL.md发现与检查和 sdk-skills/gjc-sdk-operate/SKILL.md受控操作含单次审批与操作白名单。常见错误码速查错误Bot 该怎么做coordinator_mutation_class_disabled重新渲染 setup 开启所需变更类别或保持只读coordinator_mutation_call_not_allowed经策略批准后为该次调用加allow_mutation: trueunknown_session重新列出会话或新建受管会话active_turn_exists轮询活动回合或queue: true/force: trueawait_turn超时视为非终止态重新轮询勿直接判失败智能体回复畸形答案重读问题 schema按声明的形状重新提交完整错误处理剧本playbook见 docs/bot-integration.md。安全边界四条铁律凭据零暴露Bot 永远读不到.gjc/state/sdk端点记录、URL/token也不要自己开原始 WebSocket白名单收窄GJC_COORDINATOR_MCP_WORKDIR_ROOTS不要设为/或/home多租户 Bot 用 profile/repo 命名空间隔离变更类别最小化仪表盘类 Bot 保持只读任务派发才开sessions通知脱敏转发完成/失败通知时只传元数据摘要不转发原始 prompt、工具输出、主机路径或 webhook 地址。长任务最长数小时的回合采用进度感知租约工具执行事件会自动续租所以长任务不会中途被误杀Bot 应持久化session_id/turn_id重启后先read_turn/read_status对账再下发新工作绝不盲目重放。总结一条命令gjc mcp-serve coordinator即可让任意支持 MCP 的 Bot 接入 Gajae-Code一个循环start_session → send_prompt → watch_events → 答问题 → 读产物一套安全模型凭据留在 SDK 核心Bot 只持有不透明能力变更操作三重门启动开关 单次授权 幂等键。按这套指南你的 Telegram 机器人、GitHub 动作 Bot、定时调度器都能在几小时内获得驱动编码智能体的能力。更多进阶主题——事件 Webhook、Codex 交接桥、外部控制就绪分级——可继续参阅 docs/external-control-readiness.md 与 docs/sdk.md。【免费下载链接】gajae-codeGajae Code MVP项目地址: https://gitcode.com/gh_mirrors/ga/gajae-code创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考