Todos os produtos
Search
Central de documentação

EventBridge:KnowledgeBase

Última atualização: Sep 15, 2026

Parâmetro

Tipo

Descrição

Exemplo

object

As informações detalhadas sobre uma base de conhecimento do EventHouse, incluindo o status, o esquema de metadados, a configuração de fragmentação e a configuração de pesquisa.

Catalog

string

O catálogo de dados do EventHouse ao qual a base de conhecimento pertence. Este valor não pode ser modificado após a criação da base de conhecimento.

my_catalog

ChunkConfiguration

object

A estratégia de fragmentação padrão da base de conhecimento. Esta configuração entra em vigor apenas para documentos carregados após a atualização da configuração. Os documentos existentes não são refragmentados.

HeadingLevel

integer

O nível de título (1 a 6) usado para divisão na estratégia BY_HEADING. Os títulos neste nível ou acima servem como limites de divisão. Os títulos de níveis mais profundos são mantidos no corpo do fragmento.

2

MaxChunkSize

integer

O comprimento máximo em caracteres de um único fragmento. A partir da revisão 22, este valor é baseado em caracteres. Valores válidos: 1 a 6000.

600

OverlapSize

integer

O comprimento em caracteres da sobreposição entre fragmentos adjacentes. Este parâmetro entra em vigor apenas para a estratégia BY_LENGTH. Quando o valor é maior que 0, o início do próximo fragmento repete o conteúdo do final do fragmento anterior dentro desta janela. A sobreposição não faz com que um fragmento exceda o MaxChunkSize. Um valor de 0 indica que não há sobreposição.

40

PreprocessRules

object

As regras de pré-processamento que entram em vigor durante a análise do documento.

RemoveUrlsAndEmails

boolean

Especifica se as URLs e os endereços de e-mail devem ser removidos durante a análise.

false

ReplaceConsecutiveWhitespace

boolean

Especifica se os caracteres de espaço em branco consecutivos (espaços, quebras de linha e caracteres de tabulação) devem ser substituídos por um único espaço.

true

Separator

string

O separador usado na estratégia BY_SEPARATOR. O separador é correspondido como uma string literal (não uma expressão regular). O comprimento máximo é de 32 caracteres.

\\n\\n

Strategy

string

A estratégia de fragmentação. Valores válidos:

  • AUTO: divisão inteligente (com reconhecimento de títulos + agrupamento de parágrafos).

  • BY_LENGTH: divisão por janela deslizante com base no comprimento. Você pode especificar OverlapSize.

  • BY_SEPARATOR: divisão por separador. Você deve especificar Separator.

  • BY_HEADING: divisão por nível de título. Você deve especificar HeadingLevel.

BY_SEPARATOR

CreatedAt

string

A hora em que a base de conhecimento foi criada.

2026-08-24T10:00:00Z

Description

string

A descrição da base de conhecimento.

Base de conhecimento de documentação do produto

EmbeddingDimension

integer

A dimensão do vetor de embedding especificada durante a criação ou a dimensão padrão do modelo. Este valor não pode ser modificado após a criação da base de conhecimento.

1024

EmbeddingModel

string

O modelo de embedding especificado durante a criação. Este valor não pode ser modificado após a criação da base de conhecimento.

text-embedding-v4

FailureReason

string

O motivo resumido da falha de criação ou exclusão mais recente. Este parâmetro é retornado apenas quando o status é CREATE_FAILED ou DELETE_FAILED.

OssException: BucketAlreadyExists .

KnowledgeBaseName

string

O nome da base de conhecimento, que é exclusivo dentro do namespace.

product-docs

MetadataSchema

array

Os campos de metadados declarados quando a base de conhecimento foi criada. Esses campos não podem ser modificados após a criação da base de conhecimento.

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

MetadataSchemaField

A definição de um único campo no esquema de metadados, incluindo o nome do campo, o tipo e a origem do valor.

Namespace

string

O namespace do EventHouse ao qual a base de conhecimento pertence. Este valor não pode ser modificado após a criação da base de conhecimento.

my_namespace

SearchConfiguration

object

A configuração de pesquisa padrão no nível da base de conhecimento. Esta configuração entra em vigor quando os parâmetros correspondentes não são especificados em uma solicitação de pesquisa. Você pode modificar esta configuração chamando a operação UpdateKnowledgeBase.

Mode

string

O modo de recuperação. Valores válidos:

  • KEYWORD: recuperação por palavra-chave.

  • VECTOR: recuperação vetorial.

  • HYBRID: recuperação híbrida.

HYBRID

RankAlgorithm

string

O algoritmo de fusão para pesquisa híbrida. Este parâmetro entra em vigor apenas no modo de pesquisa híbrida. Valores válidos:

  • RRF: fusão de classificação recíproca.

  • WEIGHTED: fusão de normalização ponderada. Use este valor junto com VectorWeight.

Valor padrão: RRF.

RRF

RerankEnabled

boolean

Especifica se a reclassificação está ativada por padrão. Este parâmetro entra em vigor para todos os modos de pesquisa (KEYWORD, VECTOR e HYBRID). Este valor padrão é usado quando o parâmetro Rerank não é especificado em uma solicitação de pesquisa.

false

RerankModel

string

O modelo de reclassificação padrão usado quando o parâmetro RerankModel não é especificado em uma solicitação de pesquisa. Valores válidos: qwen3-rerank, gte-rerank-v2 e qwen3-vl-rerank. Valor padrão: qwen3-rerank. As distribuições de pontuação variam entre os modelos e não podem ser comparadas. Use o mesmo modelo de forma consistente dentro de uma base de conhecimento.

qwen3-rerank

RrfK

integer

O parâmetro k do algoritmo de fusão RRF. O valor deve ser maior que 0. Valor padrão: 60.

60

TopK

integer

O número máximo de resultados retornados por padrão para uma solicitação de pesquisa.

20

VectorWeight

number

O peso do caminho do vetor no algoritmo de fusão WEIGHTED. Valores válidos: 0 a 1. O peso do caminho da palavra-chave é igual a 1 menos este valor. Valor padrão: 0,7.

0.7

Status

string

O status atual da base de conhecimento. Valores válidos:

  • CREATING: A base de conhecimento está sendo criada.

  • ACTIVE: A base de conhecimento está disponível.

  • CREATE_FAILED: Falha ao criar a base de conhecimento.

  • DELETING: A base de conhecimento está sendo excluída.

  • DELETE_FAILED: Falha ao excluir a base de conhecimento.

ACTIVE

UpdatedAt

string

A hora em que a base de conhecimento foi atualizada pela última vez.

2026-08-24T10:00:00Z