diff --git a/docs-developer/prompt-background-tasks.mdx b/docs-developer/prompt-background-tasks.mdx index c2ed8fa..8e15b0d 100644 --- a/docs-developer/prompt-background-tasks.mdx +++ b/docs-developer/prompt-background-tasks.mdx @@ -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 权限和多个问题在网页卡片处理。 diff --git a/frontend/src/components/assistant-editor/task-backend-section.tsx b/frontend/src/components/assistant-editor/task-backend-section.tsx index 93edf97..253f3d2 100644 --- a/frontend/src/components/assistant-editor/task-backend-section.tsx +++ b/frontend/src/components/assistant-editor/task-backend-section.tsx @@ -66,44 +66,48 @@ export function TaskBackendSection({ value, onChange, pipeline, variables, model {error &&
先在组件库创建一个任务后端,然后回到此处选择。
} - {value && selected && <> - {!selected.enabled &&当前后端已停用,请启用资源或重新选择后端。
} -推理模型:{modelOptions.find(model => model.value === selected.config.modelResourceId)?.label ?? selected.config.modelResourceId}
-推理强度:{selected.config.reasoningEffort === "provider_default" ? "模型默认" : selected.config.reasoningEffort} · 服务端工具 {selected.config.toolBindings.length} 项 · 技能 {selected.config.skills.length} 项
- > : <> -OpenCode:{selected.config.url} · {selected.config.directory}
-Agent:{selected.config.agent || "远端默认"} · 权限、沙箱与技能由远端管理
- {selected.config.skillsNote &&技能说明:{selected.config.skillsNote}
} - >} -任务时限 {selected.config.timeoutSeconds} 秒 · 并发 1 · 断线后任务继续
-当前后端已停用,请启用资源或重新选择后端。
} {value &&Speaker 根据对话生成本次目标,后端连接与权限由资源配置决定。
} - {source.source === "variable" && } - {(source.source === "literal" || source.source === "template") && } + {source.source === "model" &&Speaker 根据对话生成每次任务的目标。
} +推理模型:{modelOptions.find(model => model.value === selected.config.modelResourceId)?.label ?? selected.config.modelResourceId}
+推理强度:{selected.config.reasoningEffort === "provider_default" ? "模型默认" : selected.config.reasoningEffort} · 工具 {selected.config.toolBindings.length} 项 · 技能 {selected.config.skills.length} 项
+ > : <> +OpenCode:{selected.config.url} · {selected.config.directory}
+Agent:{selected.config.agent || "远端默认"} · 权限、沙箱与技能由远端管理
+ >} +任务时限 {selected.config.timeoutSeconds} 秒 · 并发 1 · 断线后任务继续
+