10分钟上手Simulink Agentic Toolkit:三步安装并连接你的AI智能体
10分钟上手Simulink Agentic Toolkit:三步安装并连接你的AI智能体
Simulink Agentic Toolkit 是 MathWorks 推出的 AI 智能体工具箱,它为 AI 编码智能体(如 Claude Code、Copilot、Codex 等)提供读取、构建、编辑和测试 Simulink 模型所需的 MCP 工具与模型驱动设计(MBD)最佳实践技能,让智能体不再"凭空想象",而是像资深 Simulink 用户一样高效工作。本文是一份面向新手的快速上手指南,带你三步完成安装并连接你的 AI 智能体。
一、Simulink Agentic Toolkit 是什么?
在动手安装之前,先花 30 秒理解它的工作原理:
┌───────────┐ ┌───────────┐ ┌──────────┐
│ AI Agent │◄─MCP─►│MCP Server │◄─────►│ MATLAB / │
│ (Claude, │ │ (MATLAB │ │ Simulink │
│ Codex) │ │ MCP Core) │ └──────────┘
└───────────┘ └───────────┘
▲
│ 读取
┌─────┴─────┐
│ Skills │ (MBD 最佳实践知识)
└───────────┘
你的 AI 智能体通过 MCP(Model Context Protocol)协议与 MATLAB MCP Server 通信,由它连接运行中的 MATLAB 与 Simulink 会话;同时智能体还会读取工具箱内置的技能(Skills),获得领域知识。工具箱为此提供了两大能力:
- MCP 工具:覆盖模型的读取、编辑、查询、测试与检查
- 智能体技能:涵盖建模、仿真、测试、需求管理、合规检查、代码生成等 MBD 最佳实践
完整的工具与技能清单可参考 skills-catalog/README.md 和 README.md。
二、安装前准备:环境要求清单
请对照下表确认你的环境已就绪:
| 要求项 | 说明 |
|---|---|
| MATLAB | R2023a 或更高版本,并已安装 Simulink |
| AI 编码智能体 | Claude Code、GitHub Copilot、OpenAI Codex、Gemini CLI、Sourcegraph Amp 之一(自动安装均已验证支持) |
| Simulink Test | 可选,仅 model_test 工具需要 |
| 其他工具箱 | 部分技能依赖额外工具箱(如 System Composer、Simscape、Stateflow),可查阅各技能目录下的 manifest.yaml 中 requires-products 字段 |
💡 小提示:如果你同时想用 AI 智能体处理 MATLAB 脚本相关任务,建议一并安装 MATLAB Agentic Toolkit,自动安装流程可以一步到位装好两者。
三、三步安装:一键配置你的 AI 智能体
推荐路径是自动化安装,整个过程大约 10 分钟。
第 1 步:下载安装器
从项目 Releases 下载 agenticToolkitInstaller.mltbx 文件。若直接打开文件时 Add-On Manager 无法启动(常见于无界面服务器、企业代理或杀毒软件环境,可能提示 ERR_CERT_AUTHORITY_INVALID),可在 MATLAB 中用命令行方式安装:
matlab.addons.toolbox.installToolbox("agenticToolkitInstaller.mltbx")
第 2 步:运行一键安装
安装完成后,在 MATLAB 命令窗口执行:
setupAgenticToolkit("install")
安装器会自动完成以下工作:
- 下载并安装 MATLAB MCP Server(连接智能体与 MATLAB 的桥梁)
- 配置你的 AI 智能体(写入 MCP 配置、注册 Simulink 技能)
- 支持将智能体配置为仅当前项目或全局生效
各平台配置写入位置略有不同(如 Claude Code 写入 ~/.claude.json,Codex 写入 ~/.codex/config.toml),详细对照表见 Configuration_and_Troubleshooting.md。
第 3 步:在 MATLAB 会话中初始化工具箱
MCP Server 需要连接到一个正在运行的 MATLAB 会话。在每个 MATLAB 会话中执行:
addpath("~/.matlab/agentic-toolkits/simulink")
satk_initialize
Windows 下请将 addpath 参数改为:
addpath(fullfile(getenv('USERPROFILE'), '.matlab', 'agentic-toolkits', 'simulink'))
initialize 入口 satk_initialize.p 一次完成三件事:
- 将工具箱的工具目录加入 MATLAB 路径
- 调用
shareMATLABSession,让 MCP Server 连接到当前 MATLAB 会话 - 运行 validate_installation.p 校验安装是否完整
如需每个会话自动执行,可将上述命令写入 MATLAB 的 startup.m(README 中提供了带版本判断的完整代码块)。
四、验证安装:确认 AI 智能体已"通电"
安装完成后,建议从两端各验证一次:
MATLAB 端:satk_initialize 会自动触发 validate_installation.p 执行 6 项检查(MATLAB 版本、Simulink 许可、工具入口、包解析、MCP 服务器二进制、MCP 连通性),全部通过时显示 PASS,即代表 MCP 工具已就绪。
智能体端:
| 智能体 | 检查 MCP 工具 | 检查技能 |
|---|---|---|
| Claude Code | /mcp |
/skills |
| GitHub Copilot | VS Code 命令面板 MCP: List Servers |
聊天框 @ 提及 |
| OpenAI Codex | codex --list-tools |
检查 plugin.json 注册 |
你应该能看到 matlab MCP Server 及其工具(model_overview、model_read、model_edit、model_query_params、model_test 等),技能列表中则能看到 building-simulink-models、testing-simulink-models 等 MBD 技能。更详细的验证方法见 docs/faq.md。
五、快速体验:让智能体读懂你的第一个模型
打开一个 Simulink 示例模型:
openExample('simulink_general/sldemo_househeatExample')
然后对你的 AI 智能体说一句:
Describe the structure of the currently open model.(描述当前打开模型的结构)
智能体会调用 model_overview 工具,为你梳理模型的子系统层级、接口与主要组件连接方式。
安装完成后,你的智能体可直接调用 9 个 MCP 工具(完整定义见 tools/tools.json):
| 工具 | 智能体可以做什么 |
|---|---|
model_overview |
探索模型架构:子系统层级、接口、组件连接 |
model_read |
理解模型行为:模块结构、算法表达式、信号流 |
model_edit |
构建与修改模型:添加模块、连线、配置参数 |
model_check |
校验模型结构:未连接端口、悬空线等 |
model_read_diagnostics |
读取编译/仿真/代码生成后的诊断信息 |
model_test |
运行 Gherkin 测试(需 Simulink Test) |
model_query_params |
查询任意参数设置与求解器配置 |
model_resolve_params |
将工作区变量(如 Kp)解析为实际数值 |
model_scan |
不加载模型,直接正则搜索 .slx 文件内容 |
六、常见问题速查
遇到"卡壳"时,先查这张表,大多数问题都能 1 分钟解决:
| 问题 | 原因 | 解决方法 |
|---|---|---|
| 智能体看不到 Simulink 技能 | 技能未注册 | 重新运行 setupAgenticToolkit("configure") |
| MCP 工具报 "Undefined function" | 当前 MATLAB 会话未初始化 | 在 MATLAB 中运行 satk_initialize |
| MCP 服务器连不上 MATLAB | 连接器未运行或连接过期 | 再次运行 satk_initialize,必要时查看 MCP Server 日志 |
打开 .mltbx 报 ERR_CERT_AUTHORITY_INVALID |
企业代理/杀毒/无界面环境 | 改用 matlab.addons.toolbox.installToolbox(...) 程序化安装 |
model_test 不可用 |
未安装 Simulink Test | 安装 Simulink Test,其余 8 个工具不受影响 |
| macOS 拦截 MCP 服务器二进制 | Gatekeeper 隔离 | 右键"打开",或移除 quarantine 属性 |
完整故障排查清单见 Configuration_and_Troubleshooting.md 的 Troubleshooting 章节。
七、进阶操作:更新、卸载与库配置
| 操作 | 命令 |
|---|---|
| 更新工具箱 | 下载新版安装器后执行 setupAgenticToolkit("update") |
| 查看安装状态 | setupAgenticToolkit("status") |
| 卸载 | setupAgenticToolkit("uninstall")(可选择仅移除智能体配置) |
更新后记得重新运行 satk_initialize 并重启智能体会话。
此外,工具箱还内置了 Toolbox Library 知识库(位于 toolbox-kb/),覆盖 Simulink、Simscape、Aerospace Blockset 等上百个工具箱,可为智能体提供块级知识。可通过以下命令激活:
satk.Configuration.setLibrary('all') % 激活所有已安装工具箱的知识库
写在最后
至此,你已经完成了 Simulink Agentic Toolkit 的全部安装与验证工作:智能体拥有了操作 Simulink 模型的"双手"(MCP 工具)和资深工程师的"经验"(MBD 技能)。接下来,打开任意一个 Simulink 模型,试着让智能体帮你加一个子系统、修一个未连接端口,或者为模型写一组测试——10 分钟投资,换的是 AI 驱动建模工作流的长期回报。
⚠️ 安全提示:运行前请始终审查智能体的工具调用,重要操作保持"人类在环"(Human in the Loop)。