Knowledge Base

​

Purpose

The Knowledge Base is the central repository for the facts and approved claims that Athena uses to write and verify your content. By organizing your brand’s knowledge into specific topics and providing trusted source material, you ensure that Athena’s AI generates accurate, on-brand messaging every time. This page allows you to browse, organize, and manage your entire fact bank. You can build content “pillars” (core topics), monitor the web pages and documents Athena is extracting facts from, and review or re-file facts that haven’t been assigned to a specific topic yet.

​

What’s on the page

Page header The top of the page displays the “Knowledge Base” title alongside primary action buttons to review pending claims, verify your facts against AI search engines, and a dropdown menu to add new knowledge to your fact bank. Pillars tab The default view showing a table of your content pillars (topics). If Athena detects pillars with identical names, a “Duplicate pillars” warning callout appears at the top of the tab, offering a quick way to merge them. Internal links tab A view dedicated to managing the specific web pages (URLs) you have added or that Athena has crawled. It shows the status of each page and how many facts have been successfully extracted from it. Unfiled facts tab Only visible if you have approved claims that aren’t attached to any published pillar. This is a paginated, searchable list of facts, filterable by source type (Research, Uploads, Content hub). Pillar detail dialog Clicking a pillar opens a deep-dive dialog with multiple tabs:

• Claims: Every fact attached to this pillar, filterable by review status (All, Pending, Approved) or by specific source.
• Sources: A summary of where the approved facts in this pillar came from (URLs, uploaded documents, AI responses).
• Pages: Internal pages from your site linked to this pillar.
• Document: The synthesized summary document generated from the pillar’s approved facts.
• Matching articles: Existing content from your site that already covers this pillar’s claims.

​

Pillars table

Lists every content pillar for the website with coverage and review status.

• (checkbox): Select a pillar for bulk actions (Edit, Refresh, Export CSV, Merge, Delete, Verify facts).
• Pillar: The pillar’s name and optional description. If claims are awaiting review, a yellow “pending” badge appears here. Tooltip: Content pillars that group related claims and measure content coverage
• Content coverage: A progress bar showing the percentage of the pillar’s claims covered by your existing published content. Tooltip: Percentage of a pillar’s claims covered by your existing content

​

Internal links table

Lists crawled or manually added link-bank URLs for the website.

• (checkbox): Select a link for bulk actions (Refresh, Delete).
• URL: The link’s web address. Clickable to open the page in a new tab.
• Title: The page title captured when the link was scraped (shows an em-dash if no title was found).
• Facts: The count of facts (claims) extracted from this link. Clicking the numbered badge opens the source-link claims dialog.
• Status: The current processing status of the link (e.g., indexed, scraped, pending, failed).

​

Bootstrap from Content Hub table

Appears inside the “Extract from Content Hub” dialog when adding knowledge.

• (checkbox): Select the article to include in your extraction batch.
• Title: The article’s title and source URL.
• Description: A short snippet summarizing the article.
• (open link): An arrow icon that opens the article in a new tab.

​

Unfiled facts list

Appears in the Unfiled facts tab. Shows approved claims with no published pillar attached, excluding facts generated by Oracle analysis (those are never listed here).

• (checkbox): Select a fact for bulk actions (Move to pillar, Delete).
• Fact text + metadata: Displays the claim text, a badge indicating the source type (e.g., Upload, Web research), a confidence rating badge, the date it was added, and a link to the original source. If the fact is used in existing content, a “Used in N articles” chip appears.

​

Pillar detail. Claims tab

The first tab inside the Pillar detail dialog.

• (checkbox): Select a claim for bulk actions (Approve, Reject, Change pillar, Delete).
• Claim text + source chip: The text of the fact. If pending, it shows a “Pending review” note with a confidence rating. Also includes a source favicon/link or a typed badge (e.g., “Upload”), and a usage chip if the fact grounds any existing content.

​

Drilldowns

• Click a pillar row: Opens the Pillar Detail dialog, revealing Claims, Sources, Pages, Document, and Matching articles tabs for that specific pillar.
• Click a fact-count badge in the Internal links table: Opens the Source Link Claims dialog, showing the pillars linked to that URL and a list of every fact extracted from it, with the ability to delete individual facts.
• Click a “Used in N articles” chip: Opens a hover card listing the titles of the articles grounded by this fact. Clicking a title navigates to the content editor (/content).
• Click a claim row (in pillar detail or unfiled facts): Opens the Claim Detail dialog, displaying the full claim text, an evidence quote (if available), the source badge or link, the confidence score, and a link to view the AI response if the fact was sourced from one.
• Click a Sources-tab row in pillar detail: Switches back to the Claims tab, filtering the list to show only the approved facts belonging to that specific clicked source.

​

What you can do here

• Review N pending: Navigates to the review queue to review pending claims. (Only shown when pending claims exist).
• Verify facts: Opens the verification form dialog to select pillars and start fact verification against AI responses. Starting this navigates you to the Oracle page.
• Add knowledge (dropdown) → Create pillar: Opens a dialog to name and describe a new pillar, with an optional toggle to auto-research it immediately.
• Add knowledge (dropdown) → Discover pillars: Opens a confirmation dialog to kick off a website-wide pillar discovery and research workflow.
• Add knowledge (dropdown) → Add URLs: Opens a dialog where you can paste URLs or enter a domain path to crawl. You can choose to add them to your link bank and/or extract claims from them.
• Add knowledge (dropdown) → Upload document: Opens an upload dialog (with File and Text tabs) to extract claims from a PDF, DOCX, or pasted text.
• Add knowledge (dropdown) → Extract from Content Hub: Opens a dialog to select published Content Hub articles and extract claims from them. (Note: this costs credits).

Pillars bulk actions (visible in the command bar after selecting rows):

• Edit (1 selected): Opens a dialog to rename the pillar or edit its description.
• Refresh: Re-associates pages and regenerates synthesis documents for the selected pillars. Confirmation: Re-associates pages and regenerates synthesis docs for the selected pillars. May take a few minutes.
• Export CSV: Downloads a CSV file of all facts belonging to the selected pillars.
• Merge (2+ selected): Opens a dialog to pick one target pillar and merge the others into it. This is a destructive action that deletes the unselected source pillars.
• Delete: Permanently deletes the selected pillars and all their associated claims. Confirmation: All claims for these pillars will be deleted.
• Verify facts: Opens the Verify Facts dialog, pre-scoped to the selected pillars (only published pillars with claims are eligible).
• Reset: Clears your current checkbox selection.

Duplicate Pillars Callout:

• Merge duplicates: If Athena detects pillars with the exact same name, clicking this opens a batch-merge dialog to fold them into the oldest published version of that pillar, complete with progress feedback. This is a destructive action.

Internal links bulk actions (visible in the command bar after selecting rows):

• Refresh: Re-scrapes the URL and re-extracts facts. Confirmation: Re-scrapes the URL and re-extracts facts. Existing duplicates are kept; new facts are routed to pillars.
• Delete: Opens a cascade-preview confirmation dialog showing exactly which facts will be deleted alongside the links, grouped by pillar. Confirming permanently deletes the links and their sourced facts.
• Reset: Clears your current link selection.

Internal links row actions:

• Delete fact (trash icon inside Source Link Claims dialog): Permanently deletes a single fact sourced from a specific link. Confirmation: It will be removed from the [pillar] pillar. This can’t be undone.

Unfiled facts bulk actions (visible in the command bar after selecting rows):

• Move to pillar: Opens a picker to file the selected facts under a published pillar.
• Delete (selected): Permanently deletes the selected unfiled facts. Confirmation: Deleted facts stop feeding content generation. This can’t be undone.
• Delete all N: Loops through and deletes every single unfiled fact that matches your active source filter until the bucket is empty. Confirmation: Every unfiled fact for this website will be permanently deleted. This can’t be undone. (or filter-scoped variant)
• Reset: Clears your current fact selection.

Pillar detail dialog actions:

• Kebab menu (three dots) → Edit: Opens the Edit Pillar dialog.
• Kebab menu (three dots) → Refresh: Starts the refresh and resynthesis workflow for this specific pillar.
• Kebab menu (three dots) → Export facts (CSV): Downloads a CSV of this pillar’s facts.
• Kebab menu (three dots) → Delete: Permanently deletes the pillar and all its claims.
• Expand/Collapse (diagonal arrows): Toggles the dialog size between a wider view and the default size.

Pillar detail Claims tab actions:

• Approve / Reject (selected pending): Available in the command bar when pending claims are selected. Approves or rejects them.
• Change pillar: Available in the command bar when claims are selected. Opens a picker to re-file the selected claims to a different published pillar.
• Delete (selected): Permanently deletes the selected claims.
• Approve all pending: A quick action button to approve every pending claim within the pillar at once.
• Add knowledge menu: Available in the empty state. Allows you to upload documents, paste text, import URLs, extract from Content Hub, or import a CSV directly into this pillar.

Other dialog actions:

• AddUrlsDialog → Add N URLs: Confirms adding the URLs to the link bank or extracting claims.
• UploadDialog → Extract claims: Starts the extraction process for the uploaded file or pasted text.
• BootstrapDialog → Extract from N article(s): Confirms extracting claims from selected Content Hub articles.
• AddKnowledgeDialog (CSV tab) → Download template: Downloads a claims_template.csv file to help you format a manual CSV import.
• CreateTopicDialog → Create: Creates the new pillar and optionally kicks off auto-research immediately.
• ConfirmResearchDialog → Start research: Starts the website-wide pillar discovery and research workflow.
• EditPillarDialog → Save: Saves the updated name and description. (Athena will reject the save if the new name collides with an existing pillar).
• EditClaimDialog → Save: Updates a specific claim’s text, source URL, or confidence rating.
• DeleteInternalLinksDialog → Delete N link(s): Confirms the cascade deletion of links and their facts.
• MergePillarsDialog → Merge N pillar(s): Confirms merging the source pillars into your chosen target.
• PillarPickerDialog → Move / Confirm: Confirms moving or reassigning selected claims to the picked pillar.

​

Data shown

The Knowledge Base displays the organizational structure of your fact bank:

• Pillars: The core topics configured for your website.
• Internal links: The web pages (from your site or external domains) that you have crawled or added to act as a source of truth.
• Facts (Claims): The actual pieces of information extracted from web research, document uploads, AI responses, and your own site content. They can be approved or pending review.
• Content-coverage: Matches showing how well your existing published Content Hub articles cover the claims stored in your pillars.

​

Common workflows

Bootstrap knowledge base from scratch

1. Click the Add knowledge dropdown in the top right and select Discover pillars.
2. Click Start research in the confirmation dialog.
3. Athena will begin a long-running process to analyze your website, discover relevant pillars, research each one, and extract claims.
4. Once claims are found, click the Review N pending button or navigate to /knowledge-base/review.
5. Approve or reject the discovered claims. Approved claims automatically file themselves under their assigned pillar.

Add a document’s facts to a specific pillar

1. Open a pillar’s detail dialog by clicking its row in the Pillars table.
2. If the pillar has no claims yet, use the buttons in the empty state. If it does, click the Add knowledge dropdown menu.
3. Choose to Upload document, Paste text, Import from URL, Extract from Content Hub, or Import CSV.
4. Submit your chosen source.
5. Athena extracts the claims and inserts them directly into the current pillar.

Clean up duplicate pillars

1. If Athena detects pillars with the exact same name, notice the yellow Duplicate pillars warning callout above the Pillars table.
2. Click the Merge duplicates button inside the callout.
3. Review the list of duplicate groups and the canonical pillar they will merge into.
4. Click Merge N duplicates to batch-merge them together. You will see progress feedback as the merge processes.

Delete an internal link and its facts safely

1. Switch to the Internal links tab.
2. Select one or more links using the checkboxes on the left.
3. Click Delete in the command bar that appears at the bottom of the screen.
4. Review the cascade preview dialog. It will show you exactly which facts will be deleted alongside the link, organized by pillar.
5. Click Delete N link(s) to permanently remove the links and their sourced facts.

File orphaned facts onto a pillar

1. Switch to the Unfiled facts tab. (Note: this tab is only visible if you actually have unfiled facts).
2. Optionally, use the search box or the source type filters to find specific facts.
3. Select one or more facts using the checkboxes.
4. Click Move to pillar in the command bar.
5. Pick a published pillar from the dropdown menu and confirm to file the facts.

​

Linked from / links to

• Linked from: The main sidebar navigation. It can also be reached after initial onboarding or from the Review queue.
• Links to: The Review N pending button takes you to /knowledge-base/review. The Verify facts flow navigates you directly to the Oracle page (/oracle). Clicking grounded article titles inside usage chips takes you to the content editor (/content).

​

Common support questions

Why can’t I delete a pillar or internal link? Deleting a pillar or an internal link (which deletes all facts sourced from it) is a highly destructive action. For security, Athena restricts these deletions to Organization Admins. If you are a standard member, the delete buttons will still be visible, but clicking them will result in an error message. What happens when I delete an internal link? Deleting an internal link triggers a “cascade delete.” This means every single fact that was extracted exclusively from that URL will be deleted along with it. Athena will show you a preview dialog detailing exactly which facts will be destroyed so you can confirm before proceeding. Why does my unfiled facts tab exist if my pillars are empty? The “Unfiled facts” tab appears whenever there are approved facts that aren’t attached to a published pillar, not counting facts generated by Oracle analysis (those are excluded from the tab). If you delete a pillar, its approved facts are left behind as “orphans” and the non-Oracle ones will appear in this tab so you don’t lose them. Why can’t I merge my pillars into a specific one? When merging pillars, the target pillar you want to keep must be published. Draft or archived pillars are excluded from the target list and cannot be merged into. How many claims can a single pillar hold? A pillar can hold thousands of claims, and the table will show the true total count. However, when Athena generates the summarized pillar document, it only uses the 150 most relevant, high-confidence claims to ensure the AI doesn’t get overwhelmed. The document will explicitly state if it was synthesized from a subset of the total claims. Why do some of my URLs cost credits to import? Using the “Add URLs” or “Extract from Content Hub” features to extract facts requires AI processing power. Athena charges 1 credit per batch of 10 URLs or articles. You will see the credit cost in the dialog before you confirm the extraction.