Skip to content

基本概念 ​

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 即为仅前台模式。可以聊天,并使用已启用且语音服务支持的搜索、记忆等工具。需要电脑操作或后台执行的请求则无法完成。

会话、工作与工作区 ​

名称含义
前台会话一段语音与文字对话;新建会话不清空长期记忆。
后台工作一次被接受的执行请求,有状态,可以查询或取消;提交成功不等于执行完成。
后台 SessionAgent 自己维护的执行上下文;是否恢复、如何委派由后台能力决定。
工作区后台处理项目文件的默认目录,不是权限沙箱。

本机与远程 ​

默认 CLI 和桌面版可以各自运行 Gateway,共享配置与用户数据,但任务和会话状态独立。要在另一个客户端查看同一实例的工作,必须连接同一 Gateway。

同一 Gateway 中,每个用户只有一个活动客户端。新客户端确认接管后,旧连接会断开,后台工作不会因此被取消。

下一步:快速开始 · 选择语音前台 · 选择后台 Agent