Skip to main content

Knowledge Base Sources

The BreakGround AI Agent leverages your connected Knowledge Base sources to provide direct textual answers to end-user questions. When a user asks a question, the bot securely searches the active sources to synthesize an answer before attempting to generate an interactive flow.

You can manage these sources by navigating to AI Agent → Knowledge Base in the dashboard.

Adding a Knowledge Base Source​

From the Knowledge Base list, click Add Source to open the source wizard. BreakGround supports two primary types of knowledge ingestion:

1. Web Crawl​

Provide a starting URL (e.g., your public help center or documentation site). The crawler will automatically map and ingest the pages under that domain.

Configuration fields:

  • Name: A display name for this source in your dashboard.
  • Root URL: The starting point for the crawl (e.g., https://docs.example.com).
  • Max depth: How many links deep the crawler should follow from the Root URL (1-10).
  • Max pages: The maximum number of pages to ingest (1-5000).
  • Include patterns: (Optional) Only crawl URLs that match these path patterns (one per line).
  • Exclude patterns: (Optional) Skip URLs that match these path patterns (one per line).
  • Site: The BreakGround Site this documentation belongs to.

2. Notion Integration​

Connect directly to your Notion workspace to sync specific pages or databases.

Configuration fields:

  • Site: The BreakGround Site this documentation belongs to.
  • Connect: Clicking this begins the Notion OAuth flow. You will be redirected to Notion to select the pages you want BreakGround to access.

Connecting Sources to the AI Agent​

Simply adding a source to your dashboard doesn't automatically make it available to your chatbot. You must explicitly link the sources to the AI agent.

  1. Navigate to AI Agent in the sidebar and open the Builder for your Site.
  2. Select the Knowledge Base Sources tab (next to the General settings tab).
  3. You will see a list of all available sources for this Site.
  4. Check the boxes next to the sources you want this widget to use.
  5. Click Save.

The AI agent will now use these selected sources to directly answer user questions.