KnowledgeBase - 事件总线EventBridge

名称	类型	描述	示例值
	object	EventHouse 知识库的详细信息，包含状态、元数据 Schema、分块与检索配置
Catalog	string	知识库所属的 EventHouse 数据目录，创建后不可修改	my_catalog
ChunkConfiguration	object	知识库默认分块策略，仅对配置更新后新上传的文档生效，存量文档不重新分块
HeadingLevel	integer	BY_HEADING 策略的切分标题级数（1~6），小于等于该级的标题都作为切分边界，更深级标题保留在切片正文中	2
MaxChunkSize	integer	单个分块的最大字符长度（与入参口径一致，修订 22 起为字符制，取值 [1, 6000]）	600
OverlapSize	integer	仅 BY_LENGTH 策略生效。相邻分块的重叠字符长度：大于 0 时后一个切片头部重复前一个切片尾部该窗口内的内容，重叠不会使切片超过 MaxChunkSize。0 表示不重叠	40
PreprocessRules	object	预处理规则，解析文档时生效
RemoveUrlsAndEmails	boolean	是否在解析时删除 URL 与邮箱地址	false
ReplaceConsecutiveWhitespace	boolean	是否将连续的空白字符（空格、换行、制表符）替换为单个空格	true
Separator	string	BY_SEPARATOR 策略下的分隔符，按字面字符串整体匹配切分（非正则），最长 32 个字符	\\n\\n
Strategy	string	AUTO 表示智能切分（标题感知+段落打包）；BY_LENGTH 表示按长度滑动窗口切分，可指定 OverlapSize；BY_SEPARATOR 表示按分隔符切分，必须指定 Separator；BY_HEADING 表示按标题级数切分，必须指定 HeadingLevel	BY_SEPARATOR
CreatedAt	string	创建时间	2026-08-24T10:00:00Z
Description	string	知识库描述信息	产品文档知识库
EmbeddingDimension	integer	创建时指定或使用模型默认维度，创建后不可修改	1024
EmbeddingModel	string	创建时固化的 Embedding 模型，创建后不可修改	text-embedding-v4
FailureReason	string	最近一次创建或删除失败的精简原因，仅在状态为 CREATE_FAILED 或 DELETE_FAILED 时返回	OssException: BucketAlreadyExists ...
KnowledgeBaseName	string	知识库名称，命名空间内唯一	product-docs
MetadataSchema	array	创建知识库时声明的 Metadata 字段，创建后不可修改	[{"Name":"department","Type":"STRING"}]
	MetadataSchemaField	元数据 Schema 中单个字段的定义，包含字段名、类型与取值方式
Namespace	string	知识库所属的 EventHouse 命名空间，创建后不可修改	my_namespace
SearchConfiguration	object	知识库级默认检索配置，检索请求未传对应参数时生效，可通过 UpdateKnowledgeBase 修改
Mode	string	KEYWORD 表示关键词检索，VECTOR 表示向量检索，HYBRID 表示混合检索	HYBRID
RankAlgorithm	string	仅混合检索模式生效。RRF 表示倒数排名融合，WEIGHTED 表示加权归一融合（配合 VectorWeight 使用）。不传时默认 RRF	RRF
RerankEnabled	boolean	全部检索模式（KEYWORD、VECTOR、HYBRID）生效。检索请求未指定 Rerank 时使用此默认值	false
RerankModel	string	检索请求未指定 RerankModel 时使用此默认值。取值范围：qwen3-rerank、gte-rerank-v2、qwen3-vl-rerank。不传时默认 qwen3-rerank。不同模型的分数分布不可横向比较，同一知识库建议固定使用同一模型	qwen3-rerank
RrfK	integer	RRF 融合算法参数，默认 60，必须大于 0	60
TopK	integer	检索默认返回的最多结果数	20
VectorWeight	number	WEIGHTED 融合算法的向量路权重，取值 [0, 1]，关键词路权重为 1 减去该值。不传时默认 0.7	0.7
Status	string	知识库当前状态。CREATING 表示创建中，ACTIVE 表示可用，CREATE_FAILED 表示创建失败，DELETING 表示删除中，DELETE_FAILED 表示删除失败	ACTIVE
UpdatedAt	string	最近更新时间	2026-08-24T10:00:00Z

object

EventHouse 知识库的详细信息，包含状态、元数据 Schema、分块与检索配置

Catalog

string

知识库所属的 EventHouse 数据目录，创建后不可修改

my_catalog

ChunkConfiguration

object

知识库默认分块策略，仅对配置更新后新上传的文档生效，存量文档不重新分块

HeadingLevel

integer

BY_HEADING 策略的切分标题级数（1~6），小于等于该级的标题都作为切分边界，更深级标题保留在切片正文中

2

MaxChunkSize

integer

单个分块的最大字符长度（与入参口径一致，修订 22 起为字符制，取值 [1, 6000]）

600

OverlapSize

integer

仅 BY_LENGTH 策略生效。相邻分块的重叠字符长度：大于 0 时后一个切片头部重复前一个切片尾部该窗口内的内容，重叠不会使切片超过 MaxChunkSize。0 表示不重叠

40

PreprocessRules

object

预处理规则，解析文档时生效

RemoveUrlsAndEmails

boolean

是否在解析时删除 URL 与邮箱地址

false

ReplaceConsecutiveWhitespace

boolean

是否将连续的空白字符（空格、换行、制表符）替换为单个空格

true

Separator

string

BY_SEPARATOR 策略下的分隔符，按字面字符串整体匹配切分（非正则），最长 32 个字符

\\n\\n

Strategy

string

AUTO 表示智能切分（标题感知+段落打包）；BY_LENGTH 表示按长度滑动窗口切分，可指定 OverlapSize；BY_SEPARATOR 表示按分隔符切分，必须指定 Separator；BY_HEADING 表示按标题级数切分，必须指定 HeadingLevel

BY_SEPARATOR

CreatedAt

string

创建时间

2026-08-24T10:00:00Z

Description

string

知识库描述信息

产品文档知识库

EmbeddingDimension

integer

创建时指定或使用模型默认维度，创建后不可修改

1024

EmbeddingModel

string

创建时固化的 Embedding 模型，创建后不可修改

text-embedding-v4

FailureReason

string

最近一次创建或删除失败的精简原因，仅在状态为 CREATE_FAILED 或 DELETE_FAILED 时返回

OssException: BucketAlreadyExists ...

KnowledgeBaseName

string

知识库名称，命名空间内唯一

product-docs

MetadataSchema

array

创建知识库时声明的 Metadata 字段，创建后不可修改

[{"Name":"department","Type":"STRING"}]

MetadataSchemaField

元数据 Schema 中单个字段的定义，包含字段名、类型与取值方式

Namespace

string

知识库所属的 EventHouse 命名空间，创建后不可修改

my_namespace

SearchConfiguration

object

知识库级默认检索配置，检索请求未传对应参数时生效，可通过 UpdateKnowledgeBase 修改

Mode

string

KEYWORD 表示关键词检索，VECTOR 表示向量检索，HYBRID 表示混合检索

HYBRID

RankAlgorithm

string

仅混合检索模式生效。RRF 表示倒数排名融合，WEIGHTED 表示加权归一融合（配合 VectorWeight 使用）。不传时默认 RRF

RRF

RerankEnabled

boolean

全部检索模式（KEYWORD、VECTOR、HYBRID）生效。检索请求未指定 Rerank 时使用此默认值

false

RerankModel

string

检索请求未指定 RerankModel 时使用此默认值。取值范围：qwen3-rerank、gte-rerank-v2、qwen3-vl-rerank。不传时默认 qwen3-rerank。不同模型的分数分布不可横向比较，同一知识库建议固定使用同一模型

qwen3-rerank

RrfK

integer

RRF 融合算法参数，默认 60，必须大于 0

60

TopK

integer

检索默认返回的最多结果数

20

VectorWeight

number

WEIGHTED 融合算法的向量路权重，取值 [0, 1]，关键词路权重为 1 减去该值。不传时默认 0.7

0.7

Status

string

知识库当前状态。CREATING 表示创建中，ACTIVE 表示可用，CREATE_FAILED 表示创建失败，DELETING 表示删除中，DELETE_FAILED 表示删除失败

ACTIVE

UpdatedAt

string