Knowledge Sources
AI Flows that incorporate RAG tools can use external knowledge bases, ticketing systems, user guides, technical manuals, and static organizational documentation to answer questions, provide personalized assistance, and supply contextual information beyond the LLM's built-in knowledge.
Click the Knowledge Sources link in the sidebar to access the UI for creating, indexing, and managing connected knowledge sources.
Adding Knowledge Sources
In addition to the following options, custom implementations are available by request. For more information, contact Bright Pattern Customer Success.
CRM Knowledge Bases
This option is compatible with ServiceNow and MS Dynamics integrations.
- From the Knowledge Sources page, click Create Knowledge Source to open the Create Knowledge Source dialog. The Knowledge Base option is selected by default.
- Enter a name and description.
- Select the desired CRM integration from the Integration Account drop-down menu.
- Select one or more knowledge bases from the Knowledge Bases drop-down menu, or leave blank to select all.
- Select one or more categories from the Categories drop-down menu to filter articles, or leave blank to select all.
- Select the desired Indexing Model. Note: When choosing a model, keep in mind that smaller chunk sizes mean more efficient processing at the expense of context preservation. For example, to minimize token use, you may wish to choose OpenAIVerySmallChunks. Alternatively, to ensure that context is preserved, you may wish to choose OpenAI.
- Use the Chunking Strategy to determine how precisely to split each article into chunks: Full Article, By Heading, By Paragraph, or Fixed Size.
- If Fixed Size is selected, use Number of Words to define chunk size, and Overlap Percent to determine how much context each chunk should preserve from surrounding chunks.
- Optional: Enable Store Content to store a copy of the original content for faster retrieval at run-time.
- Select how often to automatically reindex published content from the Update Frequency drop-down menu: Daily, Weekly, Custom, or Never.
- Finalize knowledge source creation:
- Click Create & Index Now if the knowledge source is ready to be indexed. The new knowledge source will be in the Draft state.
- Alternatively, click Create. The new knowledge source will be in the Draft state, and its indexing status will be Not Initialized.
Ticketing Systems
This option is compatible with Zendesk integrations.
- From the Knowledge Sources page, click Create Knowledge Source.
- Select the Zendesk option.
- Enter a name and description.
- Select the desired Zendesk integration from the Integration Account drop-down menu.
- Use the Retention Period drop-down menu to choose how long to retain this information.
- Select the date to start indexing from the Initial Synchronization From drop-down menu.
- Toggle Index Internal Comments
- Select the desired Indexing Model: OpenAI, OpenAISmallChunks, or OpenAIVerySmallChunks. Note: When choosing a model, keep in mind that smaller chunk sizes mean more efficient processing at the expense of context preservation. To minimize token use, you may wish to choose OpenAIVerySmallChunks. Alternatively, to ensure that context is preserved, you may wish to choose OpenAI.
- Select how often, in minutes or hours, to automatically reindex published tickets from the Update Frequency drop-down menu.
- Finalize knowledge source creation:
- Click Create & Index Now if the knowledge source is ready to be indexed. The new knowledge source will be in the Draft state.
- Alternatively, click Create. The new knowledge source will be in the Draft state, and its indexing status will be Not Initialized.
Static Files
- From the Knowledge Sources page, click Create Knowledge Source.
- Select the Static option.
- Enter a name and description.
- Drag and drop or click to add files. Alternatively, select Static Text, then enter knowledge content into the Text field. Note: Maximum total file size is 400KB.
- Press Create.
Knowledge Source Actions
Click the Actions button to the right of a table row to perform the following actions.
| Action | Description | Notes |
|---|---|---|
| Publish | Make a draft Knowledge Source available to AI Flows by moving it to the Published state. | Knowledge Source must have completed at least one index cycle, if applicable. |
| Unpublish | Make a published Knowledge Source editable by moving it to the Draft state. | Only appears for published Knowledge Sources. |
| Clone | Create a draft Knowledge Source named Copy of <Name> that is identical to the original Knowledge Source. | If the original Knowledge Source is in the Published state, this option will instead read Clone as Draft. |
| Run Indexing | Click to index the selected Knowledge Source using the configured indexing model and chunking strategy. Its indexing status will change to Processing. | Available for Zendesk and Knowledge Base sources. |
| Index Details | Click to view all documents and chunks in this Knowledge Source, its current indexing status, and timestamps for the first, last, and next scheduled indexing runs. Click Errored Only to filter the list by errored results. | Available for Zendesk and Knowledge Base sources. This dialog is also accessible by clicking on the status chip in the Index column. |
| Delete | Click to remove the selected Knowledge Source and all its indexed data from AI Agent 2.0. | Unavailable for Published knowledge sources. |