Web検索
Web検索は、最新の公開情報向けにweb_searchを公開します。有効なカスタムバックエンドがなければ、キー不要のDuckDuckGo HTML検索を使います。カスタムバックエンドを選び、保存前の設定をテストして会話用に有効化できます。
Dashboardで設定する
Dashboard → Tools → Web Searchを開きます。
- プロバイダーを選びます。
- 必要ならAPIキーを入力します。
- エンドポイントを確認または入力します。
- Testを選びます。
- 結果が意図したバックエンドと一致することを確認してから保存します。
テストは実際の検索要求を行います。プロバイダーの利用枠や料金が発生する場合があります。
CLIでも設定できます。
anyy tools websearch
対応バックエンド
設定カタログでは次を選べます。
| 選択肢 | web_search.provider |
|---|---|
| Firecrawl Cloud / Self-hosted Firecrawl | firecrawl（エンドポイントで区別） |
| Exa / Parallel / Tavily / SearXNG | exa / parallel / tavily / searxng |
| Brave Search Free Tier / Brave Search | brave-free / brave |
| Perplexity / Gemini Search / xAI Grok Search | perplexity / gemini / grok |
これは実装済みアダプターの範囲であり、全外部アカウント、プラン、ネットワーク条件の検証ではありません。Gemini/Grok検索バックエンドは会話モデルのプロトコルとは別で、ネイティブ会話APIは追加しません。
クラウドサービスは通常キーが必要です。セルフホストのFirecrawlとSearXNGには絶対HTTP／HTTPSエンドポイントが必要です。対応キーはconfig.yamlに値を入れず、Profileのシークレット参照として保存します。
Tavilyの選択肢
Tavilyには追加の4設定があります。
| 設定 | 値 |
|---|---|
| 検索深度 | basicまたはadvanced |
| 最大結果数 | 1～20、既定10 |
| 画像を含める | 真偽値、既定false |
| 生コンテンツを含める | 真偽値、既定false |
advanced検索はプロバイダーの資源を多く使う場合があります。Profileキーはsearch_depth、max_results、include_images、include_raw_contentで、web_search.options下に置きます。他のバックエンドはこれらTavily専用設定を拒否します。max_resultsはTavilyへの要求を制御しますが、モデルツールのlimitは1～10で、返される結果を引き続き制限します。画像を含めてもチャット内の画像表示は保証されません。
検索を使う
最新の事実を尋ね、リンクが必要か伝えます。
Find the latest stable release of this library, summarize the changes, and include links to primary sources.
Anyyは検索ツールが必要な場面を判断し、設定バックエンドが返すものだけを返します。検索は候補ソースを見つけるもので、信頼できないページに権威を与えるものではありません。
技術、法律、医療、金融の質問では一次資料や公式資料を明示的に求め、重要な結論は自分でも確認してください。
プロバイダーの無効化と変更
Dashboard → Tools → Web Searchのスイッチでカスタムバックエンドを有効／無効にします。web_search.enabled: falseまたはプロバイダー未設定では、web_searchは既定のDuckDuckGoを使います。ネットワークを無効化するものではありません。会話から検索を除くには、ツール選択でweb_searchを除外します。web_fetchとweb_extractは独立したツールです。
切り替え時には新しい認証情報を入力して再テストします。別エンドポイントや別オプションには以前の検証を再利用しません。有効なカスタムバックエンドが失敗しても、黙って既定検索には切り替えません。既定DuckDuckGoが自動操作対策のチャレンジを返す場合、Anyyはそれを検索結果とせず検索不可を報告します。
トラブルシューティング
| 症状 | 確認する項目 |
|---|---|
| テストが認証失敗 | キーを置換し、製品／プランへのアクセスを確認 |
| セルフホストに到達できない | Gatewayホストから到達可能な絶対URLを使用 |
| テストで動くがチャットでは動かない | カスタムバックエンドが有効で、会話にweb_searchが公開されているか |
| 無効化してもDuckDuckGoへ接続する | スイッチはカスタムバックエンド用。会話ツールからweb_searchを除外 |
| Tavily設定が拒否される | basic／advanced、結果数1～20を使用 |
| 結果が弱い／古い | 検索語を改善し、一次資料を指定するか適したバックエンドを選択 |