黑洞智能体BLACK HOLE AGENTS
Docs

Verify Sources and Recall

Recall testing directly checks whether a question can find the correct snippet, without first passing through the chat model for refinement. It helps you determine whether the issue lies in the source material, parsing, chunking, or retrieval settings.

Prepare Test Questions

It is recommended to cover three types of questions:

  • Precise facts, e.g., "What is the accommodation cap for first-tier cities in China?"
  • Conditional rules, e.g., "Under what circumstances can overseas car rentals be reimbursed?"
  • Easily confused items, e.g., "Who provides additional approval for business trips exceeding $1,000?"

Do not test only with document titles or verbatim sentences from the source, as this overestimates real-world performance.

Complete a Recall Test

1. Open Recall Test

Open the left navigation [Knowledge Base] → Select a knowledge base → Enter [Recall Test].

2. Enter a Real Question

Enter a question with a clear answer and run the test. The question should resemble natural daily phrasing; do not deliberately copy the source text.

3. Check Sources and Snippets

Confirm the source is correct and that the snippet contains both the conditions and the conclusion required for the answer.

Recall Test: enter a real question and inspect matched chunks, sources and relevance (Chinese interface).Recall Test: enter a real question and inspect matched chunks, sources and relevance (Chinese interface).

Recall Test: enter a real question and inspect matched chunks, sources and relevance (Chinese interface).

4. Diagnose Based on Symptoms

If no correct snippet appears, first check the source material, parsing, and chunking. If correct snippets appear but the order is unstable, then consider embeddings, reranking, or Top K.

5. Adjust One Item and Retest

Change only one setting per round. If parsing, chunking, or indexing is involved, execute [Reindex] first, then retest with the same set of questions.

How to Read Results

SymptomDescriptionNext Step
Correct source ranks high, snippet is completeRecall is basically acceptableTest a few different phrasings
No correct results at allMaterial not ready, content missing, large phrasing difference, or threshold too highCheck material, body text, Chunks, and retrieval settings in order
Source is correct but snippet lacks key sentencesParsing or chunking boundaries are suboptimalReview Chunks, adjust, and reindex
Old and new versions appear simultaneouslySame-named materials were all retainedDelete old entries or use [Replace] to re-import
Correct items often rank lowToo many candidates or unstable rankingClean up materials, consider embedding or reranking models
Recall is correct but chat answer is inaccurateIssue is likely in the prompt or chat modelKeep recall settings, adjust the question and chat model

Tuning Loop

Quality tuning loop: check recall with fixed questions, locate issues, adjust individually, re-index, and retest

Fixed questions → Check results → Identify layer → Adjust one item → Reindex if necessary → Retest.

Recommended order:

  1. Confirm materials are correct, with no duplicates or outdated versions.
  2. Check parsed body text and Chunks.
  3. If the phrasing differs significantly from the source, consider the embedding model.
  4. If candidates are roughly correct but the order is unstable, consider the reranking model.
  5. Reindex after adjustments and repeat the same set of tests.

Configuration Notes

SettingProduct DefaultSuggested StartFunctionUse CaseNotes
Test Question Count—3–5Establish a repeatable quality baselineAll knowledge basesCover precise facts, conditional rules, and easily confused questions
Top K6, range 1–50Keep 6 initiallyControl the final number of snippetsBalance between coverage and noiseIncreasing may consume more context
Similarity Threshold0.0, shown only after configuring rerankingStart from 0.0Filter low-score results after rerankingNoise remains after rerankingSetting too high may remove correct snippets
Retest Method—Change one item per roundDetermine where setting changes originateTuning, updating materials or modelsReindex first after modifying chunking or models

Expected Results

  • Correct sources consistently appear in the top few results.
  • Snippets contain the conditions and conclusions needed to answer the question.
  • Results remain stable when using different natural phrasings.
  • No significant regression in fixed questions after updating materials or settings.

User Case

Xiao Lin found that "accommodation standards" could be hit using the original text, but "how much can I claim for hotel stays" was unstable. He first confirmed that the materials and Chunks were normal, then configured the embedding model and retested. After correct snippets appeared but occasionally ranked low, he added a reranking model.

The completion standard is: three different phrasings all find the same accommodation standard in the top few results, and the snippet includes the applicable city and amount cap.

FAQ

No correct snippets at all; should I increase Top K first?

Check the material body text and Chunks first. If parsing or splitting is incorrect, increasing Top K will only return more incorrect or incomplete snippets.

Why is the Similarity Threshold not visible?

The [Similarity Threshold] is only displayed in knowledge base settings after selecting a reranking model.

Recall is correct, but the chat answer is still inaccurate. What should I do?

Keep the current recall settings and check the question phrasing, conversation context, and chat model. At this point, the issue is usually no longer in the material retrieval layer.

Continue Reading

Models and Retrieval Settings
Adjust embeddings, reranking, Top K, and chunking.
Document Parsing and OCR
Handle missing body text, garbled characters, and scanned content.
Use in Conversations
Use the knowledge base for questions after recall is qualified.

On this page