Exa Search 使い方:AI Flowi Workflowのエージェントツール
Exa Searchの使い方として、AI Flowi Workflowの検索・コンテンツ取得ツールキットの設定を説明します。直接検索結果の行を返すのではなく、Toolを返します。プロバイダーのキーとツールキットの制御を設定し、Agentに出力を接続する前にツール定義を確認してください。エクスポートされたExa Searchノードに検索語フィールドはありません。
このツールキットはカタログに記載されていますが、Ai Flowiによる本番環境での検証は行っていません。このページは、2026年10月9日にエクスポートしたAI Flowi Workflow 1.9.2のカタログに基づきます。ツールの準備と、実際のツール呼び出し・取得資料の確認を区別します。
執筆:Ai Flowi · 公開日
公式情報源:Exa ドキュメント
直接結果を返すノードではなく、ツールキットの仕様
Exaツールキットの表は、横にスクロールすると、小さな画面でも認証情報と出力の名前を読み取れます。
| コンポーネント / 識別子 | カタログの説明(原文に対応する訳) | このインターフェースの用途 |
|---|---|---|
Exa Searchexa.ExaSearch | 検索とコンテンツ取得用のExa Searchツールキット | 互換性のあるツール利用コンポーネント用に、プロバイダーのツールキットを用意します。 |
exa.ExaSearchで、コンポーネントカタログ内の目的のエントリを特定してください。既存のWeb Searchリファレンスは、検索語を直接渡すTableインターフェースを説明しています。そのインターフェースをExaにコピーすると、このツールキットには存在しない検索語入力とTable出力を作り上げることになります。
キー、検索件数、類似検索件数、autoprompt
| 入力 | 型 / 必須 | 接続可能な型 / 選択肢 | 設定の意味 |
|---|---|---|---|
metaphor_api_key | str / いいえ | 明示的に空のリスト | この正確な名前で提供されるプロバイダーの認証情報フィールドです。エクスポートでは任意とされていますが、匿名アクセスやキーの自動参照は記載されていません。 |
search_num_results | int / いいえ | 型はエクスポートされていません | 検索結果件数を示す名前の整数制御です。範囲、既定値、ツールごとの適用規則の記載はありません。 |
similar_num_results | int / いいえ | 型はエクスポートされていません | 類似検索結果件数を示す名前の独立した整数制御です。エクスポートには、類似検索ツールの引数は列挙されていません。 |
use_autoprompt | bool / いいえ | 型はエクスポートされていません | 真偽値のオプションです。カタログにはスイッチ名がありますが、書き換えの動作や既定値は説明されていません。 |
認証情報の名前は、エクスポートされたとおりにmetaphor_api_keyを保持してください。プロバイダーの表示名に合わせてフィールド名を変えると、このスナップショットにはない設定になります。必須フラグも注意して読む必要があります。任意というメタデータからは、認証情報が未指定の場合に、どこから補われるかは分からず、認証情報なしでプロバイダーを呼び出せるという証明にもなりません。
2つの結果件数の制御は、それぞれ記録してください。検索結果の設定だけでは、類似コンテンツ操作の結果件数は確認できず、どちらの整数もAgentの反復回数の上限を設定するものではありません。use_autopromptを試す際は、他の設定とタスクのテキストを固定し、複数の設定変更が比較に混ざらないようにしてください。
toolsポートが受け渡し地点です
| コンポーネントの識別子 | 表示ラベル | ポート名 | 型 |
|---|---|---|---|
exa.ExaSearch | ツール(Tools) | tools | Tool |
唯一の出力の名前はtools、表示名はTools、型はToolです。このエントリにJSON、Message、Tableの結果ポートはありません。Agentがツールキットを利用可能であることは、Agentがそれを選び、適切な引数を使い、有用なソース内容を受け取った証拠ではありません。
使用前に、ワークスペース内で生成されたツール名、説明、受け付ける引数を確認してください。カタログのエントリには、個別のツール一覧や検索語のスキーマはありません。したがって、ツールキットの説明だけから、特定の検索メソッド、類似検索の引数、コンテンツキー、応答の外側の構造を約束するのは早計です。
プロバイダーとモデルのアクセスを別々に用意します
エクスポートされたmetaphor_api_keyフィールドで認証情報を指定してください。認証情報の設定方法は接続ガイドを参照し、接続可能な型のリストが空だからといって変数読み込みの制御を想定せず、このフィールドで対応しているかを確認してください。
接続先のAgentについては、Agentの接続リファレンスと、そこからリンクされているモデルアクセスの手順に従ってください。
範囲を限定して確認するAgentの設定
設定例であり、実施したテストの記録ではありません
- Exa Searchを追加し、
metaphor_api_keyにご自身のプロバイダーキーを入力します。明示的な試行設定として、search_num_resultsを3、similar_num_resultsを2、use_autopromptをfalseにします。 - 生成されたツールキットの定義を確認します。予定するタスクに適したツールを特定し、期待する引数を確認してください。このページでは、推測した引数名は提供しません。
- Language Modelを追加し、必須の
modelとプロバイダーへのアクセスを設定します。そのmodel_outputを、Agentの必須のmodelに接続します。 - Exa Searchの
toolsをAgent.toolsに接続します。Agentのinput_valueをFind source material explaining workflow input validation and retain the source references.に設定します。 system_promptで、実際に確認したツール実行の証拠、ソース参照の保持、検索が失敗した場合の明示的な未解決結果を求めます。試行の上限としてmax_iterationsを2に設定します。完了や正確な呼び出し回数を主張するものではありません。Agent.responseをChat Outputのinput_valueに接続します。この入力はMessageを受け取ります。取得した内容の主張を受け入れる前に、実際のツールの動作と応答を確認してください。
意図する結果は、ご自身の実行で確認可能な検索の根拠を伴うAgentの応答です。検索したというAgentの文章だけでは不十分です。ツールの呼び出しが観測できない場合は、その欠如を記録し、生成テキストをExaの出力として扱わないでください。
ソースの品質より先にツールの引数を確認します
まず、選択されたツールがタスクに適していたか、観測した引数が意図した質問を反映しているかを確認します。その後、返された参照と内容を確認します。この順序により、ソース候補の品質が低い場合と、Agentが適切な検索質問をしていなかった場合を区別できます。
ツールキットの実際のインターフェースが分かるまで、検索と類似コンテンツの試行を分けてください。similar_num_resultsフィールドは、類似操作がどのソースを使うかを説明していません。実際の呼び出しを確認する際に、そのソースや引数を記録し、説明のない結果一覧を、記載済みの類似検索手順によるものだとみなさないでください。
関連情報:arXiv 論文検索 API:AI Flowi Workflow 連携。
関連情報:DuckDuckGo 検索 API:AI Flowi Workflowでの連携。
Exaツールキットの設定が適さない場合はいつですか?
エクスポートには、検索語のテキストボックス、日付フィルター、ドメイン許可リスト、コンテンツサイズの上限、タイムアウト、再試行フィールドはありません。autopromptの書き換え規則もありません。タスクにこれらの制御が必要な場合は、このノードが対応していると説明する前に、ツール定義と実際のプロバイダーの仕様を確認してください。
Agentによるツール選択より、検索語からTableへの決まった受け渡しが必要なワークフローでは、直接結果を返すコンポーネントを選んでください。Exaの出力を取得済みテキストとして扱ったり、Tableだけを受け取るフィールドに接続したりしないでください。互換性のあるTool接続は開始時の設定にすぎず、ツール実行、ソース確認、エラー処理は引き続き検証が必要です。
3種類の独立したツールキットの確認
比較を設定する前に、ツールキットの定義から可能な確認を判断してください。導入済みのExaエントリで公開されている呼び出し可能なツールの名前と、受け付ける引数を記録します。予定する操作に対応するツールが利用できない場合は、定義の段階でその演習を止めてください。search_num_resultsとsimilar_num_resultsという名前は別々の設定事項を示唆しますが、記載されていないツール名や引数スキーマを提供するものではありません。
検索の演習では、提案したAgent設定のドキュメント探索タスクから始めます。どのツールが選ばれ、公開されている場合にはどの検索語の引数が使われるかを観測します。その引数がワークフローの入力検証を尋ねているか、それともAgentが付け加えた、より広い話題を尋ねているかを確認してください。検索前にタスクが変更されていた場合は、返された候補を判断する前に、その変更を確認します。次に、選択した検索の制御と返された表現の関係を確認してください。ツールキット内のすべてのツールで上限が同じように適用されるとは限りません。
類似コンテンツの演習では、受け付ける引数の仕様に基づく起点が必要です。ソースアドレスを期待する場合は、確認できるアドレスを選び、そのソースが目的の主題を表す理由を説明してください。別のものを期待する場合は、その記載された形式を使います。similar_num_resultsを確認する間は起点を固定してください。不適切な起点に関連する結果一覧は、類似検索としては一貫していても、元の情報探索タスクを満たさないことがあります。起点と上限を同時に変えると、この違いが分からなくなります。
autopromptの演習では、タスク、使用するツール、関連する上限を同じに保ち、use_autopromptをfalseからtrueに変更します。観測可能なリクエスト変換があれば確認してください。変換が見えない場合は、スイッチは変更したが、書き換えられたリクエストは確認できなかったと報告します。候補が変わっただけでは書き換え規則を特定できません。同様に、候補が変わらなくても、スイッチが何もしなかったとは証明できません。エクスポートには、その結論と照合できる内部動作が記載されていません。
利用できないツール、観測されない実行、引数の不一致、不適切な取得内容は、それぞれ別の結果として保持してください。各結果は、ツールキットの受け渡しで調べるべき異なる箇所を示します。例えば、similar_num_resultsを下げても、誤った質問を渡す検索呼び出しは修正できません。これらの確認は、ツールキットがタスクに適するかを判断する根拠になりますが、Exaのベンチマークを示すものでも、直接行データだけが必要なワークフローにモデルの段階を追加するよう求めるものでもありません。
使用量と設定
ノードを1回実行するごとに1 Flowi Tokenを使用します。毎月の付与トークン数は、Goが5,000、Plusが10,000、Pro 100が50,000、Pro 200が100,000、Pro 500が250,000です。 デモを予約
連携一覧には、異なる受け渡し型を持つ検索エントリが掲載されています。