Skip to main content

​
Tavily

ShanoneのTavily連携では、AIによる利用に最適化されたWeb検索・コンテンツ取得のための5つのツールをエージェントに提供します。検索結果は生のHTMLではなく、LLMが扱いやすい形にあらかじめ整形・ランキングされています。

​
はじめに

1

TavilyのAPIキーを取得

tavily.com でサインアップし、TavilyダッシュボードからAPIキーを取得します。
2

Shanoneで接続

エージェントにTavilyでのWeb検索を依頼するか、ShanoneダッシュボードのインテグレーションからAPIキーを事前に登録します。
3

再度リクエスト

キーが保存されると、tavily_* ツールに対する shanone_execute_tool の呼び出しが成功するようになります。
TavilyはOAuthではなくAPIキー認証を使用します。アカウントにキーが接続されていない場合、設定によってはサーバー側の共有キーにフォールバックすることがあります。tavily_* の呼び出しの挙動が想定と異なる場合は管理者に確認してください。

​
利用可能なツール

Shanoneでは、Tavily向けに5つのツールを提供しています。
tavily_search — 検索の深さ・トピックフィルタ・件数などを指定できる、AI最適化されたWeb検索
tavily_extract — 1つ以上のURLからクリーンで構造化されたコンテンツを抽出
tavily_crawl — 起点となるURLから再帰的にサイトをクロール
tavily_map — コンテンツ全体を抽出せずに、サイトのURL構造を把握
tavily_research — 検索と抽出を組み合わせた複数ステップのエージェント型リサーチで、1つの統合された回答を生成

​
よくある使い方

競合調査

比較資料のために、競合サイトの料金・機能ページを検索・抽出

ファクトチェック

ドラフト中の主張を裏付ける情報源をWeb検索で確認

サイト構造の把握

クロール対象のページを決める前に、ドキュメントサイトの構造をマッピング

深いリサーチレポート

tavily_research を使って、オープンな質問に対する出典付きの統合レポートを生成

​
トラブルシューティング

クエリを絞り込み、ツールのスキーマが対応していれば topic（例: "news"）や time_range を明示的に指定してください。shanone_get_tool_schema で tavily_search の利用可能なフィルタを確認できます。
大規模なサイトのクロールは1回の呼び出しとしては時間がかかりすぎることがあります。起点URLをより狭く絞る、深さ・件数の上限パラメータを下げる、あるいは先に tavily_map でクロール対象を計画してください。
TavilyのAPIキーが未設定・無効、またはプランのリクエスト上限に達しています。Shanoneダッシュボードのインテグレーションで、Tavilyアカウント側のキーと一致しているか確認してください。