基本概念
Qwen Audio Agent 将实时对话和后台执行分开:你可以继续聊天,执行进度与结果会回到对话中。
三个核心组件
| 组件 | 负责什么 |
|---|---|
| 前台 Agent | 借助实时模型理解输入、自然回应,并调用可用工具。 |
| 编排运行时(Orchestration Runtime) | 衔接前后台,管理任务、权限、会话与事件,并安排结果回到对话。 |
| 后台 Agent | 使用自己的模型、工具、MCP 和 Skills 执行工作。 |
前台 Agent 不等于客户端,也不只是模型 API。 实时模型结合提示词、上下文和工具构成前台 Agent;桌面版、WebUI、TUI 和手机等客户端负责收音、播放、输入与展示。
Gateway 是什么
Gateway 是框架的服务化运行形态,在电脑或服务器上承载编排运行时,通过协议让客户端接入。它不是与前台、编排运行时、后台并列的第四个核心组件,也不是协议名称;客户端使用的是 Gateway Client Protocol。
桌面版内置 Gateway,也可以连接远程 Gateway;手机等远程客户端不需要在本机运行后台 Agent。组件划分描述职责,部署方式决定它们在哪里运行。
前台模型与后台模型
- 前台模型负责实时交流,例如 Qwen Audio Realtime。模型能力会影响转写、视觉和工具调用。
- 后台模型由所选 Agent 使用。默认沿用 Agent 自己的配置;只有显式指定时,Gateway 才请求覆盖。
- 两者的账号、额度和模型配置独立。配置前台 Key 不代表后台已登录。
不配置后台也能用
AGENT_PROTOCOL 留空或设为 none 即为仅前台模式。可以聊天,并使用已启用且语音服务支持的搜索、记忆等工具。需要电脑操作或后台执行的请求则无法完成。
会话、工作与工作区
| 名称 | 含义 |
|---|---|
| 前台会话 | 一段语音与文字对话;新建会话不清空长期记忆。 |
| 后台工作 | 一次被接受的执行请求,有状态,可以查询或取消;提交成功不等于执行完成。 |
| 后台 Session | Agent 自己维护的执行上下文;是否恢复、如何委派由后台能力决定。 |
| 工作区 | 后台处理项目文件的默认目录,不是权限沙箱。 |
本机与远程
默认 CLI 和桌面版可以各自运行 Gateway,共享配置与用户数据,但任务和会话状态独立。要在另一个客户端查看同一实例的工作,必须连接同一 Gateway。
同一 Gateway 中,每个用户只有一个活动客户端。新客户端确认接管后,旧连接会断开,后台工作不会因此被取消。
下一步:快速开始 · 选择语音前台 · 选择后台 Agent