BuildMemory

Verify Knowledge Base Trigger in Calls

View as Markdown

If you are asking, “How do I know if the Knowledge Base was triggered?”, the fastest way is to inspect the call’s action logs.

Check in Call Details

1

Open the call and go to Actions

Open the relevant call, then go to Call Details > Actions.

You should see one or more <knowledge-base-name> Search actions if Knowledge Base retrieval was triggered.

Call Details with Actions tab and KB search entries

2

Open a KB Search action and inspect the request

Click one search action to open details. In the Request payload, confirm fields such as:

  • knowledge_base_id and knowledge_base_name
  • query_from_user
  • rag_use_condition
  • searched_query

These fields show which knowledge base was queried and why search was executed.

KB search action request and return value

3

Inspect the return value for retrieval evidence

In Return value, check:

  • status: "Success"
  • results_count greater than 0
  • similarity scores (for example best_similarity_score)
  • returned results chunks and content

This confirms that retrieval ran and returned matching knowledge snippets.

Expanded KB search return value with results and similarity score

How to interpret what you see

  • If there is no KB search action, the trigger condition was likely not met.
  • If search runs but results_count is 0, retrieval executed but no relevant chunk matched strongly enough.
  • Multiple KB search actions in one call are expected when the agent evaluates several user turns.