Knowledge Bases
Knowledge bases give your agents your own content to answer from. This page shows how to build knowledge groups from your connected sources, attach them to agents, and set up the workspace style guide and agent system prompt.
All of these live in the sidebar under Automation > AI Agents, on the Knowledge tab. The tab has three sections:
| Section | What it is |
|---|---|
| Agent System Prompt | Shared instructions added to every agent's instructions |
| Style Guide | The tone and writing style your agents follow |
| Knowledge Groups | Sets of your synced data that agents search when they respond |
Create a knowledge group
A knowledge group is built from data Outrun has already synced from your connected sources. You cannot upload files to it directly. To use documents, keep them in a connected source, such as a GitHub repository, first. See sources.
- On the Knowledge tab, under Knowledge Groups, select Create Group.
- In 1. Select Data, choose:
- Sources: the sources to include. If you select none, all sources are included.
- Data Types: Documents & Files (selected by default), Files, Messages, Activities, Tasks, Projects, Contacts, Companies, Cases or Conversations.
- File Types:
.md,.html,.txt,.json,.ts,.js,.py,.yaml,.tsx,.css,.docx,.pdf,.xlsx,.pptx,.png,.jpgor.jpeg. None are selected by default, which includes every file type; select some to narrow the group. - Include Folders (optional): comma-separated folder paths. Only files inside these folders are included, for example
docs/, help/.
- Select Continue. In 2. Configure, enter a Name and an optional Description, and choose a Chunking Strategy: Paragraph, Fixed Size or Semantic.
- Select Continue. In 3. Review, check the settings and select Create Knowledge Base.
Outrun starts building the knowledge group straight away. Building can take a few minutes.
Check and refresh a knowledge group
Open a knowledge group from the Knowledge tab to see its Documents, Chunks, Last Synced time and Source Filters.
- To test what agents will find, enter a query under Search Test and select Search.
- To pick up content that changed in your sources, select Rebuild. A rebuild adds records changed since the last build. Knowledge groups do not refresh on their own.
Attach knowledge groups to an agent
- Go to Automation > AI Agents and open the agent.
- In the Knowledge card, select the knowledge groups the agent should use.
The agent searches every attached group when it responds. You can also choose a knowledge base when you create an agent, in the 2. Knowledge & Permissions step.
Set up the agent system prompt
The agent system prompt is shared context, such as who your company is and what you sell. Outrun adds it to the instructions of every agent in the workspace.
- On the Knowledge tab, under Agent System Prompt, find Company Identity & Context and select Configure (or Edit if a prompt exists).
- Write the prompt and select Save. The "saved" message appears only after Outrun has stored the prompt. If you do not have permission to change workspace settings, you see "Failed to save" and the prompt is not changed.
Keep it factual: your company name and what it does, your products and plans, and the tone your agents should use. Each agent's own instructions are added on top of it.
Set up the style guide
Each workspace has one style guide. Open it from the Style Guide section of the Knowledge tab and choose a Mode:
- Auto (AI-generated): Outrun writes the style guide from your communications and from reviewers' feedback on drafts. Select Re-distill to regenerate it.
- Manual: write the guide yourself in Style Guide Content, then select Save.
The style guide applies to every agent. To stop an agent using it, open the agent and turn off Use organization style guide.
Best practices
- Keep documents focused. Short documents on one topic are easier for agents to match to a question than long documents covering many topics.
- Scope large repositories. Use Include Folders so a knowledge group holds only the folders that matter, such as
docs/. - Rebuild after changes. After you update documents in a source, wait for the source to sync, then select Rebuild.
- Review agent drafts. Use human-in-the-loop review to correct drafts. Corrections become examples for that agent.