F4: document task backend operation and publish API contracts

This commit is contained in:
Xin Wang
2026-10-23 23:48:08 +08:00
parent fff76fe889
commit 7db737d161
9 changed files with 746 additions and 180 deletions
+15
View File
@@ -42,6 +42,21 @@ Pipeline 的“高级交互配置”可以调整 VAD 阈值、开始/停止确
Prompt Realtime 中,Qwen Audio 已声明部分 HTTP、MCP、Client 和内置工具能力;StepFun Prompt Realtime 尚未声明工具能力。保存助手前,界面和服务端会校验不兼容项。外部 Agent 的上下文、知识库和工具通常由对应服务管理。
## Speaker 与任务后端
提示词 Pipeline 可配置「对话模型 Speaker + 任务后端」。Speaker 负责语音交流、澄清与播报,任务后端有独立上下文,执行期间可继续对话。Workflow 和 Realtime 当前不支持任务后端。
在「组件库 → 任务后端」创建资源,再到提示词助手的「任务后端」区域选择。任务后端不在普通工具列表中,也不需要填写委派函数名。
| 后端 | 配置 | 执行边界 |
| --- | --- | --- |
| 内置 Reasoner | 独立 LLM 模型、推理强度、HTTP/MCP 工具白名单、内联技能 | 只有模型已声明支持 `reasoning_effort` 才可选非默认强度;Client 工具不可用于后台执行。技能不能扩大工具权限。 |
| 外部 OpenCode | 服务地址、工作目录、用户名/密码,可选 Agent 和远端模型 | 文件、Shell、沙箱与技能由远端环境管理;平台不安装远端软件或技能。 |
默认任务时限 600 秒,可设置 30–7200 秒,覆盖排队和执行;当前要求单进程运行,全局并发固定 1。展开语音调试中的「后台任务」可查看结果、回答问题或停止任务。插话和语音断线不会自动取消任务;明确停止后需核查执行状态,已发出的操作可能已有副作用。
应用重启后,OpenCode 仅重新观察已保存的任务句柄;Reasoner 标记为中断,不自动重放工具。真实模型及远端编码环境仍需联调,不能以模拟测试代替真实执行验收。
## 配置建议
- 需要明确控制 ASR、LLM、TTS、VAD 和轮次结束策略时,先选 Pipeline。