Viewing Knowledge Base Details

project_id

Yes

String

Definition:

Project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Constraints:

N/A

Value range:

The value can contain 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter.

Default value:

N/A

application_id

Yes

String

Definition:

Application ID. For details about how to obtain the application ID, see Obtaining an Application ID.

Constraints:

Character string

Value range:

The value can contain 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter.

Default value:

N/A

repo_id

Yes

String

Definition:

Knowledge base ID.

How to obtain:

Log in to the KooSearch experience platform. In the navigation tree on the left, choose Knowledge Bases to view knowledge base IDs. Each knowledge base has a unique ID stored in the vector database.

Constraints:

N/A

Value range:

Length: 1 to 64 characters. The value can contain only digits, letters, hyphens (-), and underscores (_).

Default value:

N/A

X-Auth-Token

Yes

String

Definition:

Token used for API authentication. For details about how to obtain the token, see Obtaining an IAM User Token.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

id

String

Definition:

Knowledge base ID.

Value range:

N/A

name

String

Definition:

Knowledge base name.

Value range:

N/A

detail

String

Definition:

Description.

Value range:

N/A

repo_type

String

Definition:

Knowledge base type

Constraints:

N/A

Value range:

• exclusive | null

• share

• template

share_repo_used

Integer

Definition:

Number of shared knowledge bases already created.

Constraints:

This parameter applies to template knowledge bases.

Value range:

N/A

share_repo_quota

Integer

Definition:

Remaining quota for creating shared knowledge bases.

Constraints:

This parameter applies to template knowledge bases.

Value range:

N/A

tags

Array of TagInfo objects

Definition:

Knowledge base tag information.

Value range:

N/A

version

String

Definition:

Knowledge base version information.

Value range:

N/A

refs

String

Definition:

List of referenced knowledge base IDs, which are separated by commas (,).

Value range:

N/A

status

String

Definition:

Status.

Value range:

• OPEN: enabled

• CLOSE: disabled

create_user

String

Definition:

User.

Value range:

N/A

create_time

String

Definition:

Creation time.

Value range:

N/A

update_time

String

Definition:

Update time.

Value range:

N/A

top_k

Integer

Definition:

The value of top-K, in the range of 10 to 500.

Value range:

10-500

prompt

String

Definition:

Prompt information.

Value range:

The value contains a maximum of 8,192 characters.

common_prompt

String

Definition:

General prompt information.

Value range:

The maximum length is 8,192 characters.

rerank_enabled

Boolean

Definition:

Rerank switch.

Value range:

• true: Enable reranking. The top_k results recalled will be reranked by the reranking model.

• false: Disable reranking. The top_k results recalled will not be reranked.

moderate_enabled

Boolean

Definition:

Whether to enable content moderation.

Value range:

• true: Enable content moderation.

• false: Disable content moderation.

query_rewrite_enabled

Boolean

Definition:

Rewriting switch.

Value range:

• true: Use the rewriting result for search.

• false: Do not use the rewriting result for search.

reference_count

Integer

Definition:

The number of reference documents. Number of reference documents provided as input to the NLP model along with the query to generate the final answer.

Value range:

1-50

fields

Array of KnowledgeRepoFieldSchema objects

Definition:

Field description. This parameter is not used and is left empty.

Value range:

N/A

search_threshold

Float

Definition:

Threshold for filtering search interfaces.

Value range:

When reranking is disabled, the threshold ranges from 0 to 200. When it is enabled, the threshold ranges from 0 to 1.

chat_ref_threshold

Float

Definition:

Reference document filtering threshold.

Value range:

When reranking is disabled, the threshold ranges from 0 to 200. When it is enabled, the threshold ranges from 0 to 1.

faq_threshold

Float

Definition:

FAQs with a correlation score exceeding this threshold will have their answers directly output, without needing to be summarized by the big model.

Precautions:

1. If the parameter value is less than or equal to 0, the answer is not generated directly based on preset FAQs.

2. In the earlier version of query2doc, the threshold ranges from 0 to 200 when reranking is disabled; and from 0 to 1 when reranking is enabled.

3. For query2query of the new version, the threshold ranges from 0 to 1.

Value range:

When reranking is disabled, the threshold ranges from 0 to 200. When it is enabled, the threshold ranges from 0 to 1.

embedding_model

String

Definition:

Embedding model name.

Value range:

N/A

rerank_model

String

Definition:

Reranking model name.

Value range:

N/A

pangu_nlp_model

String

Definition:

NLP model name.

Value range:

N/A

search_plan_model

String

Definition:

Name of the search planning model.

Value range:

N/A

file_extract

FileExtract object

Definition:

Document parsing details.

Value range:

N/A

search_plan_category_ids

Array of strings

Definition:

Search planning categories.

Value range:

The list can contain a maximum of 10 elements. Each element can contain a maximum of 64 characters.

Values:

• professional_knowledge-medical

• weather

• professional_knowledge

• professional_knowledge-manufacturing

• chitchat

• language_tasks

• professional_knowledge-finance

• general_knowledge

• professional_knowledge-government

• identity: persona

language_id

String

Definition:

Knowledge base language ID

Value range:

The value can be:

• zh==CHINESE

• en==ENGLISH

• th==THAI

• ar==ARABIC

• es==SPANISH

• pt==PORTUGUESE

cache_enabled

Boolean

Definition:

Whether to enable caching.

Value range:

• true: Enable caching.

• false: Disable caching.

session_config

SessionConfig object

Definition:

Cache policy.

Value range:

N/A

answer_reference_enabled

Boolean

Definition:

Whether to enable referencing.

Value range:

• true: Enable referencing.

• false: Disable referencing.

answer_image_reference_enabled

Boolean

Definition:

Whether to include both text and images.

Value range:

• true: Include both text and images.

• false: Do not include both text and images.

extend_config

KnowledgeRepoExtendConfig object

Definition:

Knowledge base extension configuration.

Value range:

N/A

prompt_info

KnowledgeRepoPromptInfo object

Definition:

Associated prompts.

Value range:

N/A

actions

Array of strings

Definition:

Permissions.

Value range:

N/A

table_rag_enabled

Boolean

Definition:

Whether to use tableRAG. The prerequisite is that an NL2SQL database has been configured for the current cluster.

Value range:

• true: Enable tableRAG.

• false: Disable tableRAG.

tag_key

String

Definition:

Knowledge base tag keyword.

Constraints:

N/A

Value range:

1 to 128 characters.

Default value:

N/A

tag_value

String

Definition:

Knowledge base tag information.

Constraints:

N/A

Value range:

1 to 128 characters.

Default value:

N/A

name

String

Definition:

Field name.

Value range:

N/A

field_type

String

Definition:

Field type. This parameter is not used and is left empty.

Value range:

N/A

name_zh

String

Definition:

Field name (Chinese).

Value range:

N/A

parse_conf

ParseConfReq object

Definition:

Document parsing configuration, including whether to use OCR enhancement, whether to parse images, whether to extract text during image parsing, whether to parse the header and footer, and whether to parse the contents page.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

split_conf

SplitConf object

Definition:

Split configuration, including the segmentation mode, level parsing mode, title level depth, title saving mode, segment length, and title matching pattern.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

ocr_enabled

Boolean

Definition:

OCR enhancement.

Constraints:

N/A

Value range:

• true: Enable OCR enhancement.

• false: Do not enable OCR enhancement.

Default value:

false

mllm_enabled

Boolean

Definition:

Multimodal enhancement.

Constraints:

N/A

Value range:

• true: Enable multi-modal enhancement.

• false: Disable multi-modal enhancement.

Default value:

false

mllm_model

String

Definition:

Multimodal model name.

Constraints:

The mllm_plan model must have already been configured on the platform. You can check the models configured on the platform using the ListModels API.

Value range:

The value can contain 1 to 32 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed. The value must start with a letter or digit.

Default value:

N/A

image_enabled

Boolean

Definition:

Image parsing.

Constraints:

N/A

Value range:

• true: Parse images.

• false: Do not parse images.

Default value:

false

header_footer_enabled

Boolean

Definition:

Parse the header and footer.

Constraints:

N/A

Value range:

• true: Parse the header and footer.

• false: Ignore the header and footer.

Default value:

false

catalog_enabled

Boolean

Definition:

Parse the contents page.

Constraints:

N/A

Value range:

• true: Parse the contents page.

• false: Ignore the contents page.

Default value:

false

image_conf

String

Definition:

Image parsing mode used when image parsing is enabled (image_enable is set to True).

Constraints:

To return answers with images, you must use the IMAGE mode and retain original images.

Value range:

• TEXT: Extracts text from the image.

• IMAGE: Retains the original image.

• IMAGE_TEXT: Extracts the text and retains the original image.

Default value:

TEXT

footnote_enabled

Boolean

Definition:

Parse footnotes.

Constraints:

N/A

Value range:

• true: Parse footnotes.

• false: Do not parse footnotes.

Default value:

false

split_mode

String

Definition:

Document segmentation mode.

Value range:

The value can be:

• AUTO: The system automatically identifies the document format and matches the appropriate segmentation and parsing mode.

• LENGTH: Segments a document by length. For example, a document is segmented into paragraphs every 500 characters.

• CATALOG: Automatic parsing under hierarchical segmentation. The system automatically identifies the hierarchical structure of an article and segments the article based on the hierarchical structure. For example, section 1.1.2 is a segment, and section 1.1.3 is a segment.

• RULE: Rule-based parsing under hierarchical segmentation. You can customize the matching rules of hierarchical titles and match and split chapters based on custom rules.

Constraints:

N/A

Default value:

AUTO

separator_ids

Array of strings

Definition:

The chunk ID list in automatic segmentation and length segmentation modes.

Chunk ID: determines the end character for each chunk.

Constraints:

N/A

Value range:

Value mapping:

• period_zh: "Chinese period ",

• period_en: "English period .",

• exclamation_mark_zh: "Chinese exclamation mark ",

• exclamation_mark_en: "English exclamation mark !",

• question_mark_zh: "Chinese question mark ",

• question_mark_en: "English question mark ?",

• question_mark_ar: "Arabic question mark ؟",

• comma_zh: "Chinese comma",

• comma_en: "English comma ,",

• space_en: "Space"

Default value:

{"period_zh", "period_en", "exclamation_mark_zh", "exclamation_mark_en", "question_mark_zh", "question_mark_en"}

rule_regex_id

String

Definition:

User-defined Parsing Rule ID

Constraints:

N/A

Value range:

N/A

Default value:

N/A

chunk_size

Integer

Definition:

Maximum length of a document chunk. The document is segmented based on the maximum chunk length.

Constraints:

N/A

Value range:

0-6000

Default value:

500

title_level

Integer

Definition:

Title hierarchy depth retained in a chunk.

For example:

If the depth is 3 and the current paragraph is 1.1.3, then the parent titles 1.1 and 1 are both retained.

If the depth is 2 and the current paragraph is 1.1.3, then the parent title 1.1 is retained, and the parent title 1 is discarded.

Constraints:

N/A

Value range:

1-10

Default value:

3

combine_title

Boolean

Definition:

Whether to retain the hierarchical title combination.

Constraints:

N/A

Value range:

• true: Retain the hierarchical title combination.

• false: Do not retain the hierarchical title combination.

Default value:

false

merge_titles

Boolean

Definition:

Cross-Title Merge: When text in paragraphs with different titles is limited, it is automatically merged up to a specified section length, aiding in the creation of a more comprehensive outcome.

Constraints:

N/A

Value range:

• true: Merge across titles.

• false: Do not merge across titles.

Default value:

false

rule_regexs

Array of strings

Definition:

User-defined parsing rules.

Constraints:

N/A

Value range:

The list length ranges from 1 to 100.

Default value:

N/A

merge_last_chunk

Boolean

Definition:

Whether to merge the most recently modified segments.

Constraints:

N/A

Value range:

• true: Merge the most recently modified segments.

• false: Do not merge the most recently modified segments.

Default value:

N/A

similarity_threshold

Float

Definition:

Query2query similarity threshold for cache hit. A higher threshold indicates a higher similarity between the new query and the cached query is required.

Constraints:

N/A

Options:

0.1 ~ 1.0

Default value:

0.9

answer_select_policy

String

Definition:

Cache hit selection policy.

Constraints:

N/A

Value range:

The value can be:

• FIRST: Select the answer with the highest score from the matched results.

• RANDOM: Randomly select an answer from the matched results.

Default value:

N/A

eviction

Eviction object

Definition:

Cache expiration policy.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

model_name

String

Definition:

Name of the query2query model used to calculate the similarity between the new query and the cached query when there is a hit.

Constraints:

N/A

Value range:

1 to 64 characters.

Default value:

N/A

policy

String

Definition:

Cache expiration policy.

Constraints:

N/A

Value range:

The value can be:

• LRU: (Least Recently Used). If Now − accessTime > TTL, clear the item.

• FIFO: (First In First Out). If now − createTime > TTL, clear the item.

• LFU: (Least Frequency Used). If hit_count < threshold, clear the item.

Default value:

N/A

ttl

Long

Definition:

Cache expiration time, in milliseconds.

Constraints:

N/A

Value range:

0-31536000000

Default value:

N/A

hit_count_threshold

Long

Definition:

Threshold of cache hits.

Constraints:

N/A

Value range:

1-10000

Default value:

N/A

extend_context

Boolean

Definition:

Extend the context length to generate more comprehensive responses, for example:

1. Table small-to-big

2. Association of text (1)(2)(3)

3. Document summary

Constraints:

N/A

Value range:

• true: Extend the context length.

• false: Do not extend the context.

Default value:

false

effective_input_length

Integer

Definition:

Optimal context length, which varies with different models. Set the valid length of input tokens to ensure optimal output.

In consideration of multi-turn dialogues, we recommend setting this length to 60/ %(rounded up) of the maximum context length supported by the model.

Constraints:

N/A

Value range:

2-256

Default value:

32

top_p

Float

Definition:

An alternative to sampling with temperature, called nucleus sampling, where the model only takes into account the tokens with the probability mass determined by the top_p parameter.

Constraints:

N/A

Value range:

0.1-1

Default value:

0.1

max_tokens

Integer

Definition:

Maximum number of tokens in the generated text.

The total length of the input text plus the generated text cannot exceed the maximum length that the model can process.

Constraints:

N/A

Value range:

1-262144

Default value:

2048

chat_temperature

Float

Definition:

Diversity of non-RAG model's output.

Constraints:

N/A

Value range:

N/A

Default value:

0-1

search_temperature

Float

Definition:

Diversity of the RAG model's output.

Constraints:

N/A

Value range:

0-1

Default value:

0.6

presence_penalty

Float

Definition:

Text repetition penalty.

Constraints:

N/A

Value range:

-2 - 2

Default value:

0

use_system_prompt

Boolean

Definition:

Whether to use system prompts. Keep consistent with the standard prompt assembly solution used by Pangu RAG.

Constraints:

N/A

Value range:

• true: Use system prompts.

• false: Do not use system prompts.

Default value:

false

system_prompt

String

Definition:

System prompt. Note:

1. This parameter is mandatory when use_system_prompt is set to true.

2. No need to combine the query.

Constraints:

N/A

Value range:

0-8192

Default value:

N/A

qa_question_prompt

String

Definition:

QA generation and question generation prompt.

Constraints:

N/A

Value range:

0-8192

Default value:

N/A

qa_answer_prompt

String

Definition:

QA generation and answer generation prompt.

Constraints:

N/A

Value range:

N/A

Default value:

0-8192

refuse_enable

Boolean

Definition:

Whether to reject certain questions.

Constraints:

N/A

Value range:

• true: Enable answer rejection.

• false: Disable answer rejection.

Default value:

false

refuse_answer

String

Definition:

Rejection answer.

Constraints:

N/A

Value range:

1-8192

Default value:

N/A

image_match_type

String

Definition:

When enabled, the answer will include both text and images from the original documents. There are three image recalling methods:

1. Recall only semantically related images: If an image in the referenced paragraph has semantically related context as the generated text, the image will be recalled. Otherwise, it will not be recalled.

2. All images: Recall all images in the referenced text.

3. AI recall: AI decides what images to recall. The prompt must contain the image description.

Constraints:

N/A

Value range:

• context_match: recalls only semantically related images.

• reference_match: recalls all images.

• model_match: AI decides what images to recall.

Default value:

context_match

custom_types

Map<String,Map<String,String>>

Definition:

Custom structure type.

Constraints:

N/A

Value range:

N/A

Default value:

N/A

directory_enable

Boolean

Definition:

Whether to enable directory management.

Constraints:

N/A

Value range:

• true: Enable directory management.

• false: Disable directory management.

Default value:

false

embedding_search_enable

Boolean

Definition:

Whether to enable vector search.

Constraints:

N/A

Value range:

• true: Enable vector search.

• false: Disable vector search.

Default value:

true

keyword_search_enable

Boolean

Definition:

Whether to enable keyword-based search.

Constraints:

N/A

Value range:

• true: Enable keyword-based search.

• false: Disable keyword-based search.

Default value:

false

keyword_top_k

Integer

Definition:

Top-k for keyword-based search. The value ranges from 0 to 100. The default value is 10.

Constraints:

N/A

Value range:

0-100

Default value:

10

search_engine_type

String

Definition:

Search engine type.

Constraints:

N/A

Value range:

The value can be:

• search_engine: web search engine.

• ai_engine: enhanced web search service.

Default value:

N/A

search_engine_name

String

Definition:

Search engine name.

Constraints:

N/A

Value range:

0 to 64 characters.

Default value:

N/A

think_model_name

String

Definition:

Name of the deep thinking model.

Constraints:

N/A

Value range:

0 to 64 characters.

Default value:

N/A

faq_top_k

Integer

Definition:

Top-k for Q&A and hybrid search where results are not directly from preset FAQs.

Constraints:

N/A

Value range:

0-50

Default value:

2

faq_similarity_threshold

Float

Definition:

Threshold for Q&A and hybrid search where results are not directly from preset FAQs.

Constraints:

N/A

Value range:

0-1

Default value:

0.8

extract_model_name

String

Definition:

Graph extraction model name.

Constraints:

N/A

Value range:

0 to 64 characters.

Default value:

N/A

optimize_model_name

String

Definition:

Name of the graph optimization model

Constraints:

N/A

Value range:

The value cannot exceed 64 characters.

Default value:

N/A

graph_search_enable

Boolean

Definition:

Whether to enable graph search.

Constraints:

N/A

Value range:

• true: Enable graph search.

• false: Disable graph search.

Default value:

false

graph_reference_count

Integer

Definition:

Number of graph search reference documents. This parameter takes effect when graph search is enabled.

Constraints:

N/A

Value range:

1-50

Default value:

10

graph_top_k

Integer

Definition:

Top-k for graph vector recall.

Constraints:

N/A

Value range:

1-500

Default value:

50

graph_keyword_top_k

Integer

Definition:

Top-k for keyword-based graph search.

Constraints:

N/A

Value range:

1-100

Default value:

20

graph_threshold

Float

Definition:

Graph re-ranking threshold.

Constraints:

N/A

Value range:

0-200

Default value:

0.3

number_of_shards

Integer

Definition:

Number of knowledge base index shards.

Constraints:

N/A

Value range:

1-1024

Default value:

3

number_of_replicas

Integer

Definition:

Number of knowledge base index replicas.

Constraints:

N/A

Value range:

0-3

Default value:

1

prompt_id

String

Definition:

Prompt ID.

Constraints:

N/A

Value range:

The value can contain only 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.

Default value:

N/A

qa_question_prompt_id

String

Definition:

QA question generation prompt ID.

Constraints:

N/A

Value range:

The value can contain only 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.

Default value:

N/A

qa_answer_prompt_id

String

Definition:

QA answer generation prompt ID

Constraints:

N/A

Value range:

The value can contain only 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.

Default value:

N/A

mllm_prompt_id

String

Definition:

ID of the mllm prompt.

Constraints:

N/A

Value range:

The value can contain only 1 to 64 characters. Only digits, letters, hyphens (-), and underscores (_) are allowed.

Default value:

N/A

table_rag_config

String

Definition:

Prompts related to tabular enhancement,

including:

chat_prompt_with_sqlresults_id: Q&A prompts for tabular enhancement

nl2sql_prompt_id: prompt for generating SQL statements

table_rag_prompt_id: tabular Q&A prompt

Constraints:

N/A

Value range:

1 to 512 characters.

Default value:

N/A

error_code

String

Definition:

Error Code.

Value range:

N/A

error_msg

String

Definition:

Error message.

Value range:

N/A

error_code

String

Definition:

Error Code.

Value range:

N/A

error_msg

String

Definition:

Error message.

Value range:

N/A

200

Response body of knowledge base details.

400

Incorrect request body parameter.

500

Internal error.