膨大な文書を横断して検索

概要

膨大なページ数のマイコンマニュアルをナレッジとして登録し、
開発に必要な情報をすばやく確認できるエージェントです。

ユーザがマイコンに関する疑問を自然文で質問すると、エージェントがマニュアルの内容をもとに、
以下の情報を提示します。

• 質問内容に対する要点
• マニュアル記載内容の解説
• 参照すべきマニュアルの箇所

マイコンマニュアルをナレッジとして活用し、AIとの対話を通じて必要な技術情報を
効率よく確認する流れを体験することを目的としています。

このサンプルでできること

• 特定機能の使い方をマイコンマニュアルから調べる
• レジスタ設定や初期化手順の概要を確認する
• 割り込み、通信、タイマ、DMA、GPIO などの仕様を素早く把握する
• 注意事項や制約条件を確認する
• 回答とあわせて、根拠となる参照箇所を確認する

想定ユーザ

このサンプルは、主に以下のような方を想定しています。

• 対象マイコンを扱う開発者
• 技術調査や仕様確認を効率化したいチーム
• 自社向けの技術問い合わせエージェントを作りたい管理者・推進担当者

同梱内容

このサンプルには、例として以下のようなデータが含まれています。
マイコンマニュアルは同梱されておらず、利用者が任意のものを用意してナレッジに登録します。

データ	ファイル名
エージェント定義	マイコンマニュアル情報検索.yaml
入力	マイコンマニュアル（inputData\マイコンマニュアル\ALX-312F64_Manual_Sample.pdf）
ドキュメント	本README

サンプルデータの利用

前提条件

• ナレッジに登録する対象のマイコンマニュアルを用意していること。

入出力

• マイコンマニュアル

作業手順

1. （初回のみ）マイコンマニュアルをナレッジとして登録します。
   • DC Agentiqsのナレッジ画面で、「新規作成」をクリックしてナレッジを作成します。
     • 概要：必要な項目を入力して、「保存」ボタンをクリックします。
     • データ：「データを追加」をクリックし、「ファイルを追加」または「フォルダを追加」から、対象のマイコンマニュアルファイルを登録します。
   • 読み込みが完了したら、ナレッジの作成は完了です。
   詳細な手順は「ナレッジを作成する」を参照ください
2. DC Agentiqsのエージェント画面で「マイコンマニュアル情報検索」にマウスを当て、「チャット開始」をクリックします。
3. DC Agentiqsのチャット画面で、右上の「ナレッジを選択」をクリックし、プルダウンメニューから作成したマイコンマニュアルのナレッジを選択します。
4. DC Agentiqsのチャット画面で質問を入力します。

動作対象

• エージェント：マイコンマニュアル情報検索

制約事項

• 回答内容は、ナレッジとして登録されたマイコンマニュアルの内容に依存します。
• 質問文の表現や詳細度によって、回答の内容・粒度・表現が変化する場合があります。

参考：質問例

チャット画面で入力する質問例を示します。

対象とするマイコンマニュアルの内容によって回答内容は変わります。

初期設定・使い始め

このマイコンでCANを立ち上げるときに、最初に確認したい質問です。

• CANを使い始めるときの初期化手順を教えてください。
• CANの初期化フローを図で示してください。
• CANの送信IDとデータ長はどこで設定しますか。
• CANで受信割り込みを有効にするには、何を設定すればよいですか。

送信・受信の基本確認

送受信処理を実装するときに、実際によく確認する質問です。

• CANの送信完了は何を見れば判断できますか。
• CANで受信データが来たかどうかは、どこで確認できますか。
• 受信したCANフレームのIDとデータ長は、どのレジスタで確認できますか。

割り込み・状態確認

動作確認やデバッグ時に役立つ質問です。

• CANの割り込み要因はどのレジスタで確認し、どうクリアしますか。
• CANエラー割り込みはチャネルごとにありますか？
• 受信FIFO割り込みと送受信FIFO受信完了割り込みは別物ですか？

マイコンマニュアルに記載されていない情報の確認

ナレッジに含まれない情報を質問したときの回答を確認するための質問です。

• 割り込み負荷とDMA負荷を比較して最適な構成を決めて
• この基板配線長ならサンプルポイントは何%がよい？