レビュー指摘から観点抽出
概要
過去のプロジェクトで蓄積された複数のExcel形式のレビュー指摘一覧ファイルを入力とし、
レビュー指摘の内容を分析し、レビュー観点リストを生成するサンプルです。
個別のレビュー指摘から、確認すべきポイントを抽出・整理し、重複を排除したうえで、再利用しやすいレビュー観点リストとして一覧化します。
- 本サンプルでは、ファイル列挙、指摘抽出、観点生成、観点統合といった処理をワークフローとして分解して実行します。
これにより、ツール連携とAIエージェントを組み合わせながら、大量のレビュー指摘を段階的に処理する流れを体験できます。 - 属人的・暗黙知になりやすいレビュー観点の標準化を通じて、開発における知見の再利用や属人化の低減にAIを活用する流れの体験を目的としています。
このサンプルでできること
- 指定フォルダ内の複数のExcelファイルを対象に分析を行う
- 各レビュー指摘から、AIエ ージェントを活用してレビュー観点を抽出する
- 複数ファイル・複数指摘にまたがるレビュー観点を集約し、重複を排除する
- 抽出したレビュー観点を一覧化し、再利用しやすい形で整理する
- どのレビュー指摘からどのレビュー観点が生成されたかのトレース情報を確認する
- ワークフローにより、ツール連携やAIエージェント呼び出しなどの複数の処理を組み合わせ実行する
想定ユーザ
このサンプルは、主に以下のような方を想定しています。
- 過去のレビュー指摘を活用してレビュー観点を整備したい
- レビュー観点の標準化や属人化の低減により、レビュー品質を底上げしたい
- ワークフローを用いた繰り返し実行を体験したい
同梱内容
このサンプルには、例として以下のデータが含まれています。
| 種別 | 内容 |
|---|---|
| ワークフロー定義 | レビュー観点抽出.yaml |
| エージェント定義 | レビュー指摘から観点抽出.yaml |
| 入力：レビュー指摘一覧ファイル | inputData/レビュー指摘一覧のExcelファイル群 |
| ドキュメント | 本README |
サンプルデータの利用
前提条件
- 分析対象となるレビュー指摘一覧のExcelファイルが所定のフォルダに配置されていること
- レビュー指摘の内容が、レビュー観点の抽出に必要な情報を含んでいること
入出力
- 入力：inputDataフォルダ内のExcel形式のレビュー指摘一覧ファイル（複数）
- 出力：レビュー観点リスト、レビュー指摘とレビュー観点のトレース情報
作業手順
- DC Agentiqsのワークフロー画面で「レビュー観点抽出」をクリックします。
- レビュー観点抽出の画面で、実行をクリックします。
- ダイアログが表示されるため、「レビュー指摘一 覧ファイルパス」を入力し、「実行」をクリックします。
- ワークフローの完了後、outputDataフォルダに「reviewPointList.md」ファイルが出力されます。
動作対象
- ワークフロー：レビュー観点抽出
- エージェント：レビュー指摘から観点抽出
制約事項
- 生成されるレビュー観点は、入力されたレビュー指摘一覧の内容や記載粒度に依存します。
- レビュー指摘の記述が曖昧な場合や文脈情報が不足している場合、適切なレビュー観点を抽出できないことがあります。
参考：ワークフロー実行の流れ
本サンプルでは、ワークフローを用いて処理をタスク分解し、ツールとAIを組み合わせて一連の処理を実行する構成を確認できます。
- 指定フォルダ内のExcelのレビュー指摘一覧ファイルを列挙する
- 各レビュー指摘一覧ファイルを読み込み、レビュー指摘を取得する
- 各レビュー指摘をレビュー観点作成エー ジェントに入力し、レビュー観点を抽出する
- 全件抽出完了後、LLMで統合・重複排除を行う
- 重複整理後のレビュー観点から観点リスト・トレース情報を作成する