AI 智能助手：入门
ToolBank 内置了一整套 AI 智能助手，无需离开软件即可完成问答、看图、代码审查、需求拆解等任务。它和普通聊天工具最大的区别是：AI 能"看见"你当前的工作空间——打开的程序、变量、正在调试的 Job、用户视图里的流程图——并在此基础上帮你分析问题、给出建议，在获得你明确许可后，还能直接替你修改流程图。
本文介绍整体能力与入口。模型如何接入见 模型接入与配置，四位内置特工见 内置特工，AI 能调用哪些平台能力见 技能与 ToolBank API。
能做什么：四类典型场景
| 想做的事 | 用哪个特工 | 举例 |
|---|---|---|
| 日常问答、总结、翻译、写文档 | 通用助理 | “把这段日志总结成 5 条要点”；“帮我写一份算子测试清单” |
| 审查你贴出的代码，给出可执行修改建议 | 代码审查员 | 把 C# / C++ / Python 片段贴进对话，按可读性 / 健壮性 / 性能 / 安全打分并改错 |
| 把截图 / 报错图 / 界面图发给 AI 让它"看" | 视觉分析助手 | 粘贴一张报错弹窗截图，让它按区域识别文字、控件位置和异常提示 |
| 对着流程图讨论需求，并直接增删改流程标签 | 需求分析师 | 在流程图上右键“召唤AI特工”→ 需求分析师，说“帮我加一个检查缺料的子任务” |
四个特工都在 设置 → AI 配置 中预置并默认启用，不需要任何配置就能先聊起来（只需先选好一个可用的模型）。
打开 AI 机器人
- 打开或新建一个工作空间（AI 依赖工作空间上下文）。
- 主菜单 视图 → AI 机器人，底部区域会出现 AI 机器人 面板。
- 左侧是特工与会话列表，右侧是对话区。发消息前，确认右上角当前选中的特工和模型。
┌──────────────────────────────────────────────────────────────┐
│ 视图 ▸ AI 机器人 [通用助理 ▾] [DeepSeek-V4-Pro ▾] │
├──────────────┬───────────────────────────────────────────────┤
│ 特工与会话 │ 你好，我是 ToolBank 通用助理… │
│ ┌─────────┐ │ ┌─────────────────────────────────────┐ │
│ │💬 通用助理│ │ │ 我：把这段日志总结成5条要点 │ │
│ │ · YOLO调参│ │ ├─────────────────────────────────────┤ │
│ │ · 测试清单│ │ │ AI：1. … 2. … 3. … │ │
│ ├─────────┤ │ │ （思考过程 / 流式输出 / 贴图） │ │
│ │💬 代码审查│ │ └─────────────────────────────────────┘ │
│ │💬 视觉分析│ │ 输入… [⏎ 发送] [📎] │ │
│ └─────────┘ │ │
└──────────────┴───────────────────────────────────────────────┘
（每个会话可右上角弹出为独立窗口，多特工并行）
布局要点
- 多会话：同一特工可以开多个会话（如“YOLO 调参”“流程梳理”），互不串味；会话记录自动保存在本地。
- 独立窗口：每个会话右上角可弹成独立窗口，把 AI 面板拖到第二块屏幕，边跑程序边问 AI；多特工可同时开多个独立窗口并行工作。
- 贴图：视觉分析助手（以及任何绑定视觉模型的特工）支持直接粘贴截图到输入框，一次可贴多张。
- 思考过程：使用支持思考模式的模型时，AI 的推理过程会以独立区块展示，方便你判断它“怎么想”的。
- 流式输出：回复逐字显示，长回答不用等全部生成完。
- 游标头像：需求分析师被召唤到流程图后，一个特工头像会跟随你当前选中的节点移动；忙碌 / 需要帮助 / 已完成时头像状态会变化。
AI 的三条模型通道
AI 引擎支持三种接入方式，在 设置 → AI 配置 中统一管理，所有特工共享同一份模型列表：
| 通道 | 说明 | 适合 |
|---|---|---|
| ToolBank 预置云端模型 | 开箱即用。软件内置了 DeepSeek-V4-Pro（思考型，适合复杂推理）与 DeepSeek-V4-Flash（快速，适合日常对话）两条模型，服务地址与密钥已由官方预填 | 不想折腾、追求开箱即用 |
| 自建云端模型 | 任何 OpenAI 兼容 的大模型服务：填服务地址 / 模型名 / API Key 即可，支持 DeepSeek、Kimi、通义、OpenAI、本地起的 vLLM 网关等 | 已有大模型账号、希望用自己的 Key |
| Ollama 本地模型 | 本机安装 Ollama 后自动检测，推荐 minicpm-v（能看图的端侧多模态）、qwen2.5、phi3、llama3.2 等，可一键拉取 | 离线环境、数据不出本机、隐私敏感 |
⚠️ 视觉分析助手需要视觉模型：让它“看图”时，请绑定支持图像输入的模型（如 ToolBank 云端模型或本地的 minicpm-v）。绑定纯文本模型的会话无法接收图片。
AI 能"看见"什么：上下文感知
与普通聊天不同，ToolBank 的 AI 每轮都会拿到一份上下文快照，包含：
- 当前工作空间的路径、名称、打开的程序文件；
- 当前程序包含哪些 Job、每个 Job 大致有多少算子（先理解程序结构再回答）；
- 你当前选中的元素（节点图上的节点、变量面板里的变量、鼠标聚焦的控件）；
- 用户视图里流程图控件的完整结构（节点树、连线、当前选中节点）。
因此你可以直接问“我这个程序里 Main 这个 Job 是干嘛的”“我选中的这个算子是做什么的”“这个流程图结构哪里不合理”，AI 不需要你手动复制粘贴上下文。
能动手改什么：AI 的权限边界
- 默认只读：AI 能“看”程序、变量、流程图，但不会自动改动你的程序文件或算子配置。
- 改流程图需你明确下令：需求分析师只有在你说“帮我在 xx 下加一个 yy”“把 xx 改成 yy”这类明确要求时，才会输出结构化改动指令（
flowchart-actions），由程序解析后应用到真实流程图——纯讨论阶段它不会改任何东西。 - 每类操作都走"技能白名单"：每个特工默认只被允许调用与自己职责相关的一组技能；你可以随时在 AI 配置中收紧。
- 运行 / 写变量是"执行"而非"编辑"：让 AI 跑一次 Job、读写变量属于执行类 API，需要你在 ToolBank API 面板中执行（详情见 技能与 ToolBank API）。
数据与隐私
- AI 配置（模型、特工、技能）保存在本机：
%LOCALAPPDATA%\ToolBank\AI\ai-config.json；会话记录在%LOCALAPPDATA%\ToolBank\AI\Sessions\。默认不上传任何聊天数据到云端，只有当你选用云端模型时，聊天内容才会按该模型的隐私政策发送给对应服务商；使用 Ollama 本地模型时全部数据停留在本机。 - 特工可以读取剪贴板（默认开启，便于“选中即问”），可在特工详情中关闭；是否允许读取工作空间文件、是否联网搜索都是独立开关。
下一步
- 第一次使用？先读 模型接入与配置，选好模型（推荐直接用预置云端模型）。
- 想深入了解四个特工的定位与调参，见 内置特工。
- 想知道 AI 到底能调用 ToolBank 的哪些能力、如何限制它，见 技能与 ToolBank API。
- 想看到具体玩法（改流程图、贴图问报错、审查代码），见 典型使用场景。