OpenSearch:インターネット検索

サービス

• 認証情報を取得します。

  API を使用して AI Search Open Platform サービスを呼び出す場合は、呼び出し元の ID を認証する必要があります。

• サービスアクセスアドレスを取得します。

  インターネットまたは VPC (仮想プライベートクラウド) を介してサービスを呼び出すことができます。 詳細については、「サービス登録アドレスを取得する」をご参照ください。

リクエストメソッド

POST

URL

{host}/v3/openapi/workspaces/{workspace_name}/web-search/{service_id}

• host: サービスを呼び出すためのアドレス。インターネットまたは VPC を介して API サービスを呼び出すことができます。 詳細については、「サービスアクセスアドレスを取得する」をご参照ください。

• workspace_name: ワークスペース名 (例: default)。

• service_id: ビルトインサービス ID (例: ops-web-search-001)。

リクエストパラメーター

ヘッダーパラメーター

API-KEY 認証

ボディパラメーター

Curl リクエスト例

curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer Your-API-KEY" \
"http://xxxx-hangzhou.opensearch.aliyuncs.com/v3/openapi/workspaces/default/web-search/ops-web-search-001" \
-d '{
      "history": [
        {"role": "system", "content": "You are a robot assistant"},
        {"role": "user", "content": "What is the capital of Zhejiang Province"},
        {"role": "assistant", "content": "Hangzhou"}
        ],
      "query":"What is the weather like in Hangzhou today",
      "query_rewrite":true,
      "top_k":5,
      "content_type":"snippet"
}'

レスポンスパラメーター

レスポンス例

成功レスポンスの例

{
  "result":{
    "search_result": [
        {
          "title": "Hangzhou Weather",
          "link": "https://www.hzqx.com/pc/hztq/",
          "snippet": "Cloudy tonight; sunny to partly cloudy tomorrow; partly cloudy to cloudy the day after tomorrow. North wind 2-3 level tonight, east wind 2 level tomorrow. Maximum temperature tomorrow during the day is 10 degrees, minimum temperature tomorrow morning is 3 degrees, average relative humidity tomorrow is 65%.",
          "position": 3,
          "content": "Hangzhou Weather\nCloudy tonight; sunny to partly cloudy tomorrow; partly cloudy to cloudy the day after tomorrow. North wind 2-3 level tonight, east wind 2 level tomorrow. Maximum temperature tomorrow during the day is 10 degrees, minimum temperature tomorrow morning is 3 degrees, average relative humidity tomorrow is 65%."
        },
        {
          "title": "Hangzhou Weather Forecast_Weather Query - Moji Weather",
          "link": "https://tianqi.moji.com/weather/china/zhejiang/hangzhou",
          "snippet": "Hangzhou current conditions: 3 degrees sunny, humidity: 66%, northwest wind: level 3. Daytime: 10 degrees, sunny. Night: cloudy, 3 degrees, it's getting cool, Moji Weather suggests you wear a thick coat over your wool sweater, and elderly or frail individuals can wear a wool overcoat to increase warmth.",
          "position": 4,
          "content": "Hangzhou Weather Forecast_Weather Query - Moji Weather\nHangzhou current conditions: 3 degrees sunny, humidity: 66%, northwest wind: level 3. Daytime: 10 degrees, sunny. Night: cloudy, 3 degrees, it's getting cool, Moji Weather suggests you wear a thick coat over your wool sweater, and elderly or frail individuals can wear a wool overcoat to increase warmth."
        }
    ]
  },
    "usage": {
            "search_count": 1,
            "rewrite_model.input_tokens": 249,
            "rewrite_model.output_tokens": 1,
            "rewrite_model.total_tokens": 250,
            "filter_model.input_tokens": 1804,
            "filter_model.output_tokens": 216,
            "filter_model.total_tokens": 2020
    }
}

エラーレスポンスの例

アクセスリクエストが失敗した場合、出力結果は code フィールドと message フィールドによってエラー原因を示します。

{
    "request_id": "6F33AFB6-A35C-****-AFD2-9EA16CCF4383",
    "latency": 2.0,
    "code": "InvalidParameter",
    "http_code": 400,
    "message": "JSON parse error: Cannot deserialize value of type `ImageStorage` from String \\"xxx\\"
}

ステータスコード

詳細については、AI Search Open Platform のステータスコードをご参照ください。