|
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:
|
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:
|
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:
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:
|
ACTIVE |
| UpdatedAt |
string |
A hora em que a base de conhecimento foi atualizada pela última vez. |
2026-08-24T10:00:00Z |