wx44wx/ai-video-fullstack
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

Simplify task backend configuration forms
Quality gate / backend (push) Waiting to run
Details
Quality gate / frontend (push) Waiting to run
Details

Browse Source
This commit is contained in:
Xin Wang
2026-10-25 23:26:35 +08:00
parent 6043eb9b63
commit d7c44064d4
5 changed files with 138 additions and 104 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs-developer/prompt-background-tasks.mdx
+9 -12
View File
@@ -28,15 +28,15 @@ npm ci
## 创建任务后端资源
在「组件库 → 任务后端」点击「添加任务后端」，选择一种类型。
在「组件库 → 任务后端」点击「添加任务后端」，选择一种类型。默认表单只填写名称及运行必需的模型或连接信息；推理强度、技能、时限等按需展开「高级设置」。新资源默认启用，启用状态在列表中管理。
### 内置 Reasoner
1. 选择已启用的 LLM 模型资源；支持 `openai-llm` / `dashscope-llm` 接口，需真实可用的模型和凭据。每个任务会创建独立上下文，不复用 Speaker 的对话历史。
2. 推理强度默认「模型默认」。只有模型真实支持 `reasoning_effort`，且模型资源已声明 `supportsReasoningEffort` 时，才可选择 low / medium / high；未声明的非默认配置会被拒绝。当前没有通用 thinking budget 设置。
3. 在「可用工具」绑定允许 Reasoner 调用的 HTTP/MCP 服务端工具。Client 工具依赖浏览器，只能用于当前对话，不能供后台执行。
4. 按需添加内联技能名称与任务说明。技能指导工作方法，不能授予新工具或扩大权限。
5. 填写可复用的后端任务指令与任务时限，保存资源。时限默认 600 秒，可设置 30–7200 秒；新任务时限覆盖排队和执行。
2. 按需在「可用工具」绑定允许 Reasoner 调用的 HTTP/MCP 服务端工具；默认无工具。Client 工具依赖浏览器，只能用于当前对话，不能供后台执行。
3. 「高级设置」中的推理强度默认「模型默认」。只有模型真实支持 `reasoning_effort`，且模型资源已声明 `supportsReasoningEffort` 时，才可选择 low / medium / high；未声明的非默认配置会被拒绝。当前没有通用 thinking budget 设置。
4. 在「高级设置」中按需添加内联技能名称与任务说明。技能指导工作方法，不能授予新工具或扩大权限。
5. 任务时限默认 600 秒，在「高级设置」可调整为 30–7200 秒；新任务时限覆盖排队和执行。该助手的任务要求在助手侧填写。
Reasoner 没有内置通用 Shell/文件执行环境。需要修改仓库或运行远端命令时，使用配置好执行环境的 OpenCode 后端。
@@ -48,12 +48,9 @@ Reasoner 没有内置通用 Shell/文件执行环境。需要修改仓库或运
| --- | --- |
| 服务地址 | 平台后端可访问的 HTTP(S) 地址，例如同机宿主运行时的 `http://127.0.0.1:4096` |
| 远端工作目录 | OpenCode 所在机器的仓库绝对路径，例如 `/workspace/my-project` |
| 服务用户名 | 默认 `opencode`，与远端服务鉴权配置一致 |
| 服务密码 | 对应 `OPENCODE_SERVER_PASSWORD`；编辑时留空保留原凭据 |
| 远端 Agent | 可选；留空使用远端默认 Agent |
| Provider ID / Model ID | 可选，必须成对填写；留空使用远端默认模型，模型凭据在远端配置 |
| 远端技能说明 | 记录已部署技能与配置来源；不会上传或安装技能 |
| 后端任务指令与时限 | 所有引用该资源的助手共享的要求；默认时限 600 秒 |
服务用户名默认 `opencode`。需要自定义用户名、覆盖远端 Agent 或 Provider ID / Model ID 时，展开「高级设置」；模型 ID 必须成对填写，留空使用远端默认配置。模型凭据、技能与执行权限由远端配置。任务时限默认 600 秒，按需在高级设置调整。已有资源中的备注和通用指令会随编辑保存保留。
如果后端在 Docker 中、OpenCode 在宿主机，需使用容器可访问的宿主地址；浏览器电脑上的 `localhost` 与后端所在机器无关。
@@ -63,8 +60,8 @@ Reasoner 没有内置通用 Shell/文件执行环境。需要修改仓库或运
1. 打开提示词助手，运行方式选择「Pipeline」，在「模型与语音」选择 Speaker、ASR、TTS。
2. 在独立的「任务后端」区域选择刚创建的资源。无需到「外部工具」绑定 OpenCode，也不需要填写委派函数名。
3. 按需填写「该助手的任务指令」，例如完成后说明修改范围和验证结果；可引用已声明的动态变量。
4. 新配置通常保留「任务要求来源 → Speaker 生成任务要求」。旧 task 工具的固定值、变量和模板预设会迁入此处，编辑保存时保留；只有明确修改来源才替换预设。
3. 按需填写「任务说明」，例如完成后说明修改范围和验证结果；可引用已声明的动态变量。
4. 新配置默认由 Speaker 根据对话生成任务目标。固定值、变量或模板等任务要求来源在「高级设置」中调整。旧预设会原样保留，并在折叠标题旁提示当前来源；仅展开或收起设置不会修改预设。
5. 保存后，在手动语音调试中提出一个小任务。展开「后台任务」查看进度、结果、回答必要问题或停止任务；网页刷新后仍可查询。
Speaker 自动获得 `delegate_task`、`get_background_task`、`cancel_background_task` 和 `send_background_task_message` 控制入口，这些函数名由平台保留。单个待处理问题可通过对话回答；OpenCode 权限和多个问题在网页卡片处理。