Skip to main content
The Knowledge Base is where you tell Athena the verified facts about your business - your pricing, products, policies, positioning - so that everything Athena writes about you stays consistent and accurate. Once it’s set up, Athena draws from the Knowledge Base whenever it researches, generates, optimizes, or fact-checks your content. Note: The Knowledge Base is included in some plans and not others. If your plan doesn’t include it, you’ll see a Feature locked screen when you try to open it. Reach out to your Athena account team if you’d like access.

​
What the Knowledge Base does

Think of the Knowledge Base as the source of truth Athena consults whenever it needs to know something specific about your business. It does three things:
  • Stores verified facts. Statements like “Our Pro plan starts at $99/month” live in the Knowledge Base as source-backed entries, grouped under pillars.
  • Tracks your internal pages. It maintains a list of pages on your own domain so Athena knows what content of yours already exists and can recommend internal links when writing or optimizing content.
  • Measures content coverage. It shows you how well your existing content already covers each pillar, so you can see where to invest in new articles.
Every fact in the Knowledge Base traces back to a source - Athena doesn’t make things up. It only uses claims that you’ve added directly or that came out of a source you provided.

​
How it’s organized

There are two things in the Knowledge Base:
  • Pillars - subject areas your brand wants to be the authority on (for example, Pricing, Integrations, Onboarding, a specific product category, or your Return policy). Each pillar groups together the related facts Athena has learned. You can create pillars yourself, or let Athena discover them automatically.
  • Internal links - pages on your own domain that Athena should know about when generating or optimizing content. Adding more of your own pages here means Athena has more places to link to internally.
Each pillar has its own detail view where you can see the claims attached to it, the internal pages associated with it, and a synthesized summary document Athena builds from those claims.

​
Finding the Knowledge Base

The Knowledge Base is its own left-sidebar item - click Knowledge Base in the sidebar to open it. Inside, you’ll see these tabs:
  • Pillars - every pillar Athena knows about for your site, with a Content coverage bar showing how well your existing content covers each one.
  • Internal links - every page on your own domain that’s been added to the Knowledge Base.
  • Unfiled facts - facts that are not attached to a pillar. This tab appears when unfiled facts are available.
The page header contains these controls:
  • Verify facts - runs a validation analysis (see Verifying facts against the outside world below).
  • Add knowledge - the entry point for adding new pillars, new claims, or new internal links.
  • Review pending - appears when extracted claims need your review before they count toward published pillars.

​
Setting it up

The fastest way to bootstrap a Knowledge Base from nothing is to let Athena do the initial research for you.
  1. Open Knowledge Base from the sidebar.
  2. Click Add knowledge > Discover pillars.
  3. Confirm the research run.
Athena will analyze your site, propose a set of pillars relevant to your business, research each one, and start populating it with claims. This runs in the background; pillars appear in your Pillars tab as they’re discovered, and claims continue to populate over the following minutes. Review the extracted facts and their sources before relying on them. Athena holds back claims it cannot verify, including low-confidence extractions, third-party claims, and comparisons with competitors. Use Review pending to approve or reject those claims.

​
Adding more knowledge over time

Everything you can add lives under the Add knowledge dropdown, organized into two groups: Pillars
  • Create pillar - define a new subject area Athena didn’t auto-discover. Give it a name and a short description.
  • Discover pillars - let Athena auto-discover pillars relevant to your site (the same flow used during initial setup).
Knowledge
  • Add URLs - paste URLs or crawl a domain. Athena adds the pages to your internal link bank and also extracts claims from them.
  • Upload document - extract claims from a PDF, DOCX, or pasted text.
  • Extract from Content Hub - pull claims from articles you’ve already published.
You can also add claims directly to a specific pillar by opening that pillar and using the Add knowledge options inside its detail view - anything you ingest from inside a pillar is automatically attached to it.

​
Finding and reviewing facts

Use Search pillars and claims on the Pillars tab to find pillar names and approved claims across your Knowledge Base. Click a matching claim to open its detail. Pending claims have their own search under Review pending; they do not appear in approved-claim search results. To review extracted claims:
  1. Click Review pending in the Knowledge Base header.
  2. Filter by confidence, source, or pillar, or use Search claims.
  3. Read the claim and its supporting source.
  4. Choose Approve to include it in its pillar, Reject to keep it out, or Delete to remove it. File an unfiled claim under a pillar before approving it.
You can select several visible claims and approve them together. Select all matching extends selection across pages for rejection or deletion; approval works on the selected page because each claim is approved into its own pillar. Rejected claims stay hidden and are not re-imported by future research. Deleted claims are removed permanently and can be re-imported by a later research run. Confirm the selected scope before deleting.

​
Keeping facts current

Open a claim and choose Edit claim to update its text or source details. Changing the text archives the previous fact and creates a replacement, preserving the evidence used by earlier content. Use Archive for a fact that was true but should no longer guide new content. You can find it in the pillar’s Archived tab and restore it later. Use Reject for an incorrect claim; use Delete only when you want to remove it permanently. In Internal Links, use a page’s Re-check dropdown to choose Weekly, Monthly, or Off. Athena reads scheduled pages again and updates their facts when the source changes. You can enable recurring checks for up to 25 links per website. Turn one off before enabling another if you reach that limit.

​
Verifying facts against the outside world

Open Knowledge Base > Verify facts, select the pillars to check, and start the analysis. This feature requires Oracle access. Athena checks your facts for contradictions in external sources and for inconsistencies within your Knowledge Base. Progress and results now stay in Knowledge Base. When the run finishes, click View results. The results drawer groups contradictions by source domain; its Knowledge Base group represents internal inconsistencies. Open a finding to review the conflicting statements and follow its fact link to the relevant Knowledge Base claim. If your fact is outdated, edit it in the Knowledge Base. If the external source is wrong, use the evidence to plan a correction to your own content or outreach to that source. Reviewing a finding does not itself change an external website or an AI model’s answers.

​
How Athena uses the Knowledge Base

Once your Knowledge Base has some content in it, it shows up across the rest of Athena:
  • When Athena optimizes a piece of content. The optimize view tells you exactly which pillars, claims, and internal links Athena pulled from while suggesting edits - each suggestion can show the supporting claim and its confidence.
  • When Athena drafts or edits content. AI-attributed claims in the article body appear as highlights - clicking one shows the source and the pillar it came from in the right sidebar.
  • In suggestion citations. Each AI suggestion that depends on a claim shows the claim, its pillar, and a link to the source.
  • In Oracle. Oracle compares what AI search engines say about your brand against your Knowledge Base and flags discrepancies - your Knowledge Base is the source of truth it’s checking against.
  • In Athena Agent columns in the Content Hub. When you set up an Athena Agent column, you can toggle on the Knowledge Base option to make the column pull from the Knowledge Base.
The short version: anywhere Athena needs to make a factual claim about your business, it reaches into the Knowledge Base first.

​
Using the Knowledge Base through the API

The Knowledge Base is also accessible programmatically, over the REST API and as MCP tools:
  • Search Brand Facts — semantic search over approved facts (search_brand_facts on MCP).
  • Get Brand Facts — paged fact listing with filters (get_brand_facts).
  • Get Pillars — pillar catalog with fact counts (get_pillars).
  • Get Pillar Document — a pillar’s synthesized markdown document (get_pillar_document).
  • Add Brand Facts — bulk fact ingestion through the full pipeline, with a per-fact outcome report (add_brand_facts). Requires a website-admin key.
  • Update Brand Fact - update one fact’s text, source URL, or confidence (update_brand_fact). Requires a website-admin key.
  • Delete Brand Facts - permanently delete 1-50 facts, no undo (delete_brand_facts). Requires a website-admin key; on OAuth connections, the admin role.
  • Create Pillar - get-or-create a pillar by name (create_pillar). Requires a website-admin key.
  • Update Pillar - rename a pillar, edit its description, or publish/archive it (update_pillar). Requires a website-admin key.
  • Delete Pillars - permanently delete 1-20 pillars and every fact filed under them, no undo (delete_pillars). Requires a website-admin key; on OAuth connections, the admin role.
  • Merge Pillars - fold source pillars into a published target, then delete the sources (merge_pillars). Requires a website-admin key.
  • Move Brand Facts - file 1-50 facts under a published pillar, including unfiled facts (move_brand_facts). Requires a website-admin key.
These endpoints require the Knowledge Base to be enabled for your organization; when it isn’t, they return a 403.

​
Content coverage

Each pillar in the Pillars tab has a Content coverage bar. It shows what percentage of that pillar’s facts are reflected in articles you’ve already published. A higher bar means you have content covering most of what Athena knows about that pillar; a lower bar (or a dash) means you’ve got facts in your Knowledge Base that no published article currently covers - usually a content gap worth filling. Coverage updates as Athena indexes new content. It’s a guide for spotting where to invest in writing next.

​
Frequently asked questions

​
Do I have to set up the Knowledge Base manually?

No. The fastest path is Add knowledge > Discover pillars, which has Athena research your site and propose pillars, claims, and supporting evidence on its own. You can refine and add to it from there.

​
Where does the Knowledge Base get its facts from?

Athena extracts facts from a few different places: web research it runs on your site, documents or URLs you upload, articles already in your Content Hub, and AI search responses that mention your brand. Every claim records its source so you can see where it came from.

​
What’s the difference between an internal link in the Knowledge Base and an article in the Content Hub?

The Content Hub is where you track and measure the performance of pages you care about (your blog posts, key landing pages, etc.). The Knowledge Base’s internal links are a broader set of pages on your own domain that Athena should be aware of when writing or optimizing content - they don’t have to also be in the Content Hub.

​
Why does my content coverage show a dash (-)?

A dash means there’s no coverage data yet for that pillar - usually because the pillar doesn’t have any claims yet, you don’t have matching Content Hub articles, or coverage analysis hasn’t run yet. It’ll fill in as Athena indexes more content.

​
How do I delete a pillar?

Open the Pillars tab, select the pillar with the checkbox, and use the action bar that appears at the bottom of the page to delete it. Deleting a pillar also deletes the claims attached to it.

​
What does “Verify facts” do?

It checks selected pillars for external contradictions and internal inconsistencies. Open View results in Knowledge Base to review the findings and their linked facts.

​
How does the Knowledge Base interact with Oracle?

Oracle uses the Knowledge Base as the ground truth for fact-checking. When Oracle scans AI search responses for discrepancies, it’s comparing them against what you’ve told Athena is true via the Knowledge Base. The richer your Knowledge Base, the more Oracle has to work with.

​
My plan doesn’t include the Knowledge Base - what can I still do?

You’ll see a Feature locked screen when you open the Knowledge Base, and a few related features (like the Knowledge Base toggle on Athena Agent columns) will be hidden. The rest of Athena continues to work normally. Reach out to your Athena account team if you’d like to add the Knowledge Base to your plan.
If you have a question that isn’t covered here, reach out to your Athena account team or contact support - we’re happy to walk through Knowledge Base setup or any specific workflow live.