内置特工（Agent）
特工 = 角色（系统提示词 + 欢迎语）+ 模型与生成参数 + 工具权限 + 技能白名单。ToolBank 预置了四位开箱即用的特工，你也可以克隆它们做自己的版本。
四位内置特工
💬 通用助理 —— 日常全能
- 定位：问答、总结、翻译、解释代码、写清单，默认最全能。
- 参数取向：Temperature 0.5（平衡稳定与发散），技能白名单最宽（内置技能基本全开）。
- 适合：整理日志、把报错翻译成人话、解释一段算子参数、帮你起草验收清单。
- 开场白会自动说明它能做什么，直接聊即可。
🧑💻 代码审查员 —— 只讲问题与改法
- 定位：严格按 可读性 / 健壮性 / 性能 / 安全 四维审查代码，输出结构化的问题清单（每条含位置、问题、风险级别、推荐修复）与修改后代码。
- 参数取向：Temperature 0.2（最低，输出更严谨稳定），允许读取工作空间文件（可以把文件路径 + 关键代码丢给它），技能限定为“代码审查 / 内容总结”。
- 适合：审查你正在写的 C# / C++ / Python 插件代码；要求它对未验证的外部依赖（API、文件 IO、锁）明确标注“未验证”。
- 注意：它是贴代码审查型特工，不是读取你整个程序做架构审查。
🖼️ 视觉分析助手 —— 帮你看图
- 定位：多模态，按固定结构分析一张或多张图片：整体概览 → 文本识别 → UI / 对象识别 → 异常 / 风险 → 建议下一步。
- 参数取向：Temperature 0.3，Vision 工具开启，技能限定“当前选择识别”。
- 适合：截图问报错、把现场 UI 拍下来让它描述控件布局、识别图中文字（乱码 / 遮挡会如实说“不识别”而不是猜）。
- ⚠️ 必须绑定支持图像的模型（见 模型接入）。
📋 需求分析师 —— 流程图上直接干活的特工
- 定位：被召唤到“用户视图”里的流程图控件后，能实时看到该流程图的节点树结构，与你讨论需求、指出结构缺口（重复 / 命名不清 / 层级问题），并在你明确要求下直接新增 / 修改节点。
- 参数取向：Temperature 0.4；技能白名单 = 需求讨论 + 流程图快照 / 新增节点 / 修改节点三条 API。
- 使用方式：在流程图控件上 右键 → 召唤AI特工 → 需求分析师（未召唤时它只能做纯文本分析，改不了你的图）。
- 安全设计：它拿到的流程图快照是只读事实，节点 id 必须来自快照；只有当你明确说“加 / 改”时才会输出改动指令（
flowchart-actions），且改动会先一句话说明再执行。
召 唤 vs 直接聊
| 方式 | 效果 |
|---|---|
| AI 面板左侧选中特工直接聊 | 特工只带“当前工作空间”的全局上下文 |
| 流程图控件上 右键 → 召唤AI特工 | 特工额外绑定该控件：能看到它的完整快照、可新增 / 修改节点，头像出现在画布上并跟随你选中的节点 |
召唤状态在右键菜单里有勾选标记；再次点击即“送走”特工（画布上的头像消失、读写能力解除）。多个流程图控件可各自召唤不同特工。
特工详情可调什么
AI 配置 → 特工页签：左侧特工列表，右侧详情。改动即时生效。
| 项目 | 说明 |
|---|---|
| 特工名称 / 角色名 | 列表名与身份名（如“资深高级工程师”），会影响 AI 自我介绍 |
| 说明 | 列表中的一句话简介，也是“召唤AI特工”菜单里的展示文案 |
| 模型 | 可绑定到某个固定模型；不绑则跟随 AI 面板当前选中模型 |
| 生成参数 | Temperature（0~1，越大越发散）、TopP |
| 欢迎语 | 新会话开场时 AI 先说的话 |
| System Prompt | 角色行为约束的核心，可整段编辑（克隆内置特工后改最稳妥） |
| 技能白名单 | 该特工允许调用的技能；见 技能与 ToolBank API |
| 工具权限开关 | 读剪贴板 / 读工作空间文件 / 收图（Vision）/ 使用技能 / 联网搜索 |
| 启用 / 设为默认 | 停用的特工不出现在列表与召唤菜单；默认特工是 AI 面板打开时的选择 |
工具权限开关的意义
| 开关 | 默认 | 风险提示 |
|---|---|---|
| 读剪贴板 ClipboardRead | 开 | 让 AI 知道“你刚复制了什么”。关掉后需手动把内容贴进对话 |
| 读工作空间文件 WorkspaceFileRead | 关 | 打开后 AI 可读工作空间内的文件内容（仍是只读） |
| 收图 Vision | 视特工 | 仅对支持视觉的模型有效 |
| 使用技能 UseSkills | 开 | 关闭后特工退化为纯聊天，不调用任何 ToolBank API |
| 联网搜索 WebSearch | 关 | 保持默认关闭，可避免 AI 编造与漫游 |
管理与默认
- 新增 / 复制 / 删除：从零定义，或复制内置特工改成自己的“专用助手”（例如复制代码审查员，改成只查 C# 与 WPF 规范）。
- 设为默认：多个特工时固定打开 AI 面板的默认特工。
- 内置特工由系统模板维护：删掉配置或升级后会自动重建；对内置条目的个性化建议用“复制”产生新条目来做，避免升级时被模板覆盖。
会话与多任务
- 每个特工可以开多个会话，会话按特工分组保存在本地（
Sessions\目录，见 模型接入与配置）。 - 会话可弹出为独立窗口：多点几个特工、多开几个窗口，相当于“一个团队并行干活”——让需求分析师在流程图窗口陪跑，让通用助理在旁边写文档。
- 特工在流程图上被召唤后的状态（空闲 / 忙碌 / 需要帮助 / 已完成）会反映在头像上：例如它正在解析你新加的节点时头像转圈，完成后归位。