kongdeqiang
2026-10-09 9af621d181217a03b1b3dce208a163915db974a3
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
package com.custom.webui.dto.req;
 
import jakarta.validation.constraints.NotBlank;
import jakarta.validation.constraints.Size;
import lombok.Data;
 
/**
 * RAG 检索请求体。
 *
 * <p>{@code collectionNames} 为空表示在当前用户的所有知识库中检索,
 * 非空时后端会与用户实际拥有的集合求交集 —— 越权的集合名会被静默过滤掉。
 */
@Data
public class RagSearchRequest {
 
    @NotBlank(message = "查询内容不能为空")
    @Size(max = 4000, message = "查询内容过长")
    private String query;
 
    /** 目标集合名单,可空 */
    private java.util.List<String> collectionNames;
 
    /** 返回片段数,为空用配置默认值 */
    private Integer topK;
 
    /**
     * 会话 id(可选)。
     *
     * <p>传入时,若 {@code collectionNames} 为空,后端会取该会话自己绑定的
     * 知识库(含整类绑定展开)作为检索目标,而不是退化成「用户全部知识库」。
     *
     * <p>这是针对一类真实事故的兜底:前端一旦忘记把已绑定集合传过来,
     * 检索范围就会变成「该用户所有知识库」,既可能命中无关内容,
     * 也让「绑定」这个动作失去意义。
     */
    private Long chatId;
}