Web検索サーバーツール

最新情報や出典に基づく情報が必要な場合はphaseo:web_searchを使います。モデルが検索のタイミングとクエリを決め、1回のリクエスト中に複数回検索できます。 PhaseoはURL、タイトル、スニペット、ハイライト、必要に応じてページ本文をモデルに返し、根拠のある回答を作成できるようにします。

TinyFish Searchはオプションの管理検索エンジンとして利用できます。対応ルートでは、engine: "native"でプロバイダーのネイティブ検索も引き続き使えます。

仕組み

{ "type": "phaseo:web_search" }をtoolsに追加します。
モデルが検索の必要性を判断し、クエリを出力します。
Phaseoが設定された検索エンジンで検索を実行します。
検索結果がツールのコンテキストとしてモデルに返されます。
モデルが最終回答を作成し、必要であれば再度検索します。

クイックスタート

curl https://api.phaseo.app/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "openai/gpt-5-nano",
    "messages": [
      { "role": "user", "content": "What were the major AI announcements this week?" }
    ],
    "tools": [
      { "type": "phaseo:web_search" }
    ]
  }'

設定

{
  "type": "phaseo:web_search",
  "parameters": {
    "engine": "exa",
    "max_results": 5,
    "max_total_results": 15,
    "search_context_size": "medium",
    "max_characters": 2048,
    "allowed_domains": ["arxiv.org", "nature.com"],
    "excluded_domains": ["reddit.com"],
    "include_highlights": true,
    "include_text": false
  }
}

パラメーター	型	既定値	説明
`engine`	string	`exa`	検索エンジン：`auto`、`native`、`exa`、`parallel`、`firecrawl`、`perplexity`、`tinyfish`。
`max_results`	integer	`5`	1回の検索呼び出しで返される結果の最大数。
`max_total_results`	integer	`10`	サーバーツールループ全体で返される結果の累積最大数。
`max_uses`	integer	`10`	サーバーツールループ全体での検索呼び出しの最大数。
`search_context_size`	string	`medium`	ハイライト量を調整できる検索エンジン向けのコンテキストサイズ: `low`、`medium`、`high`。
`max_characters`	integer	engine default	テキストを含める場合に、結果ごとに含まれるテキストの最大文字数。
`allowed_domains`	string[]	none	これらのドメインの結果のみを返します。エイリアス: `include_domains`。
`excluded_domains`	string[]	none	これらのドメインの結果を除外します。エイリアス: `exclude_domains`。
`include_highlights`	boolean	`true`	検索エンジンが提供するハイライトやスニペットがあれば含めます。
`include_text`	boolean	`false`	検索エンジンが対応している場合、結果のより詳細なテキストを含めます。
`user_location`	object	none	ローカライズ検索に対応する検索エンジン向けの任意の地域情報。
`language`	文字列	なし	`en`などのTinyFishの言語ヒント。
`page`	整数	`0`	`0`から`10`までのTinyFish結果ページ。

検索エンジンの選択

Engine	動作
`exa`	Exaの管理型検索。ゲートウェイのランタイムでPhaseoにExaが設定されている必要があります。
`auto`	設定済みの管理型デフォルトを使用します。現在はExaです。
`parallel`	設定されている場合はParallel検索を使います。
`firecrawl`	設定されている場合はFirecrawl検索を使います。
`perplexity`	設定されている場合、Perplexity公式のSearch APIを使います。順位付きの結果、`search_context_size`、`user_location.country`に基づく地域検索、許可または除外ドメインに対応しています。
`tinyfish`	`TINYFISH_API_KEY`が設定されている場合にTinyFish Searchを使います。多言語対応のページ分割されたランキング結果を提供し、`allowed_domains` / `excluded_domains`を検索演算子に変換します。ページ全文は提供しないため、より詳しい内容には`phaseo:web_fetch`を使ってください。
`native`	リクエストの形式が対応している場合、上流モデルを呼び出す前に、宣言をプロバイダー固有のネイティブWeb検索ツールへ変換します。

engine: "native"はツールの宣言内でのみ使用してください。モデルが出力済みのゲートウェイ検索呼び出し内でengine: "native"を指定すると、上流リクエストの送信前にネイティブツールを選択する必要があるため、Phaseoはツールエラーを返します。

TinyFish Search

Phaseo Gatewayの実行環境のシークレットにTINYFISH_API_KEYを設定してエンジンを有効にし、ツールのパラメーターで選択します。

{
  "type": "phaseo:web_search",
  "parameters": {
    "engine": "tinyfish",
    "language": "en",
    "page": 0,
    "max_results": 5,
    "allowed_domains": ["phaseo.app", "github.com"],
    "excluded_domains": ["reddit.com"]
  }
}

languageは言語のヒントを指定し、pageは0から10の結果ページを選択します。TinyFishは両方のドメインフィルターリストに対応し、Phaseoが検索演算子に変換します。結果にはURL、タイトル、抜粋・ハイライトが含まれます。モデルに詳しい本文が必要な場合はphaseo:web_fetchを使ってください。

ドメインの絞り込み

回答の情報源を指定した範囲に限定する場合は、allowed_domainsを使います。

{
  "type": "phaseo:web_search",
  "parameters": {
    "allowed_domains": ["phaseo.app", "github.com"]
  }
}

幅広いWeb検索は許可しつつ、特定のドメインを結果から除外する場合はexcluded_domainsを使います。 PerplexityとFirecrawlでは、1回の検索にallowed_domainsまたはexcluded_domainsのどちらかを指定でき、両方は指定できません。Perplexityは1リクエストあたり最大20件のドメインフィルターを受け付け、除外ドメインを拒否リスト形式に変換します。 TinyFishは両方の配列をクエリのsite:と-site:演算子に変換します。 TinyFish Searchは公開プランで無料のため、Phaseoはengine: "tinyfish"にプロバイダー利用料を追加しません。通常のPhaseoリクエスト料金とトークン料金は引き続き適用されます。

Responses API

同じツール形式を/v1/responsesでも使えます。

{
  "model": "openai/gpt-5-nano",
  "input": "Find the latest release notes for Phaseo.",
  "tools": [
    { "type": "phaseo:web_search", "parameters": { "max_results": 4 } }
  ]
}

使用量と料金

Web検索呼び出しでは次の値が増加します。

{
  "usage": {
    "server_tool_use": {
      "web_search_requests": 1,
      "web_search_results": 5,
      "web_search_extra_results": 0
    }
  }
}

管理型検索の料金にはserver_tool_web_search_requestsとserver_tool_web_search_extra_resultsを使用できます。プロバイダーのネイティブ検索では、モデルの料金カードで設定されている場合にnative_web_search_requestsを使用できます。

概要

モデルとルーティング

機能

連携

ワークスペースとアクセス

信頼性と運用

プラットフォームと研究

移行ガイド

コミュニティ

Web検索サーバーツール

仕組み

クイックスタート

設定

検索エンジンの選択

TinyFish Search

ドメインの絞り込み

Responses API

使用量と料金

関連ページ

​仕組み

​クイックスタート

​設定

​検索エンジンの選択

​TinyFish Search

​ドメインの絞り込み

​Responses API

​使用量と料金

​関連ページ

仕組み

クイックスタート

設定

検索エンジンの選択

TinyFish Search

ドメインの絞り込み

Responses API

使用量と料金

関連ページ