Radiant Knowledge Library
Teach your AI assistant how your business actually works — your terminology, your metrics, your conventions — so every answer is accurate, not generic.
The Radiant Knowledge Library is Upside's system for storing the facts that make your organization unique. It ensures that every AI-powered answer reflects your data conventions, your metric definitions, and your business context — not generic assumptions.
In short: Radiant is a shared company playbook that your AI assistant consults behind the scenes, so it gets the details right every time.
Why Radiant Exists
AI assistants are powerful, but they don't know the specifics of your business. Without guidance, they make reasonable-sounding assumptions that can lead to silently wrong answers:
How It Works
When you ask a question via the Upside MCP, the Radiant Librarian — a coaching layer built into Upside — automatically checks your Knowledge Library for relevant context before the AI writes any query or generates an answer.
| Step | What happens |
|---|---|
| 1 | You ask a question in your AI tool |
| 2 | Your AI tool sends the request to the Upside MCP |
| 3 | The MCP consults the Radiant Librarian, which returns org-specific guidance |
| 4 | The MCP queries your data using that guidance |
| 5 | You get back an accurate, context-aware answer |
The Librarian coaches — it doesn't execute. It provides guidance to your AI tool about which fields to use, which filters to apply, and which conventions matter. Your AI tool does the actual work, but now with the right instructions.
What Goes Into the Knowledge Library?
Knowledge entries capture facts that meet a simple test: Would an AI get this wrong without being told? If a reasonable assumption leads to a silently incorrect answer, it belongs in Radiant.
Metric definitions & revenue fields
How your organization calculates key metrics, and which data fields to use. This prevents the AI from picking a plausible-looking field that actually gives wrong numbers.
Examples:
- "For pipeline analysis, use the deal amount field — our ARR field is only populated on closed and renewal deals, not open pipeline."
- "Revenue has multiple components: platform fees, professional services, and add-on products. Don't sum them unless asked for total contract value."
- "When someone asks about 'deal size,' they mean total deal value. When they ask about 'ARR,' they mean the recurring portion on closed deals only."
Time & calendar conventions
Fiscal year boundaries, quarter definitions, and labeling conventions. Without this, the AI defaults to calendar year — and every time-based answer is wrong.
Examples:
- "Our fiscal year starts in February. FY2027 runs Feb 2026 – Jan 2027."
- "Fiscal year labels use the end-year, not the start-year. So 'FY2027 Q1' means Feb–Apr 2026."
- "Quarter boundaries: Q1 = Feb–Apr, Q2 = May–Jul, Q3 = Aug–Oct, Q4 = Nov–Jan."
- "When someone says 'this quarter' they mean the current fiscal quarter, not the calendar quarter."
Classification & filtering rules
How entities are categorized in your CRM, especially where labels are misleading. This is critical because CRM fields often don't mean what they appear to mean.
Examples:
- "The 'Customer' type field doesn't capture all real customers. Filter by accounts that have a provisioned org ID for an accurate count."
- "Stage names like 'Discovery' appear in both New Business and Expansion pipelines. Always filter by record type when analyzing stages."
- "We have two terminal-loss stages: 'Closed Lost' and 'Rejected.' They use different reason fields — don't mix them up."
- "Account type is unreliable for segmentation — nearly half of accounts have no type assigned."
Source system boundaries
Which data comes from which system, and what each system covers. Many organizations use multiple CRMs and tools, and each has only part of the picture.
Examples:
- "Meeting data spans three sources: CRM events, call recording tools, and marketing automation. Querying just one gives an incomplete count."
- "All email marketing engagement comes from our marketing automation platform. Event campaigns come from the CRM. Don't look in one system for the other's data."
- "Person records are unified from multiple sources — marketing contacts, CRM leads, CRM contacts, and call participants. Filtering by one source silently excludes people known only through the others."
Terminology & naming conventions
Internal shorthand, abbreviations, and team-specific language that the AI wouldn't know without being told.
Examples:
- "'PS' in opportunity titles stands for 'Professional Services' — it's a product line, not a generic abbreviation."
- "When the team says 'pipeline,' they mean open New Business opportunities. Renewals are tracked separately."
- "'Partner program' refers to our co-sell motion with channel partners — not a technical integration partnership."
- "'The webinar' without further context refers to our flagship quarterly industry event, not a one-off session."
Data quality caveats
Known gaps, quirks, or traps in your data. These are the facts that save the AI from producing answers that look right but are subtly wrong.
Examples:
- "Lead source is NULL on the vast majority of opportunities — don't use it for attribution. Use the touchpoint data instead."
- "Account source mostly reflects data-enrichment vendors, not marketing channels. It doesn't answer 'where did this account come from.'"
- "Event engagement is split across multiple sub-channels (conferences, dinners, meetups, etc.). Querying a single event type won't capture the full picture."
- "All our revenue data is in USD. Don't add currency conversion logic."
Your AI's Memory vs. Radiant
Most AI tools you use with Upside have their own memory systems. Understanding how these interact with Radiant helps you get the best results.
They're complementary. Your AI tool brings its understanding of you — your preferences and recent context. Radiant brings its understanding of your organization — your metrics, terminology, and data conventions. Together, you get answers that are both personally relevant and organizationally accurate.
You don't need to re-teach your AI things that are already in Radiant. If your team has added a knowledge entry about how pipeline is calculated, every MCP user benefits automatically — no need for each person to explain it in their own conversations.
Managing the Knowledge Library
Who Can Do What
| Role | Create entries | Publish to library | Consult library |
|---|---|---|---|
| Any MCP user | ✓ | ✓ | |
| Upside admin | ✓ | ✓ | ✓ |
Any user can draft a knowledge entry, but entries don't become active until an admin reviews and publishes them. This keeps the library accurate and consistent.
Three Ways Entries Are Created
🤖 Agent-discovered
While answering questions, the AI discovers a surprising fact about your data and proposes saving it for future sessions.
👤 Manually added
A team member creates an entry directly — either through the Upside dashboard or by asking their AI tool to save a fact to the library.
⛏️ Automatically mined
Upside analyzes patterns across sessions and surfaces recurring facts that should be captured as permanent entries.
How Publishing Works
Radiant uses versioned snapshots to keep your library stable and auditable:
- New entries are added to a draft version of the library
- An admin reviews and activates the new version
- The Librarian immediately begins using the updated library
- Previous versions are preserved — you can always roll back
Radiant is read-only for the AI. It can consult knowledge entries to provide better answers, but it cannot modify or delete entries without human review and admin approval.

