ToolsSearchProRequest

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/kimi-ai/json-schema/kimi-ai-tools-search-pro-request-schema.json",
  "title": "ToolsSearchProRequest",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/kimi-ai-tools-api-openapi.yml#/components/schemas/ToolsSearchProRequest",
  "type": "object",
  "properties": {
    "text_query": {
      "type": "string",
      "description": "搜索查询文本，不能为空。"
    },
    "timeout_seconds": {
      "type": "integer",
      "minimum": 1,
      "maximum": 60,
      "description": "搜索超时时间，单位秒，取值范围 1-60。不传则不设置单独超时。"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "最多返回结果数，默认 5，取值范围 1-20。"
    },
    "sites": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 5,
      "description": "站点约束，多个站点按 OR 处理，最多 5 个；单条不能为空，且不能包含空白字符或括号。"
    },
    "time_window": {
      "$ref": "#/$defs/ToolsSearchTimeWindow"
    }
  },
  "required": [
    "text_query"
  ],
  "$defs": {
    "ToolsSearchTimeWindow": {
      "type": "object",
      "description": "历史时间窗约束。start 与 end 均按周期第一天归一化后比较，start 不得晚于 end。",
      "properties": {
        "start": {
          "type": "string",
          "description": "起始时间下限，格式 YYYY / YYYY-MM / YYYY-MM-DD。"
        },
        "end": {
          "type": "string",
          "description": "结束时间上限，格式 YYYY / YYYY-MM / YYYY-MM-DD。"
        }
      }
    }
  }
}