> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botcadence.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search knowledge base

> Answer from project sources during the conversation

**Search knowledge base** lets the agent use your project sources. You choose whether the agent calls search when it needs to, or whether matching snippets are added before every reply.

## Prerequisites

* Content in the project [Knowledge Base](/docs/build/knowledge-base)
* Permission to edit the workflow

## Enable

<Steps>
  <Step title="Open Tools">
    Open the workflow, select an **Agent**, **Supervisor**, or **Task**, then open **Tools**.
  </Step>

  <Step title="Turn it on">
    Under **Knowledge**, enable **Search knowledge base**.
  </Step>

  <Step title="Choose retrieval">
    In **Configure Search knowledge base**, pick:

    * **Agent calls when needed** — the agent decides when to search.
    * **Auto-retrieve each turn** — relevant knowledge is added before every reply. The agent does not call the tool.
  </Step>
</Steps>

<Check>
  The tool is on. Ask something only your sources cover, and confirm the reply uses that content.
</Check>

## In the conversation

The agent answers from your sources instead of guessing. Auto-retrieve keeps search off the tool list but still injects context each turn.

<Note>
  Empty or stale sources produce weak answers. Update the knowledge base, then test again.
</Note>