ワークフローで活用する(モデルレビュー編)
本ページでは、『Next Design のモデル情報』と『外部ファイルに定義したレビュー観点』を組み合わせ、AIエージェントによるモデルレビューと Excel への結果出力を自動化する方法を解説します。
本ページでは、ワークフロー、変数、ループ処理、ツール実行などの基本操作を理解していることを前提としています。
初めてワークフローを作成する場 合は、先にワークフローで活用する(基本編)を確認してください。
今回のゴール
Next Design のモデルを観点別にレビューするワークフローの構築方法を学び、以下のことができる状態を目指します。
- Next Design モデルやレビュー観点など、複数の情報を組み合わせた繰り返し処理を作成できる
- Next Design のモデル情報と外部ファイルの情報を、AIエージェントへの入力として利用できる
- AIエージェントの出力を整形し、外部へ出力できる
処理の流れ
本ページでは、以下の流れで解説します。
- モデルレビューに必要なツールとAIエージェントの準備
- 複数のモデルとレビュー観点を組み合わせてレビューするワークフローの作成
- 作成したワークフローの実行とレビュー結果の確認
事前準備
本ページのチュートリアルを実施するには、以下の環境が必要です。
| ツール | バージョン |
|---|---|
| Agentiqs | 1.1 以降 |
| Next Design | 4.0.14.50616 以降 |
また、本チュートリアルでは、 「サンプルデータ 」の以下のファイルを使用します。
C:\agentiqsSampleData\tutorial\next-design-integration\workflow-model-review\input
- 組込みソフト開発.nproj:レビュー対象の Next Design プロジェクト
- reviewPointList.json:レビュー観点
本チュートリアルと同じ操作を行う場合は、あらかじめサンプルデータの環境を構築してください。
1. 利用するツールと AIエージェントを準備する
ツ ールの作成
-
[ツール] -[新規作成] から、ワークフローで利用する以下のツールを追加します。
備考すでに対象のツールを作成している場合は、この手順は不要です。
ツール 用途 File Access レビュー観点ファイルの読み込みに利用します。 Next Design AIエージェントで Next Design のモデル情報を取得するために利用します。 Next Design Functions ワークフローで Next Design を操作するために利用します。 Microsoft Excel レビュー指摘を Excel に出力する際に利用します。 -
File Access ツールのベースディレクトリにレビュー観点ファイルがあるフォルダを指定します。
サンプルデータを利用する場合は、C:\agentiqsSampleData\tutorialを指定してください。
AIエージェントの準備
-
[エージェント] - [新規作成]を実行し、エージェントギャラリーから『Next Design モデル編集』を選択します。
-
レビューエージェントの基本情報を設定します。

設定項目
設定項目 必須 設定内容 詳細説明 タイトル Next Designモデルレビューエージェント 後から判別できる、わかりやすい名前にしてください。 説明 Next Designの設計モデルを対象に、単一のレビュー観点だけで
記載不足・矛盾・不整合・不明確さを判定し、結果をJSON配列のみで返すレビュー専用エージェントです。システムプロンプト 〇 下記「システムプロンプトの設定内容」を記載してください。 レビューに必要な情報を設定 -
システムプロンプトの設定内容(テキスト欄右上の「□」をクリックしてコピーしてください。)
システムプロンプトを変更する場合出力項目のキー名を変更すると、後続のExcel出力処理も変更する必要があります。
プロンプトを修正する場合、合わせて後続のワークフローも修正してください。
あなたは設計書レビュー専用エージェントである。入力された「Next Designの設計モデルの内容」と「単一のレビュー観点」に対してレビューを実施し、結果をJSON配列のみで出力すること。【入力】- review_point: レビュー観点- target_model: レビュー対象のモデル情報【レビュー方針】- review_point のみを基準に判定し、それ以外の観点で指摘しない。- target_modelに記載された事実のみを根拠に判断し、推測しない。- 問題の有無は target_model内の記述に基づいて判定する。- 該当箇所が見当たらない場合も、その事実を根拠に結果を出力する。- 同一内容の重複指摘はしない。【出力ルール】- 出力はJSON配列のみとする。- 各要素は以下のキーを必ず含むこと。- "location"- "description"- "viewPoint"- "priority"- "status"- キー名は固定とし、値はすべて文字列とする。- JSON以外の文字は出力しない。【各項目】- "location": 指摘箇所を特定する情報として、対象モデルのパス情報とフィールド名。パス情報は入力で渡されたモデル(target_model)からのパスとすること。IDなど人が見てもわからないものは記載しない。- 例:target_model = "目標車速演算"で、その配下の"目標車速設定/タップアップ"モデルの識別子フィールドに指摘がある場合、下記の出力となる。"モデル:目標車速演算/目標車速設定/タップアップフィールド:識別子"- "description": 指摘内容を記載する。何が不足・不整合・不明確かを明示する。指摘はですます調で統一し、読みやすいように改行をいれること。指摘がない場合は「<指摘なし> 確認済み・問題なし」とする。- "viewPoint": 入力のreview_pointのTitleを設定する。- "priority": "高" / "中" / "低" のいずれかのみ。- "status": 指摘ありは "Open"、指摘なしは "Closed"。【判定ルール】- review_point に照らして、記載不足、矛盾、不整合、不明確さ、不備が確認できる場合は指摘ありとする。- review_point に照らして問題が確認できない場合は"<指摘なし>"を出力する。- 判定に必要な情報が不足している場合は指摘ありとし、不足内容をdescriptionに具体的に記載する。【出力件数】- review_point に対して複数の独立した問題がある場合は複数件出力すること。- 問題が1件もない場合でも、"<指摘なし>"を1件出力すること。【禁止事項】- review_point 以外の観点での評価- 根拠のない推測- 抽象的すぎる指摘- 同じ意味の重複指摘- キー不足、表記ゆれ、JSON以外の出力 -
2. ワークフローを作成する
本ワークフローは、以下の構成にすることで Next Designで選択したコンポーネント配下のソフトウェアユニットを、『AIエージェントがレビュー観点ごとにレビュー』し、『レビュー結果を整形してExcelに一覧を出力』します。