ウェブ検索

エージェントが質問に答えたりタスクを完了したりするために情報を調べる必要がある場合は、ウェブ検索を使います。

使用例：火星が赤く見える理由の説明

次の JSON リクエストボディを POST /v1/agents/sessions に送信すると、セッションが作成され、回答がストリーミングされます。この例では、ウェブ検索を live モードで有効にしています。

12345678910{
  "agent": {
    "model": "gpt-6-astra",
    "reasoning": { "effort": "low" },
    "tools": [{ "type": "web_search", "mode": "live" }]
  },
  "environment": { "type": "none" },
  "input": "Search NASA's website for why Mars looks red. Explain it in two sentences and include a source link.",
  "stream": true
}

実行結果

2026 年 9 月 10 日のテストでは、エージェントが NASA のウェブサイトを検索し、次の回答をストリーミングしました。

火星が赤く見えるのは、土壌に含まれる鉄分が酸化してさび、地表が赤みを帯びるためです。NASA の火星解説ページによると、このさび色の見た目から、火星は「赤い惑星」と呼ばれています。

これはテスト時に記録した回答例です。実行時の回答は異なる場合があります。

web_search を agent.tools に含めない場合、組み込みのウェブ検索は無効です。プロンプトで検索を指示しても有効にはなりません。

検索モード

• live（デフォルト）：検索時にインターネットに直接アクセスできます。web_search を指定し、mode を省略すると、このモードが使われます。
• cached：インターネットに直接アクセスせず、保存済みのウェブコンテンツを検索します。
• disabled：ツールを省略した場合と同様に、組み込みのウェブ検索を無効にします。

オプション設定

次のフィールドは、同じ web_search エントリに追加します。