Technical referenceOfficial documentation7 min readReference baseline

FastGPT Retrieval Parameters and Output Baseline

Compare FastGPT v4.17.2 retrieval modes, token limits and empty citation output. Check documented values and conditions before configuration changes.

A fixed-version baseline makes changes easier to investigate: a search-mode change, a citation-volume limit and an empty citation output describe different parts of the retrieval process. The table records behavior explicitly documented for FastGPT v4.17.2. It is a documentation baseline for configuration review, with no measured accuracy or performance result attached.

Values and conditions

ItemDocumented value or formCondition to checkSource section
Search modeSemantic, full-text, hybridCompare modes for the query; they use different retrieval pathsdataset_engine / search modes
Minimum relevanceRange 0–1; no universal default suppliedApplies only to semantic retrieval or retrieval with rerankingdataset_engine / minimum relevance
Citation limitTokensControls cited content volume; a passage count is a different measuredataset_engine / citation limit
Question optimizationReference resolution and query expansionUse supplied context and inspect the resulting subjectdataset_engine / question optimization
Associated knowledge basesOne or moreMultiple associated knowledge bases must use the same embedding modeldataset_search / associated knowledge bases
Citation outputArray; length may be zeroThe empty-output connection can continue; subsequent behavior needs designdataset_search / citation output
Hybrid fusionRRFCombines vector and full-text results; one path score does not define final orderdataset_engine / hybrid retrieval

Read relevance and citation volume separately

Minimum relevance uses a value between zero and one, with the documented applicability limited to semantic retrieval or retrieval with reranking. The range alone does not identify a suitable setting for a specific dataset. Label relevant and unrelated examples before comparing settings. A citation limit uses tokens to control content volume. Counting retrieved passages does not establish whether a complete qualification or exception remains available to the answering stage.

Interpret an empty array at the correct stage

The search node can output an empty citation array and the connected workflow path can continue. This is distinct from an instruction to produce an unsupported answer. Define what the application should do when a query subject is missing, the source document is absent, or indexed evidence was not recalled. A proposed clarification or handoff requires implementation and a responsible receiving path.

Keep a stable comparison

For a configuration review, retain the complete question, selected knowledge bases and cited originals. Compare the search output with the actual input received by the answering stage. Change document content and search configuration in separate runs so that the observed difference can be attributed to the changed condition. Fixed-version source descriptions do not establish resource authorization or determine which business document is current.