Agentic 検索 · TypeSafe Jev 搭載

Agentic 検索 API:より正確な結果で、エージェントのトークンの無駄を削減

POST /ask に自然言語のリクエストを 1 つ送るだけ。判断モデルがエンジンと期間を選び、全結果を採点し、無関係な結果と重複をエージェントに渡す前に除外します。現在の判断モデルは TypeSafe Jev です。

エンドポイント
POST https://api.search1api.com/ask
この API で得られるもの

自然言語のリクエストを 1 つ送ると、テーマに合った重複のないソースが返り、エージェントが読む量とトークンを削減できます。エンジン選択と全結果の採点は判断モデル(現在は TypeSafe Jev)が担当します。

1
AI による意図理解

検索クエリと期間をリクエストから判断。

2
エンジン自動ルーティング

対応エンジンから最大 5 つを選んで並列検索。

3
AI リランキング

全結果を採点し、無関係な結果を除外。

活用例

LLM エージェントのツール / RAG 検索 / コミュニティ調査

エージェントが読むのはテーマに合った結果だけ

一般的な検索ツールは、合っているかどうかに関わらず各エンジンの上位結果を返し、エージェントはそのすべてをトークンを使って読みます。エンジンを変えて何度も検索することも珍しくありません。Ask はその判断を 1 回の呼び出しの中で行います。「今月 Bun 1.3 について開発者は何と言っているか」は通常 1 か月の期間で Hacker News、Reddit、X と一般の Web 検索エンジンへ、「投機的デコーディングの最新論文」は arXiv へルーティングされます。その後すべての結果をリクエストに照らして採点し、0.5 未満を除外、エンジン間の重複を統合するため、LLM に渡すコンテキストは短く、テーマに沿ったものになります。

AI による意図理解

判断モデルがリクエストを読み取り、検索キーワードと期間を決めます。

エンジン自動ルーティング

モデルが Google、Reddit、Hacker News、GitHub、arXiv、X、YouTube などの対応エンジンを評価し、最大 5 つを並列で検索します。

AI リランキング

モデルがすべての結果の関連度を採点。0.5 未満の結果を除外し、重複をまとめ、各結果にスコアを残します。

一律 5 クレジット(モデル込み)

完了したリクエストは検索したエンジン数に関わらず 5 クレジット。どのエンジンも完了しなかった場合は課金されません。

判断モデルとは?Agentic 検索に必要な理由

判断モデルはテキストを生成しません。「はい/いいえ」「この中から 1 つ選ぶ」「どれだけ当てはまるか」といった型付きの質問に、較正済みの確率で答えます。うまく検索することは、まさにこうした判断の連続です。Ask はリクエストごとに判断モデルへ質問します。ユーザーの意図に最も合う検索クエリはどれか(IMDb のようなカタログ向けには正確なタイトルも)、対応エンジンそれぞれがリクエストにどれだけ合うか、期間の指定が含まれるか。これらの答えが意図理解とエンジンのルーティングを決めます。検索後には、返ってきた各結果が求められたテーマに関するものかをモデルに尋ね、その確率がリランキングと除外に使う関連度スコアになります。モデルは文章ではなく判断を返すため、Ask が独自に回答文を書くことはありません。Ask は現在、TypeSafe AI の System One モデル Jev を TypeSafe の API 経由で利用し(障害時は Cloudflare Workers AI 上の同じモデルに切り替え)、対応する判断モデルを順次拡大しています。Ask は TypeSafe の公式製品ではなく Search1API の製品です。

Agentic 検索の料金

Ask は完了したリクエストごとに一律 5 クレジットで、検索したエンジンが 1 つでも 5 つでも同じです。判断モデルの呼び出し費用も含まれます。一部のエンジンが失敗して他が完了した場合は errors に失敗が記録され、課金されます。どのエンジンも完了しなかった場合は 502 を返し、課金されません。新規アカウントには 100 無料クレジットが付与され、Ask を 20 回実行できます。

1 リクエスト一律 5 クレジット(モデル呼び出し込み)。

どのエンジンも完了しなかった場合(HTTP 502)は課金なし。

登録時 100 無料クレジット — クレジットカード不要で Ask を 20 回。

API キーが必要。アカウントあたり毎分 30 リクエストまで。

実装の流れ

Agentic 検索リクエストの流れ

POST /ask に自然言語のリクエストを 1 つ送るだけ。判断モデルがエンジンと期間を選び、全結果を採点し、無関係な結果と重複をエージェントに渡す前に除外します。現在の判断モデルは TypeSafe Jev です。

1

意図理解:判断モデルが検索クエリを選び、各エンジンの適合度を採点し、期間を判断します。「Reddit で」「今週」のようにリクエストにプラットフォームや時間を書くと、その判断に反映されます。

2

並列検索:Google や DuckDuckGo から Reddit、GitHub、arXiv、YouTube まで、最大 5 つのエンジンを同時に検索します。

3

AI リランキング:モデルが全結果を採点し、0.5 未満を除外、重複を統合して関連度順に並べます。

主な用途

Agentic 検索 API:判断モデル(現在は TypeSafe Jev)がエンジンを選び、全結果を採点して無関係な結果と重複を除外。エージェントが読む量とトークンを削減します

トークン予算のある LLM エージェント。1 回のツール呼び出しで、複数ページの生の結果ではなく、リランキング済みで引用できるソースを受け取れます。

結果の量より、適切なソースを選ぶことが重要な RAG 検索。

質問ごとに適したソースが変わる、Reddit、Hacker News、X、GitHub、arXiv の調査やモニタリング。

FAQ

Agentic 検索とは何ですか?

検索の判断をコードではなくモデルに任せる検索です。自然言語でリクエストを送ると、モデルがキーワード、検索するエンジン、期間を決め、どの結果を残すかを判断します。Ask はこれを 1 回の API 呼び出しで行います。多段階の調査ループではなく、1 回のルーティングとリランキングなので、レイテンシとコストが予測できます。

Ask はどのようにトークン消費を減らしますか?

3 つの方法です。エージェントはエンジンを 1 つずつ試す代わりに 1 回呼び出すだけで済み、関連度 0.5 未満の結果はレスポンスを返す前に除外され、エンジン間の重複は統合されます。各結果には relevance スコアが残るため、モデルに渡す前にさらに絞り込むこともできます。削減量はクエリによって異なり、レスポンスは最大 10 件で、それより少ない、または 0 件になることもあります。

Ask はどの判断モデルを使っていますか?

現在は TypeSafe の Jev を TypeSafe の API 経由で使い、Cloudflare Workers AI 上の同じモデルをフォールバックにしています。対応する判断モデルは順次拡大しています。

Ask はどのように検索意図を理解しますか?

Ask は判断モデルに、どの検索クエリが最適か、各エンジンが役立つ確率、期間の指定が含まれるかといった型付きの質問をします。エンジンはその確率に基づいて最大 5 つ選ばれます。レスポンスの intent で、実際に使われたキーワード・エンジン・期間を確認できます。

Ask はどのように結果をリランキングしますか?

判断モデルが各結果について、リクエストのテーマに関するものかを 0〜1 で採点します。0.5 未満は除外し、エンジン間の重複を統合し、残りをスコア順に並べます。各結果には relevance スコアが残るため、より厳しい基準で絞り込むこともできます。スコアはモデルの判断であり、事実確認ではありません。

Search ではなく Ask を使うべきなのはどんなときですか?

探したいものは分かっているが、どこを探すべきか分からないときは Ask を使います。エンジンとキーワードが決まっていて、そのエンジン自体のランキング、フィルター、ページング、Deep Search の本文が必要なときは Search を使います。

Agentic 検索 API のクレジット消費は?

完了した Ask リクエストは、検索したエンジン数に関わらず一律 5 クレジットで、判断モデルの呼び出しも含まれます。どのエンジンも完了しなかった場合は 502 を返し、課金されません。

Ask は回答文を生成しますか?

いいえ。Ask はタイトル・URL・スニペット・関連度スコア付きのリランキング済み結果を返し、自分の LLM で読んで引用できるようにします。要約や回答は生成しません。

Ask は判断モデルにどのデータを送りますか?

意図理解と採点のため、リクエストと、返ってきた結果のタイトルとスニペットを Jev モデルに送ります(TypeSafe の API 経由、障害時は Cloudflare Workers AI 経由)。検索そのものは Search1API が実行します。

SDK や MCP から Ask を使えますか?

まだ使えません。API キーを使って HTTP で POST /ask を呼び出してください。公式 SDK、CLI、MCP サーバーは Ask に未対応で、従量決済(pay-per-request)にも対応していません。