内部培训教学使用说明

1. 培训目标

1. 学会从首页发起任务并理解三种执行方式。
2. 学会在会话页跟踪执行、处理中断、查看产物、继续对话。
3. 学会按业务场景配置 Skills、MCP、Subagents、插件、通知等能力。
4. 学会使用定时任务与发布页实现自动化交付。
5. 管理员学会用户管理、产物治理、通知通道配置。

2. 课前准备

1. 确认学员账号可登录，管理员账号单独准备。
2. 准备 1 个可演示的 Git 仓库地址（可选带鉴权）。
3. 准备 1 份上传文件（如 PDF 或 Markdown）用于附件演示。
4. 准备 1 个通知通道（邮箱或机器人 WebHook）用于通知测试。
5. 准备 1 个对外测试回调地址用于 WebHook 推送验证。

3. 教学大纲（模块拆分）

4. 模块A：登录与界面总览

操作流程

1. 进入登录页，使用账号密码登录。
2. 登录后介绍左侧导航：新任务、搜索、能力、智能工作台、项目、定时任务结果、外部接口会话。
3. 点击右上角设置入口，说明“个人设置”与“管理员后台”是两条能力线。

注意要点

1. 普通用户看不到管理员后台入口。
2. 侧边栏“外部接口会话”是 API 调用产生的会话，不是手工创建的聊天。
3. “定时任务结果”按任务分组展示运行记录，可直接跳转会话结果。

教学演练

1. 学员完成登录并能说出至少 3 个一级入口用途。

5. 模块B：任务创建与执行模式

操作流程

1. 在首页输入任务描述，直接发送。
2. 演示三种模式入口。
3. 任务模式用于直接执行。
4. 计划模式用于先出计划、再人工审批后执行。
5. 调度入口用于“立即/指定时间/夜间”执行同一任务。
6. 演示附件上传与粘贴上传。
7. 演示仓库配置与连通性测试。
8. 演示浏览器能力开关与实现方式选择。
9. 演示能力条中按会话选择 MCP、Skills、Subagents、插件。

注意要点

1. 任务描述为空时无法发送。
2. 指定时间执行必须填写具体时间。
3. 仓库配置建议先做连通性测试再提交任务。
4. 浏览器开启后会影响执行资源消耗，非网页任务建议关闭。
5. 能力条里的选择是“本次新会话草稿选择”，不是全局安装状态变更。

教学演练

1. 每位学员完成一次“带附件+带仓库+开启浏览器”的任务提交。
2. 每位学员完成一次“计划模式”任务提交。

6. 模块C：会话执行页（核心实操）

操作流程

1. 进入会话页后先看状态栏和时间线，识别准备阶段与执行阶段。
2. 查看 Todo 列表，理解 Agent 的阶段性计划与完成状态。
3. 演示人工交互卡片。
4. 计划审批卡片：审批通过或拒绝。
5. AskUserQuestion 卡片：逐题回答并提交。
6. 演示“停止任务”“同步最新消息（补偿）”“分叉会话”。
7. 演示右侧面板切换。
8. 电脑面板：查看实时执行与回放。
9. 产物面板：查看文件变化、预览文档、下载文件。
10. 演示会话内插件选择器，更新后对下一条消息生效。
11. 演示工作区文件分享，生成公开链接并设置过期策略。
12. 演示会话分享，选择随副本带入的能力，并用另一个账号登录后创建新对话。

注意要点

1. 任务运行中发送新消息会进入待发送队列，不会丢失。
2. 需要人工输入时，未完成问答会阻塞后续流程。
3. 停止操作是异步行为，失败时要重试并观察状态回滚。
4. 分叉仅适合已完成或空闲会话，运行中不可分叉。
5. 工作区文件分享可以公开访问；会话分享必须登录，并按访问者权限创建独立副本。
6. 会话链接展示源会话的最新内容，点击创建副本时才固定消息、产物和能力快照。
7. Skills、插件和 Subagents 按分享者选择从工作区复制；MCP 只按正式名称匹配访问者已启用的配置，缺失时会提示。
8. 会话副本不会带入仓库凭证、用户凭证等私密数据，培训前仍需检查消息和产物是否适合分享。

教学演练

1. 现场模拟一次计划审批。
2. 现场模拟一次 AskUserQuestion 问答提交。
3. 完成一次会话分叉并在分叉会话继续提问。
4. 完成一次会话分享，并用另一个账号从分享页创建副本后继续提问。

7. 模块D：项目与任务组织

操作流程

1. 创建项目并重命名。
2. 将会话归入项目，演示项目内继续发起任务。
3. 删除项目并观察任务回到任务清单。
4. 打开全局搜索，按关键词检索“任务标题”和“消息内容”。
5. 在搜索结果中直接跳转目标会话。

注意要点

1. 项目主要用于组织会话，不改变执行引擎行为。
2. 删除项目不会删除会话本身。
3. 搜索是跨会话检索，建议约定任务命名规范提升可检索性。
4. 当前“项目分享”入口在界面中可见，但流程未作为主培训功能使用。

教学演练

1. 学员完成“创建项目 -> 发起任务 -> 搜索定位该任务”的闭环。

8. 模块E：能力中心（重点）

E1 Skills

操作流程

1. 进入能力中心的 Skills 页面。
2. 演示安装、启用、停用、升级、回滚。
3. 演示导入技能：ZIP 导入与 GitHub 地址导入。
4. 进入技能详情，演示文件树编辑、上传、保存、重命名、删除。

注意要点

1. 导入时名称需符合命名规则。
2. 技能是否可在会话中生效，取决于“已安装 + 已启用 + 会话已选中”。
3. 技能详情页有未保存修改时切换文件会触发确认。

E2 MCP

操作流程

1. 进入 MCP 页面，演示启用/停用与测试。
2. 演示新增 MCP：填写唯一名称、JSON 配置、作用范围。
3. 演示测试结果查看与复制。

注意要点

1. 配置 JSON 必须合法。
2. 系统级配置通常仅管理员可管理。
3. MCP 测试失败优先检查鉴权与网络连通。

E3 Subagents

操作流程

1. 新建 Subagent，填写名称、描述、内容。
2. 选择关联 Skills，保存后启用。
3. 在会话创建时选择 Subagents。

注意要点

1. 名称建议使用稳定短标识，便于复用。
2. Subagent 适合可复用的子任务，不要写成一次性提示词。

E4 插件

操作流程

1. 上传 ZIP 插件包。
2. 处理重名覆盖确认。
3. 在插件列表启用插件。
4. 在会话页按需切换会话级插件集。

注意要点

1. 插件包需符合结构要求，并包含插件清单文件。
2. 插件更新后建议新会话验证，避免旧上下文干扰。

E5 Slash Commands

操作流程

1. 新建 Slash 命令。
2. 演示 Raw Markdown 模式。
3. 演示 Structured 模式（description、argument-hint、allowed-tools、content）。
4. 在聊天输入框输入 / 验证自动补全。

注意要点

1. 命令名不含 /。
2. Raw 与 Structured 二选一，以团队规范统一。

E6 环境变量

操作流程

1. 新建变量，设置 key、value、描述、范围。
2. 演示编辑变量与覆盖系统变量。

注意要点

1. 前端不回显明文值，更新需重新输入。
2. 系统范围变量用于共享基线，个人范围变量用于个性化密钥。

E7 用户通知

操作流程

1. 添加通知渠道（邮箱/飞书/钉钉/PushDeer）。
2. 配置目标地址与密钥。
3. 测试发送并启用。

注意要点

1. 渠道可单独启停。
2. 钉钉、PushDeer 等渠道密钥在编辑时留空通常表示不改密钥。

E8 全局指令

操作流程

1. 打开全局指令页。
2. 开启开关并编辑指令内容。
3. 保存后创建新会话验证效果。

注意要点

1. 生效点是“下一次执行”，不是对历史运行回放生效。
2. 全局指令应保持简洁稳定，避免写入短期临时信息。

9. 模块F：定时任务与发布页

F1 定时任务

操作流程

1. 创建定时任务，设置名称、步骤、Cron、启用状态，并按需开启“固定地址发布”。
2. 选择能力配置（MCP/Skills/Subagents/插件）。
3. 配置会话复用、浏览器、通知。
4. 在详情页执行“立即触发”、查看运行记录、查看结果会话。

注意要点

1. 复用会话模式不支持续聊步骤。
2. 非复用模式下多步骤会按批次串联。
3. 任务删除后不再触发，但历史会话仍可查看。

F2 发布页

操作流程

1. 定时任务的常用链路：创建任务时开启“固定地址发布”，系统自动生成发布 Key 并绑定任务。
2. 在任务列表通过编辑按钮左侧的图标打开固定发布页；已有可发布产物时会立即完成首次发布。
3. 需要固定入口文件、分类或公开到案例库时，再进入发布页编辑高级配置。
4. 已有对话仍可在发布页中手动创建固定地址。
5. 打开公开页验证版本切换。

注意要点

1. 固定发布地址适合对外系统长期引用。
2. 默认文件建议固定，降低自动识别失败概率。
3. 发布内容通常是 .html/.md，培训中要强调对外内容审查。

10. 模块G：智能工作台

操作流程

1. 首次进入工作台，执行历史会话引导分析。
2. 使用筛选器按状态、优先级、时间、主题检索洞察。
3. 打开洞察详情，查看摘要、建议动作、证据、来源会话、关联产物。
4. 执行建议动作。
5. 打开来源会话。
6. 标记状态（已处理/取消已处理）。
7. 使用“继续推进任务”创建新会话，并选择是否纳入工作台。
8. 配置工作台通知状态与通知渠道。

注意要点

1. 工作台是“决策运营层”，不是原始聊天记录替代。
2. 建议动作执行失败时优先回到来源会话人工处理。
3. 历史版本只读，不能直接改写旧洞察。

教学演练

1. 选择一条 needs_action 洞察并完成“查看证据 -> 执行动作 -> 状态更新”。

11. 模块H：设置中心与外部接入

H1 个人设置

操作流程

1. 查看账户信息与角色。
2. 配置远程浏览器（启动、停止、打开新窗口）。
3. 管理数据（会话间站点数据保留、清空浏览器数据）。
4. 查看使用情况统计。
5. 配置系统提示词（默认/自定义）。

注意要点

1. 远程浏览器在 HTTPS 页面可能存在混合内容限制，需新窗口打开。
2. 在远程浏览器完成登录后，后续云端浏览器任务通常可以继续使用该登录状态。
3. 清空浏览器数据是不可恢复操作，清空后相关网站需要重新登录。

H2 API Key 管理

操作流程

1. 创建 API Key，设置作用域和有效期。
2. 配置该 Key 对应的能力（能力集合、浏览器能力）。
3. 复制 Key 并在外部系统调用。

注意要点

1. Key 明文通常只在创建后可见一次。
2. 管理后台范围 Key 仅管理员可创建。

H3 WebHook

操作流程

1. 新增 WebHook，配置推送地址、范围、会话类型过滤、重试参数。
2. 通过“测试推送”验证连通性。
3. 使用真实会话完成一次任务，验证 session.completed 回调。

注意要点

1. 当前主事件为 session.completed。
2. 生产环境建议启用签名校验、时间窗口校验、幂等去重。
3. 测试建议带 session_id，避免过滤规则误判。

H4 OpenAPI 接入

操作流程

1. 使用 API Key 调用 /openapi/v1/messages 或 /openapi/v1/chat/completions。
2. 通过 metadata.session_id 做会话复用。
3. 根据需要启用流式 SSE。

注意要点

1. 当前链路只读取最后一条 user 消息作为输入。
2. 外部接入产生的会话会进入“外部接口会话”分组。

12. 模块I：管理员后台

操作流程

1. 进入后台概览查看成本、运行、活跃、资源统计。
2. 用户管理。
3. 新建用户。
4. 编辑角色与限额。
5. 禁用/启用用户。
6. 导出用户 CSV。
7. 产物管理按用户/后缀/会话筛选并预览下载。
8. 系统通知配置（SMTP）并发送测试邮件。

注意要点

1. 管理员操作建议双人复核，尤其是删除、禁用、密钥配置。
2. 用户限额策略建议先设“观察阈值”，再逐步收紧。
3. 邮件配置保存后应立即测试，避免生产告警失效。

13. 统一实操通关任务（建议作为结课考核）

1. 新建项目并创建一个带附件的计划模式任务。
2. 在会话中完成一次计划审批并导出产物链接。
3. 新建一个定时任务并手动触发一次。
4. 创建时开启固定地址发布，并从任务列表打开公开页面。
5. 配置一个通知渠道并完成测试发送。
6. 使用 API Key 调用一次 OpenAPI，并在侧栏看到外部接口会话。

14. 常见问题与排查建议

1. 任务一直不动。
2. 先看会话状态是否 queued/accepted/running。
3. 再看是否在等待人工输入卡片。
4. 最后看执行日志与 WebHook 回调是否异常。
5. MCP 测试失败。
6. 先检查 JSON 配置和鉴权头。
7. 再检查网络可达性与服务端协议是否匹配。
8. 定时任务没触发。
9. 检查任务是否启用、Cron/时区是否正确、是否被过滤条件拦截。
10. 通知未送达。
11. 检查渠道是否启用、目标地址是否有效、配置是否保存、测试是否成功。

15. 培训实施建议

1. 采用“讲 30% + 练 70%”方式，每个模块都要求学员动手。
2. 统一使用同一份演示任务模板，便于横向对比学员操作结果。
3. 培训结束后保留一份“标准操作清单”，让新同学按清单自检。