Skip to main content

​
Setting Up Your Knowledge Base

This guide walks you through setting up and populating your AccelOS Knowledge Base.

​
Prerequisites

  • Admin role in your AccelOS organization
  • At least one integration connected (recommended)

​
Step 1: Access the Knowledge Base

1

Navigate to Knowledge

From the AccelOS sidebar, click Knowledge.
2

View the Knowledge Base

You’ll see the knowledge base interface with:
  • Document list on the left
  • Editor/viewer on the right
  • Category filters at the top

​
Step 2: Create Your First Document

1

Click New Document

Click the New button or + icon.
2

Choose a Template

Select a template based on what you’re documenting:
  • Alert Runbook - For alert-specific procedures
  • Integration - For service-specific knowledge
  • Generic Instruction - For general procedures
3

Fill in Details

Enter:
  • Title: A clear, searchable name
  • Category: Confirm or change the category
  • Integration (optional): Link to relevant integration
  • Alert Name (optional): Associate with specific alert
4

Write Content

Use the markdown editor to write your document. Include:
  • Clear problem description
  • Step-by-step procedures
  • Commands and expected outputs
  • Escalation criteria
5

Save

Click Save to store your document. It’s immediately available to the AI agent.

​
Step 3: Organize Your Content

​
Categories

Organize documents by type:
CategoryUse For
Alert RunbooksAlert-specific procedures
IntegrationsService/tool-specific knowledge
Generic InstructionsTeam-wide procedures
MemoriesInvestigation learnings

​
Folders

Create folders to organize by:
  • Service or team
  • Environment (production, staging)
  • Integration type
For maximum value, link documents to your integrations:
1

Edit Document Metadata

Open a document and click Edit Metadata or edit the frontmatter.
2

Select Integration

Choose the relevant integration from the dropdown.
3

Add Alert Name (Optional)

For runbooks, specify the exact alert name this document addresses.
4

Save

The AI agent will now prioritize this document when investigating related alerts.
Start with these high-value documents:
Document your most frequent alerts:
  1. Identify your 5 most common paging alerts
  2. Create a runbook for each
  3. Include symptoms, investigation steps, and remediation
  4. Link to the corresponding integration/alert
Create a document describing your system:
  • Key services and their responsibilities
  • Dependencies between services
  • Common failure modes
  • On-call contacts for each area
Document your incident process:
  • Severity definitions
  • Communication channels
  • Escalation procedures
  • Post-incident review process

​
Importing Existing Documentation

If you have existing runbooks in other systems:

​
From Confluence/Notion

  1. Export documents as markdown
  2. Copy content into AccelOS knowledge base
  3. Update formatting and add metadata
  4. Link to relevant integrations

​
From Git Repositories

If you have runbooks in a repo:
  1. Copy markdown files into AccelOS
  2. Add frontmatter metadata
  3. Organize into appropriate categories
You don’t need to migrate everything at once. Start with your most critical runbooks and expand over time.

​
Verification

Test that your knowledge base is working:
  1. Open the Investigations panel
  2. Ask about an alert you’ve documented: 
    How should I handle a HighCPUUsage alert?
  3. The agent should reference your runbook in its response

​
Next Steps

Knowledge Base Overview

Learn about all knowledge base features.