matlab/simulink-agentic-toolkit

The Simulink Agentic Toolkit gives your AI agent both the tools and the expertise to work effectively with Simulink and Model-Based Design.

Simulink Agentic Toolkit とは

Simulink Agentic Toolkit は、大規模言語モデル(LLM)ベースのコーディングエージェント(Claude Code、GitHub Copilot、OpenAI Codex、Gemini CLI、Sourcegraph Amp など)がSimulinkモデルと直接やり取りできるようにするMATLABベースのアドオンです。これは次の方法で実現されます:

  1. MATLAB MCP(Model-Context-Protocol)サーバーの実行 – MATLAB/Simulink関数をエージェントが呼び出せる「ツール」として公開する小さなブリッジ。
  2. 「スキル」カタログの提供 – モデルベースデザインのベストプラクティス(構築、テスト、要件、コード生成など)をエンコードした、再利用可能なドメイン固有のプロンプト。
  3. インストーラーのパッケージング – MCPサーバーを自動設定し、選択したエージェントにスキルを登録し、MATLABパスを構成する。

つまり、このツールキットはLLMに、人間のエンジニアと同じようにSimulinkモデルを読み取り、編集、クエリ、テスト、検証するための知識(スキル)と能力(MCPツール)を与えます。


主な機能

機能 エージェントに与えるもの 重要な理由
MCPツール model_read、model_edit、model_test、model_check、model_query_params など 手動スクリプトなしで、ライブのSimulinkセッション内で具体的なアクションをエージェントが実行できるようにします。
スキルカタログ コアMBD、システムエンジニアリング、検証、シミュレーション、制御、コード生成、リアルタイムテストなどをカバーする12以上のスキルグループ。 MISRAチェック、Gherkinスタイルテストなどの業界標準ワークフローをエンコードし、エージェントが幻覚を起こさずベストプラクティスに従うようにします。
自動インストーラー(agenticToolkitInstaller.mltbx) MCPサーバー、ツールボックスのパス、スキル登録のワンクリックセットアップ。アンインストール/更新もサポート。 エンジニアがエージェント支援型モデリングを試すための障壁を低くします。
クロスエージェントサポート Claude Code、Copilot、Codex、Gemini CLI、Sourcegraph Amp と連携(すべて検証済み)。 チームが好みのLLMコーディングアシスタントを柔軟に使用できます。
カスタムライブラリインデックス satk.Configuration.setCustomLibraries がユーザー定義のSimulinkブロックライブラリからナレッジベースを構築。 エージェントが独自ブロックを理解し、生成モデルで再利用できるようにします。
セキュリティファースト設計 ツール呼び出しの人間によるレビューが必要。MCP仕様にはユーザーインタラクションとセキュリティガイドラインが含まれます。 重要なモデルへの偶発的な破壊的変更を防ぎます。

典型的なワークフロー

  1. 提供された .mltbx インストーラーでツールキットをインストールします(またはMCPサーバーを手動でセットアップ)。
  2. setupAgenticToolkit("install") を実行します。これにより、以下が行われます:
    • MCPサーバーバイナリをインストール。
    • MATLABのパスにツールキットを追加。
    • 選択したLLMエージェントにスキルカタログを登録。
  3. SimulinkをロードしたMATLABセッションを開始し、satk_initialize を呼び出します(セッションごとに1回)。これによりセッションがMCPサーバーと共有されます。
  4. LLMにタスクを依頼します。例:
    "プラントモデルにPIDコントローラーを追加して、Kp、Ki、Kdを調整してください。"
    
    エージェントは適切なスキルを読み取り、MCPを介して model_edit(ブロック追加、パラメータ設定)と model_test(Gherkinテスト実行)を呼び出します。
  5. 結果を検証します – ツールキットは診断、モデル階層、シミュレーション出力を人間がレビューできるように表示します。

誰が使うべきか?

対象者 利点
制御/メカトロニクスエンジニア プロトタイプの反復が高速化。LLMが高レベルの仕様に基づいてコントローラーブロックを生成または変更可能。
システムエンジニア スキルによるSystem Composerアーキテクチャ更新と要件トレーサビリティの自動化。
検証チーム Gherkinスタイルのテストハーネスを生成し、Model Advisorチェックを実行し、コンプライアンスレポートを自動生成。
ツール開発者/研究者 LLM駆動のモデルベースデザインの具体例。スキルカタログを拡張したり、新しいエージェントを試したりできます。

制限と考慮事項

  • MATLAB R2023a以降とSimulink が必要です。オープンソースのOctave環境では動作しません。
  • 一部のツール(例:model_test)にはSimulink Testなどの追加のMathWorks製品が必要です。
  • MCPサーバーはシングルユーザー使用のライセンスです。複数ユーザーでのサーバー共有はMathWorksライセンス違反です。
  • ツールキットは幻覚を防ぐよう努めていますが、人間による監視は依然として不可欠です。特に安全が重要なモデルでは重要です。

はじめに(クイックスタート)

% 1. アドオンをインストール(最初に.mltbxをダウンロード)
matlab.addons.toolbox.installToolbox('agenticToolkitInstaller.mltbx')

% 2. 自動セットアップを実行
setupAgenticToolkit('install')

% 3. 現在のMATLABセッションで初期化
satk_initialize

% 4. デモモデルを開いてエージェントに質問
openExample('simulink_general/sldemo_househeatExample')
% LLMチャットウィンドウで:
%   "現在開いているモデルの構造を説明してください。"

詳細情報

  • 完全なドキュメント – Configuration_and_Troubleshooting.md、skills-catalog/README.md。
  • ライセンス – LICENSE.md を参照(MathWorks独自ライセンス)。
  • バグ報告 – 組み込みの filing-bug-reports スキルを使用するか、GitHubでイシューを開いてください。
  • 研究プレビュー – slAgenticTaskExplorer は、エージェントが実行できるマルチステップタスクを紹介します。

TL;DR

Simulink Agentic Toolkit は、安全なMCPサーバーを介してLLMコーディングエージェントをMATLAB/Simulinkに接続し、エージェントがSimulinkモデルを安全に読み取り、編集、テスト、検証できるようにする豊富なツールとベストプラクティススキルを提供します。AI支援によるモデルベースデザインを求めるエンジニア向けの本格的でプロダクショングレードのアドオンです。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト