Grok ウェブ検索 (Web Search)¶

Grok モデルは、**Web Search ツール**を通じてインターネットにリアルタイムにアクセスし、ウェブページを検索して重要な情報を抽出し、最新のコンテンツを含む回答を提供することをサポートしています。

重要な注意点: - 当サイトのゲートウェイ は OpenAI 仕様と互換性のある /v1/chat/completions インターフェースを統一して採用しており、web_search_options フィールドを通じて Grok を含む各モデルのネットワーク機能をトリガーします。 - xAI 公式 は独自の /v1/responses インターフェースを通じて type: "web_search" ツールを宣言することで実行します。

以下では、**当サイトの統一的な呼び出し方法**と **xAI 公式の呼び出し方法**を比較して示します。

クイックスタート (Quick start)¶

当サイトの例 (新しい API プラットフォーム)¶

本プラットフォームでは、GPT、Gemini、Grok のいずれを呼び出す場合でも、/v1/chat/completions エンドポイントにリクエストを送信し、リクエストボディに web_search_options フィールドを追加するだけでネットワーク機能を有効にできます。

curl https://api-cs-al.naci-tech.com/v1/chat/completions \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $API_KEY" \
  -d '{
    "model": "grok-4-1-fast-reasoning",
    "messages": [
      { "role": "user", "content": "明日の北京の天気はどうですか？" }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

web_search_options: ネットワーク検索を有効にするためのフラグです。現在サポートされている設定項目（検索コンテキスト量を制御する search_context_size など）は、プラットフォーム内の他のモデルのネットワークメカニズムと完全に一致しています。

xAI 公式の例 (ネイティブ API)¶

xAI 公式 API に直接接続する場合は、彼らの /v1/responses インターフェースの tools 配列を通じてネイティブの web_search ツールを宣言する必要があります：

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4-1-fast-reasoning",
  "input": [
    {
      "role": "user",
      "content": "What is xAI?"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}'

xAI 公式の高度な機能説明¶

当サイトでは web_search_options を使用して非常に簡単に解決できますが、公式のネイティブ機能について理解することで、Grok Web Search の可能性を把握するのに役立ちます。

xAI の公式ドキュメントによると、ネイティブの Web Search ツールは以下の一般的なパラメータをサポートしています（tools[].filters またはツールプロパティを介して渡されます）：

パラメータ	説明
`allowed_domains`	指定されたドメイン内でのみ検索を実行します（最大 5 つ）
`excluded_domains`	検索から指定されたドメインを除外します（最大 5 つ）
`enable_image_understanding`	画像理解を有効にし、検索プロセスで遭遇した画像を分析します

特定のドメインのみを検索 (allowed_domains)¶

xAI 公式の例：

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4-1-fast-reasoning",
  "input": [
    { "role": "user", "content": "What is xAI?" }
  ],
  "tools": [
    {
      "type": "web_search",
      "filters": {
        "allowed_domains": ["grokipedia.com"]
      }
    }
  ]
}'

注意：allowed_domains と excluded_domains は**同時に設定することはできません**。

画像理解を有効にする (enable_image_understanding)¶

enable_image_understanding: true に設定すると、エージェントは検索プロセス中に view_image などの内部ツールを呼び出して、ウェブページから画像コンテンツを抽出して理解できるようになります。

xAI 公式の例：

curl https://api.x.ai/v1/responses \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -d '{
  "model": "grok-4-1-fast-reasoning",
  "input": [
    {
      "role": "user",
      "content": "What is included in the image in xAI'\''s official website?"
    }
  ],
  "tools": [
    {
      "type": "web_search",
      "enable_image_understanding": true
    }
  ]
}'

引用 (Citations)¶

Grok Web Search は、検索結果に基づいて引用付きの回答を生成します。 xAI 公式の Responses API では、response.citations または SDK が返す sources フィールドを通じて引用の詳細を確認できます（公式ドキュメント Citations を参照）。

本プラットフォームで /v1/chat/completions を使用して呼び出す場合、ゲートウェイがバックグラウンドで処理を行い、整理された結果を直接プレーンテキスト形式で結合するか、互換性のある Citation 形式で返します（他のモデルの動作と一致しています）。

補足：カスタム関数 (Function Calling)¶

Web Search の他に、Grok 用に独自のビジネスツールを定義することもできます。本サイトは OpenAI の Function Calling フォーマットを統一してサポートしています。例：

{
  "tools": [
    {
      "type": "function",
      "function": {
        "name": "get_user_info",
        "description": "ユーザー情報の取得",
        "parameters": {
          "type": "object",
          "properties": {
            "user_id": { "type": "string" }
          },
          "required": ["user_id"]
        }
      }
    }
  ]
}

ツール呼び出しに関するより一般的な説明については、このディレクトリのツール概要ドキュメント：index.md を参照してください。