后台工作与授权
配置好后台 Agent后,可以直接要求助手查询电脑信息、修改文件、 编写程序或使用后台已有的工具与 Skills。执行能力、登录状态和可操作范围由后台环境决定。
未配置后台时,前台不提供 spawn_thinking 或 update_agent_task,也不能创建定时执行任务; 聊天、可用的前台工具以及定时提醒仍可使用。工作查询和取消工具保留,用于管理提醒等已有记录。
发起与继续
- 发起工作:“帮我做一个极简的网页小游戏。”
- 补充要求:“刚才那个页面改成深色背景。”
- 查询:“现在进行到哪里了?”
- 取消:“取消刚才那个小游戏。”
后台工作异步进行,不会要求你停止聊天。继续某项工作时,说明目标或引用卡片中的标识, 尤其在同时有多项工作时。是否支持恢复原生会话、独立工作或特定工具,取决于所选后台; 不能把某个后台的能力当作所有后台的保证。
ACP 为每个用户和后台维护一个持久协调 Session,各轮次顺序执行;新增工作不会隐式取消已有工作。 对于目标明确独立、适合持续独立执行的工作,使用项目 Session;简短操作、澄清和结果整理留在协调 Session。相关后续要求继续指向原项目 Session,不另建重复工作;用户无需明确要求单独的 Session。 同一轮可以派出多项独立工作。不支持委派的后台直接执行请求。
派出或续接独立工作后,协调 Session 不等待、不轮询,也不在本地重复执行,而是结束当前轮次, 继续接收其他请求。项目 Session 独立执行,经验证的结果重新进入同一个协调队列,整理最终回复。 Session 不隔离文件、工作目录或外部资源。
QWEN_AUDIO_AGENT_TASK_MAX_CONCURRENT_PER_OWNER=1 和 QWEN_AUDIO_AGENT_TASK_MAX_CONCURRENT=1 仍是默认任务准入上限,不是项目 Session 的数量上限。直接执行中的任务占用准入名额,包括等待输入或授权; ACP 委派在协调轮次结束后释放名额,因此默认配置不等于所有独立工作只能串行。 提高这些上限也不会创建更多协调 Session。
对话上下文
除本次指令外,运行时最多补充 2,000 字符的新增人机对话,帮助协调 Agent 理解指代。 系统跟踪已投递的对话位置,不反复附加完整历史。这些背景不是新的执行要求,也不复制工具调用、 工具结果、后台原始输出、前台人格或长期记忆。附件仍通过协议原生内容块传递,无需新增前台工具。
调整正在执行的工作
“再画一只小猫”是排队新增工作,不会取消正在绘制的小狗;“把刚才的小狗改成小猫”才是调整。 前台用 spawn_thinking 新建,用 update_agent_task 定向补充、修改或回答追问,沿用同一个工作 ID 和原后台上下文。 指代不清时先确认目标,而不是按“后台是否忙碌”猜测。
- 排队中:把新要求合入该工作的首次执行,不影响正在执行的其他工作。
- 等待输入:用
instruction把用户答复交回同一任务,可用input_request_id绑定具体请求。 确认、拒绝或修改条件都保留用户的自然语言,由后台结合原上下文解释;修改条件不代表批准旧预览。 - 执行中:ACP 后台优先使用已确认支持的注入扩展;否则取消当前轮次,等待结束后在同一会话续接。
- ACP 独立工作:修改先交给协调 Session,由它通过
session_send转交原项目会话;只有一个项目时也一样。 协调 Session 忙时排队,不打断其他任务;仅口头确认不算投递成功。 - 已完成的直接执行工作:原上下文可用时可以继续,仍使用原工作 ID;原来的结果保留在历史中。 原会话正被其他任务占用时等待该会话空闲,不能把调整发给其他任务。
- 已完成的框架 ACP 委派:沿用原工作 ID,经原协调 Session 用
session_send续接该工作绑定的项目会话, 不新建替代会话,也不重跑未修改的其他项目。
调整受理不等于已生效,也不会撤销已经执行的操作。改变工作要求时,按任务授予的权限会重新确认, 会话内“始终允许”保持有效。后台不支持调整、会话不可恢复或结果仍在投递时,会返回明确错误。 没有可靠定向续接入口的原生后台委托不提供续接上下文。缺少版本化项目绑定的旧 ACP 续接上下文会明确报错, 不猜测目标或自动迁移;运行中的框架 ACP 委派支持定向调整。 网关重启后不会自动重发未确认投递的要求,避免重复执行。终止整项工作使用 cancel_agent_task, 后台权限决定仍使用 respond_permission。
看懂工作状态
提交成功表示已接受请求,不表示工作完成。卡片可以显示排队、执行中、等待输入或授权、 准备播报以及最终结果。查询和取消也应以实际返回的状态为准;提出“取消”不等于已经停止。
后台可能需要追问,而不是交付最终结果。此时回答它的问题即可继续。 工作失败时保留错误信息,检查后台登录、模型额度和工具环境,不要仅凭前台连接正常判断后台可用。
允许与拒绝
后台提出真实权限请求时,界面显示待确认操作,前台可向你询问。可以自然表达:
| 决定 | 效果 |
|---|---|
| 允许此任务 | 允许当前任务及其后续操作,直到任务完成、失败或取消;其他任务需重新授权。 |
| 始终允许 | 在当前前台会话内允许后续由 Gateway 管理的权限请求,不是永久修改所有后台配置。 |
| 拒绝 | 拒绝当前请求。 |
普通同意按“允许此任务”处理,后续操作(包括写入或删除)也在此授权范围内。 授权只保存在当前 Gateway 进程中,重启后需重新确认。
多项工作同时等待授权时,说明你允许或拒绝哪一项。并非所有后台都会提供权限事件; 例如不具备审批能力的后台,不能靠前台凭空增加沙箱。后台原生安全限制也不一定能由 Gateway 的“始终允许”解除。
native / full 启动权限模式与后台差异见后台权限模式。
前台 MCP / OpenAPI 工具的确认和鉴权由对应服务负责,不要把后台审批流程当作所有工具的统一保护。 配置工具时只启用你信任且确实需要的操作。