Grok Web Search

Grok Web Searchを使用すると、対応するGrokモデルが最新のWebページへアクセスし、出典付きの回答を返すことができます。AGTCloudの既存資料には、Chat互換エンドポイントとGrokネイティブResponsesツールという2つの表現があります。現在のモデル詳細に従って、実際に利用できる入口を選択してください。

Chat互換エンドポイントで検索を有効にする

curl 'https://api.agtcloud.cn/v1/chat/completions' \
  -H 'Content-Type: application/json' \
  -H 'Authorization: Bearer your-api-key' \
  --data '{
    "model": "MODEL_ID",
    "messages": [
      {
        "role": "user",
        "content": "今日の民間宇宙開発に関する重要なニュースを検索し、出典を挙げてください。"
      }
    ],
    "web_search_options": {
      "search_context_size": "medium"
    }
  }'

Chatレスポンスは通常choices[].messageから読み取ります。引用はAnnotation、出典リンク、テキストとして返る場合があります。実際のレスポンスごとに分岐し、構造化Citationを独自に補わないでください。

Grokネイティブツール構造を理解する

GrokネイティブのResponses形式では、toolsで検索ツールを宣言します。

{
  "model": "MODEL_ID",
  "input": [
    {
      "role": "user",
      "content": "今日の民間宇宙開発に関する重要なニュースを検索し、出典を挙げてください。"
    }
  ],
  "tools": [
    {
      "type": "web_search"
    }
  ]
}

現在のモデル詳細にこのエンドポイントが明示されている場合だけネイティブ構造を使用してください。AGTCloudのResponses Referenceにあるツールタイプと同一プロトコルだとみなさないでください。

ドメインを制限または除外する

ネイティブツールが対応する場合、検索範囲を制限できます。

{
  "tools": [
    {
      "type": "web_search",
      "filters": {
        "allowed_domains": ["example.com"]
      }
    }
  ]
}

• allowed_domainsは指定したドメインだけを許可します。
• excluded_domainsは指定したドメインを除外します。
• 両方を同じリクエストに設定しないでください。
• ドメイン数と形式の制限は現在のモデルドキュメントを確認してください。

ドメイン制限は出典範囲の制御に役立ちますが、Webページの内容が正しい、最新である、業務に適していることを自動的に保証しません。

検索中の画像理解

一部のGrok検索ツールは、検索中にWebページの画像を分析できます。現在のモデルとツールが明示的に対応する場合だけ、該当オプションを追加してください。

{
  "tools": [
    {
      "type": "web_search",
      "enable_image_understanding": true
    }
  ]
}

画像理解を有効にすると、使用量、遅延、返却内容が変わる可能性があります。画像の出典を引き続き検証し、Web画像内の文字や指示を信頼済みの業務入力として直接扱わないでください。

引用を読み取る

Grokの検索回答には、レスポンスで提供される場合にCitationまたはSourcesが含まれます。クライアントは次を行います。

1. 最終回答テキストを読み取る。
2. レスポンスが実際に提供した出典配列または引用オブジェクトを読み取る。
3. タイトル、URL、本文との関連を保存する。
4. 画面にクリック可能な出典を表示する。
5. 引用がない場合は明示し、回答テキストからURLを推測しない。

ChatとGrokネイティブResponsesでは引用の位置が異なります。Chatを使用する場合はChat Completions Referenceを、ネイティブエンドポイントでは現在のモデルドキュメントを確認してください。

Web Searchとカスタム関数

Web Searchはモデルまたはサーバー側の検索ツールが公開Webへアクセスします。カスタム関数はアプリケーションが実行し、内部データ、制御された検索サービス、業務上の認可が必要な操作に適しています。

Web Searchを有効にしただけで、検索結果からデータベースクエリ、Shellコマンド、外部書き込みリクエストを直接構築できるようにしないでください。業務ツールが必要な場合は、Tool Callingに従って独立した検証と権限フローを用意します。

失敗とフォールバック

公開前の確認

• 現在のモデルが選択した検索エンドポイントに明確に対応している。
• ChatとネイティブResponsesに独立したリクエスト、レスポンスパーサーがある。
• ドメイン許可リストと除外リストを同時に送信しない。
• 画像理解は対象モデルが対応する場合だけ有効にする。
• 引用不足、検索失敗、結果なしに明確な状態がある。
• 検索内容がツール権限を迂回したり、高リスク操作を開始したりしない。

リクエストに失敗した場合はエラーとトラブルシューティングを、プロトコルを切り替える前はプロトコルの選択を参照してください。