更新时间:2025-07-22 GMT+08:00
分享

Web AI搜索问答

功能介绍

Web AI搜索问答

URI

POST /v1/{project_id}/applications/{application_id}/uni-search/web/chat

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,获取方法请参见获取项目ID

约束限制:

不涉及

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

application_id

String

参数解释:

应用ID,获取方法请参见获取应用ID

约束限制:

字符串

取值范围:

1~64个字符,只能包含数字、字母、中划线和下划线,且必须以字母开头。

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Token

String

参数解释:

用户登录后,会根据用户登录信息创建token鉴权。

通过鉴权校验用户的合法性。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

表3 请求Body参数

参数

是否必选

参数类型

描述

repo_id

String

参数解释:

知识库ID。

约束限制:

不涉及

取值范围:

长度在1到64之间,只能包含字母、数字、下划线和短横线。

默认取值:

不涉及

chat_id

String

参数解释:

对话ID。

约束限制:

不涉及

取值范围:

长度在1到64之间,只能包含字母、数字、下划线和短横线。

默认取值:

不涉及

query

String

参数解释:

用户问题。

约束限制:

不涉及

取值范围:

非空,最大长度为20480

默认取值:

不涉及

history

Array of strings

参数解释:

对话历史。

实现逻辑:

1.只参考最近5轮对话

2.单轮对话只参考300~500字。

约束限制:

  1. 元素必须为偶数个,如 [Question1, Answer1, Question2, Answer2]

  2. 按照对话顺序从旧到新

  3. 问题 Question 必填

  4. 答案 Answer 可以为空字符串,但必须占位

取值范围:

列表长度限制40。

默认取值:

不涉及

engine

String

参数解释:

web搜索引擎。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

mode

String

参数解释:

AI搜索模式:

simple: 简洁模式,只经过一轮搜索问答,可预期首token时延2秒。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

stream

Boolean

参数解释:

流式输出开关。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

model_options

Map<String,Object>

参数解释:

生成模型参数。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

max_documents

Integer

参数解释:

检索的最大网页数量,便于生成模型控制上下文。

约束限制:

不涉及

取值范围:

1-20

默认取值:

5

max_chunk_size

Integer

参数解释:

网页分片大小限制。对于长篇的网页,内部完成分片优选

约束限制:

不涉及

取值范围:

200-2000

默认取值:

500

prompt_template

String

参数解释:

Prompt模板,提供 query、docs 上下文。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

extra_repo_ids

Array of strings

参数解释:

共同搜索知识库ID。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

file_ids

Array of strings

参数解释:

基于文件问答。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

thinking_enabled

Boolean

参数解释:

深度思考。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

search_enabled

Boolean

参数解释:

联网搜索。

约束限制:

不涉及

取值范围:

不涉及

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

chat_id

String

参数解释:

对话ID。

chat_result

ChatResult object

参数解释:

对话结果。

documents

Array of Document objects

参数解释:

Web检索网页结果。

表5 ChatResult

参数

参数类型

描述

index

Integer

参数解释:

序号。

取值范围:

不涉及

message

String

参数解释:

文本内容。

取值范围:

不涉及

question_id

String

参数解释:

问答ID。

取值范围:

不涉及

表6 Document

参数

参数类型

描述

title

String

参数解释:

标题,使用此名称和 url 来创建一个超链接,单击该超链接会将用户带到该网页。

取值范围:

不涉及

content

String

参数解释:

内容。

取值范围:

不涉及

url

String

参数解释:

超链接。

取值范围:

不涉及

score

Float

参数解释:

相关度。

取值范围:

不涉及

timestamp

String

参数解释:

更新时间(上次抓取网页的时间),日期的格式为 YYYY-MM-DDTHH:MM:SS。

取值范围:

不涉及

category

String

参数解释:

目录,单值。

取值范围:

不涉及

tags

Array of strings

参数解释:

标签列表。

取值范围:

不涉及

query

String

参数解释:

搜索query。

取值范围:

不涉及

type

String

参数解释:

搜索类型。

取值范围:

不涉及

id

String

参数解释:

标识。

取值范围:

不涉及

file_id

String

参数解释:

文件标识。

取值范围:

不涉及

size

Long

参数解释:

大小。

取值范围:

不涉及

has_html

Boolean

参数解释:

标记是否为html。

取值范围:

不涉及

rank

String

参数解释:

doc在websearch召回时的排序。

取值范围:

不涉及

source

String

参数解释:

来源。

取值范围:

不涉及

状态码:400

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

状态码:500

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码

取值范围:

不涉及

error_msg

String

参数解释:

错误描述。

取值范围:

不涉及

请求示例

Web AI搜索问答。

/v1/b25446daeb1a41a7953c5deba2b2677a/applications/be9b19bf-4865-4fb8-b9f8-2fd1fea98d76/uni-search/web/chat

{
  "repo_id" : "0c3fae2d-428e-454c-ad80-2e5c5fa7b33a",
  "query" : "你是谁",
  "chat_id" : "e561df11-50ba-42f0-a7fe-9bdb0e17be85",
  "file_ids" : [ ],
  "history" : [ ],
  "stream" : true,
  "mode" : "simple",
  "thinking_enabled" : false,
  "search_enabled" : false
}

响应示例

状态码

状态码

描述

200

AI搜索响应。

400

客户端错误。

500

服务端异常。

错误码

请参见错误码

相关文档