Knowledge
The knowledge system lets you provide agents with additional context beyond what they can pull from connected data sources. This context is included when the agent processes your questions, helping it give more accurate and relevant answers.
There are three types of knowledge you can attach to an agent.
Custom Knowledge
Section titled “Custom Knowledge”Custom knowledge is free-form text that you write directly in the agent’s Knowledge tab. It is injected into the agent’s system prompt as additional context every time it processes a question.
Use custom knowledge for:
- Business context — Explain what your product does, who your users are, and what metrics matter most.
- Naming conventions — Document how your team names services, endpoints, database tables, or analytics events so the agent can interpret data correctly.
- Architecture notes — Describe your infrastructure layout, service dependencies, or deployment pipeline so the agent understands how components relate.
- Known issues — Call out known quirks, legacy behaviors, or ongoing incidents that the agent should factor into its analysis.
Custom Knowledge Limits
Section titled “Custom Knowledge Limits”| Plan | Max Size |
|---|---|
| Free | 10 KB |
| Pro | 50 KB |
| Business | Unlimited |
Knowledge Files
Section titled “Knowledge Files”Knowledge files are documents you upload to a shared library and then attach to specific agents. Supported file formats are PDF, TXT, and Markdown.
How File Processing Works
Section titled “How File Processing Works”When you upload a file, it goes through an asynchronous processing pipeline:
- Pending — The file has been uploaded and is queued for processing.
- Processing — The file content is being extracted and indexed.
- Ready — The file is fully processed and available to attach to agents.
You can attach a file to an agent once its status reaches “Ready.”
Attaching Files to Agents
Section titled “Attaching Files to Agents”Files live in a shared knowledge library that is accessible across all your agents. To use a file:
- Upload it in the Knowledge section of OpsTower.
- Navigate to the agent’s Knowledge tab.
- Select the files you want to attach.
Each agent can have its own selection of files, so you can tailor the context each agent receives. For example, a “Backend Debugger” agent might get your infrastructure runbook, while a “Growth Analyst” agent gets your product metrics definitions document.
Knowledge File Limits
Section titled “Knowledge File Limits”| Plan | Max Files per Agent | Max File Size |
|---|---|---|
| Free | 2 | 10 MB |
| Pro | 10 | 10 MB |
| Business | 20 | 10 MB |
Attached Reports
Section titled “Attached Reports”You can attach analytics reports to an agent so it can reference historical data when answering questions. This is particularly useful for Analyst agents that need to compare current trends against past baselines, or for Debugger agents that need to understand whether a metric shift correlates with an incident.
To attach reports:
- Navigate to the agent’s Knowledge tab.
- Select from your existing reports in the attachment section.
Attached reports provide the agent with the report’s data and insights as context, so it can incorporate historical comparisons and trend information into its responses.
Attached Report Limits
Section titled “Attached Report Limits”Each agent can have a maximum of 20 attached reports.