Q:glm-5.3 和 glm-5.3-flash 怎么选? A: 要更强推理、处理复杂场景、能多想一会儿,用 glm-5.3。更在意首响速度,或需要读图,用 glm-5.3-flash。两款都支持 low / high / max,可在创建 Agent 时用
{"id": "...", "effort": "..."} 指定。详见定义 Agent。
Q:能用 Coding Plan 套餐额度跑 Managed Agents 吗? A: 不能。目前暂不支持 Coding Plan。模型用量一律按开放平台 API 按量计费,使用标准 API Key,按 模型价格 从 API 余额扣费,不会消耗 Coding Plan 套餐额度。分项说明见概述 · 计费。
Q:怎么判断这一轮做完了? A: 看 session.status_idle。会话没有单独的「本轮 completed」状态:Agent 做完一轮就会回到 idle。再看这条事件的 stop_reason.type:end_turn 表示正常结束,可以发下一条 user.message;requires_action 表示在等你回工具结果或批准,还没做完。
Q:会话停在 idle 或 requires_action,下一步做什么? A: 先看 session.status_idle 的 stop_reason:
- end_turn:本轮已结束。再发 user.message 即可继续。
- requires_action:在等你处理 event_ids 里列出的调用。自定义工具回 user.custom_tool_result,审批回 user.tool_confirmation。此时发 user.message 会被拒绝(400)。
Q:怎么打断正在跑的 Agent?中途追加消息会怎样? A: 发送 user.interrupt 会打断当前这一轮。Agent 正在跑(running)时,也可以继续发 user.message,消息会排到下一轮边界再生效,用来中途引导。若停在 requires_action,发 interrupt 会取消整组等待中的工具调用和审批。详见事件与流式输出。
Q:改了 Agent 或 Environment,已经在跑的会话会跟着变吗? A: 不会。创建会话时会钉住当时的 Agent 配置(含会话级覆盖)和环境快照,之后改 Agent 或 Environment 只影响之后新建的会话。定时任务每次触发会按环境当时的配置开一条新会话。要在某个已有会话里换工具,须等它 idle,再更新该会话的 agent.tools。
Q:Web Search / Web Fetch 现在能用吗? A: 还不能。当前工具集还不包含这两项,上线后将单独计费。
Q:更新 Agent 返回 409 是什么意思? A: 请求里带了 version,但服务器上的当前版本已经变了——通常是别人(或另一次请求)刚更新过。先 GET 最新 Agent,用返回的 version 再更新;CI 这类声明式同步可以省略 version,后写覆盖。
Q:归档和删除有什么区别? A: 归档把资源变成只读:Agent / Environment 归档后不能再开新会话,已有会话继续;会话归档后只读。删除会拿掉资源本身。归档会话再删除是允许的;running 中的会话要先 user.interrupt。各资源细节见对应指南页。
Q:环境未归档是什么意思?创建会话失败? A: 创建会话必须引用你自己的、未归档 Environment。归档或删除后的环境不能再绑新会话;仍挂在该环境上的会话,在下一次需要使用环境时可能被终止。
Q:SSE 断线后怎么续?会从上次的位置接着推吗? A: 不会。流是 live-only,只推连接建立之后的事件。记下已消费事件的 id 与 processed_at,重新打开流,再用 GET /v1/sessions/:id/events 按时间补缺口,并按 id 去重。示例见事件与流式输出。
Q:定时任务能用自定义工具 / always_ask 吗? A: 可以创建。但触发后没有人在线回工具结果或批准,会话会停在 requires_action,直到你通过事件接口补上。无人值守的 cron 请只用内置工具和 always_allow 的 MCP,凭据走 vault_ids。
Q:MCP 连不上,会话还会启动吗? A: 会。创建会话不预检 MCP。服务器不可达或凭据被拒时,会话照常交互,同时发 session.error(含 mcp_server_name 与 retry_status)。可以事先调用 mcp_oauth_validate。详见连接 MCP。
Q:有控制台吗? A: 目前以 API 开放内测,控制台等更多功能近期即将推出。现在请走 API。进展与问题反馈见概述页的反馈与交流。
Q:怎么看一次对话消耗了多少 tokens? A: 看 span.model_request_end 里的 model_usage(单次模型请求),以及 Session 对象的 usage(整段会话累计)。这些用量按开放平台 API 按量计费入账,不走 Coding Plan。
Q:Agent 生成的文件在哪里下载? A: 让 Agent 写到 /mnt/session/outputs,再用
GET /v1/files?scope_id=$SESSION_ID 列出并下载。写在 /workspace 的中间文件不会被编目。见文件。