10分钟上手Simulink Agentic Toolkit:三步安装并连接你的AI智能体

原创2026-10-13 21:42:211,953 阅读
文章标签:AI 技能AI 插件MCP 服务人工智能

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")

安装器会自动完成以下工作:

  1. 下载并安装 MATLAB MCP Server(连接智能体与 MATLAB 的桥梁)
  2. 配置你的 AI 智能体(写入 MCP 配置、注册 Simulink 技能)
  3. 支持将智能体配置为仅当前项目或全局生效

各平台配置写入位置略有不同(如 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 一次完成三件事:

  1. 将工具箱的工具目录加入 MATLAB 路径
  2. 调用 shareMATLABSession,让 MCP Server 连接到当前 MATLAB 会话
  3. 运行 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)。

登录后查看全文
simulink-agentic-toolkit