検索メモリコンポーネントは、ワークフローのメモリストレージ（いわゆる「長期メモリ」）から関連情報を検索・取得するためのものです。ユーザーのクエリを受け取り、保存されたドキュメントやナレッジリソースを検索し、最も関連性の高いコンテンツを返します。これは、過去情報の参照や、補助ドキュメントの取得、コンテキスト認識型応答が必要なAIワークフローで特に有効です。
コンポーネントの役割
- 目的: ユーザー指定のクエリでワークフロー内の保存情報を検索し、関連性の高い情報ピースを返却します。
- 利用例: チャットボットやバーチャルアシスタントなど、過去のナレッジやドキュメントを参照して応答する必要があるAIプロセスに最適です。
主な特徴
- 柔軟な検索: 結果数や類似度しきい値、ドキュメントからの情報集約方法などを指定可能。
- 出力カスタマイズ: 結果に含めるコンテンツの種類（見出しや段落など）を制御できます。
- ツールとの連携: 取得したドキュメントはメッセージ形式、元データ、またはフロー内で利用するツールとして出力可能です。
設定項目
| 入力名 | 型 | 必須 | 説明 | デフォルト値 |
|---|
| タイトル | str | いいえ | 出力内ブロックのタイトル | 関連リソース |
| 結果数上限 | int | はい | 返す結果の件数 | 3 |
| ポインタから取得 | bool | はい | trueならドキュメント内で最も一致度の高いポイントから取得、falseなら全体を取得 | true |
| リソースを非表示 | bool | いいえ | trueで取得リソースを出力から非表示 | false |
| max_tokens | int | いいえ | 出力テキストの最大トークン数 | 3000 |
| strategy | str | はい | 集約戦略:「ドキュメントを連結して最初からトークン上限まで充填」または「各ドキュメントから均等に抜粋」 | 各ドキュメントから均等に抜粋 |
| threshold | float | いいえ | 取得結果の類似度しきい値（0～1） | 0.8 |
| tool_description | str | いいえ | エージェントが機能理解のために使う説明文 | （空） |
| tool_name | str | いいえ | エージェント用ツール名 | （空） |
| use_content | multi-select | いいえ | エクスポートするコンテンツタイプ（例：H1-H6, 段落） | すべて（H1-H6, 段落） |
| verbose | bool | いいえ | デバッグやインサイト用に詳細出力するか | false |
入力
| 入力名 | 型 | 必須 | 説明 | デフォルト値 |
|---|
| 参照キー | str | いいえ | 長期メモリ内の特定情報を探すためのキー | （空） |
| 入力クエリ | str | はい | メモリ検索に使用するクエリ | （空） |
出力
このコンポーネントは用途に合わせて複数の出力フォーマットを提供します。
- ドキュメント（メッセージ）: 取得情報をメッセージ形式で出力。会話フローへの統合に適しています。
- 生データ（ドキュメント）: 一致したドキュメントの未加工データ。解析やパースに利用可能です。
- ツール形式（ツール）: 検索結果をツール形式に整形し、複雑なエージェントワークフローの連携に活用できます。
| 出力名 | 型 | 説明 |
|---|
| documents | メッセージ | 取得した内容をメッセージとして出力 |
| documents_raw | ドキュメント | 未加工のドキュメント内容 |
| documents_as_tool | ツール | エージェント用ツール形式で出力 |
検索メモリを使う理由
- コンテキストAI: 過去のデータ参照で、AIの応答をより一貫性・情報重視に強化します。
- ナレッジ管理: 既存のドキュメントやユーザー提供情報を手動検索せずに活用できます。
- 高度なカスタマイズ: 検索戦略や出力形式をワークフロー要件に細かく調整可能。
利用シナリオ例
- 会話エージェント: 過去のやりとりやナレッジ断片を呼び出し、会話のコンテキストを維持。
- リサーチアシスタント: 大規模ナレッジベースから関連ドキュメントや抜粋をクエリで素早く抽出。
- 自動意思決定: 推奨やアクションの根拠となる情報を保存メモリから提示。
機能サマリ
| 機能 | 利点 |
|---|
| クエリベース検索 | 任意のユーザークエリに対して最適な保存情報を検索 |
| 出力オプション | メッセージ、生ドキュメント、ツール形式から選択可能 |
| カスタム検索 | 結果数・類似度しきい値・コンテンツ制御など柔軟に調整 |
| AI連携 | 動的なナレッジアクセスが必要なAIエージェントに最適 |
このコンポーネントは、メモリ検索・ドキュメント検索・コンテキスト強化が必要なあらゆるAIワークフローに活用できる多用途なビルディングブロックです。
