Skip to main content

Open in AthenaHQ

app.athenahq.ai/knowledge-base

​
Purpose

The Knowledge Base is the central workspace for building, curating, and verifying the facts and claims that Athena uses to understand your brand. It organizes your company’s verified information into categories called “Pillars” (topics), tracks the web pages and documents those facts were extracted from, and manages “unfiled” facts that haven’t been categorized yet. By managing your Knowledge Base here, you ensure that any content Athena generates or analyzes is grounded in accurate, approved truth about your products, services, and positioning.

​
What’s on the page

​
Page Header

  • Page Title: “Knowledge Base”.
  • Review N pending: A conditional button that only appears if you have claims awaiting review. Clicking it takes you to the dedicated review queue.
  • Verify facts: A button to cross-check your approved facts against AI responses Athena has collected to flag contradictions.
  • Add knowledge (+): A dropdown menu with options to add new information to your workspace.
  • Progress Overlays: Floating cards in the bottom right corner showing the real-time progress of active research tasks (like “Discovering pillars” or “Verifying facts”).

​
Pillars Tab

A table organizing your knowledge base into major topics.
  • (Checkbox): Selects the pillar for bulk actions.
  • Pillar: The name and description of the topic. If there are facts waiting for human approval, a “[N] pending” badge appears here. Clicking the pillar name opens its detailed view.
  • Content coverage: A progress bar and percentage showing how many of this pillar’s approved claims are currently covered by your existing published content. A tooltip explains: “Percentage of a pillar’s claims covered by your existing content”.
  • Duplicate pillars callout: A warning banner that appears if the system detects multiple pillars with the exact same name, offering a quick way to combine them.
A table of all the web pages you have added or crawled to extract facts.
  • (Checkbox): Selects the link for bulk actions.
  • URL: The web address of the page (links out to the actual page).
  • Title: The title of the page, if successfully scraped.
  • Claims: The number of facts Athena extracted from this specific link. Clicking this number opens a details panel.
  • Status: The current processing state of the link (e.g., Finished, Researching, Pending, Scraped, Failed).

​
Unfiled Facts Tab

This tab only appears if you have approved facts that are not attached to any published pillar.
  • Search bar: Allows you to find specific unfiled facts by keyword.
  • Source filters: Tabs to filter the list by where the fact came from (All, Research, Uploads, Content hub).
  • Fact list: Displays the fact text, a badge showing its origin (e.g., “Upload”), its confidence level, the date it was added, and a link to the source if available.
  • Usage chip: If a fact was used to write an article, a “Used in N articles” badge appears. Hovering over it reveals links to the generated content.
  • Delete all N: A button to instantly wipe out all unfiled facts matching your current search/filter.

​
What you can do here

​
Top-Level Actions (Header)

  • Verify facts: Opens a dialog to pick specific pillars and run a validation check against third-party AI responses.
  • Add knowledge -> Create pillar: Opens a dialog to manually name and describe a new pillar. You can check “Auto-research” to have Athena immediately hunt for facts to fill it.
  • Add knowledge -> Discover pillars: Instructs Athena to scan your website and automatically suggest and build pillars for you.
  • Add knowledge -> Add URLs: Opens a dialog where you can paste specific web addresses or enter a domain to crawl. You can choose whether to just add them to the link bank, or also extract claims from them.
  • Add knowledge -> Upload document: Opens a dialog to extract facts by uploading a PDF/DOCX file or pasting raw text.
  • Add knowledge -> Extract from Content Hub: Opens a list of your published articles, allowing you to select pieces to extract facts from. (Note: This consumes credits).

​
Pillar Bulk Actions

Select one or more checkboxes in the Pillars table to reveal the command bar at the bottom of the screen:
  • Edit: (Only visible when exactly one pillar is selected) Rename or change the description of the pillar.
  • Refresh: Tells Athena to re-evaluate the pillar, re-associate relevant links, and regenerate its underlying synthesis document.
  • Export CSV: Downloads all claims inside the selected pillars as a spreadsheet.
  • Merge: (Visible when 2+ pillars selected) Opens a dialog to combine the selected pillars into one. You must choose a published pillar as the “target” to keep. The others are deleted and their facts are moved over.
  • Delete: Permanently removes the selected pillars and every fact filed under them.
  • Verify facts: A shortcut to run a verification check specifically on the selected pillars.
  • Reset: Clears your checkbox selection.
Select checkboxes in the Internal Links table to reveal the command bar:
  • Refresh: Re-scrapes the selected URLs and extracts any new facts that might have been added to the page.
  • Delete: Opens a confirmation dialog. Crucial note: Deleting a link cascades and deletes every fact that was sourced from that link. The confirmation dialog will show you a preview of exactly which facts (grouped by pillar) are about to be destroyed.
  • Reset: Clears your selection.

​
Unfiled Facts Actions

  • Delete all N: Permanently deletes all unfiled facts that match your current filter.
  • Select rows -> Move to pillar: Opens a dropdown to pick a published pillar to file these facts under.
  • Select rows -> Delete: Permanently deletes the selected facts.

​
Pillar Details (Drilldown)

Clicking a pillar’s name opens a large dialog managing that specific topic.
  • Pillar options (⋯ menu): Found in the top right. Contains Edit, Refresh, Export claims (CSV), and Delete.
  • Add knowledge (+ menu): Opens the Add knowledge flow pre-scoped to this pillar. Includes an extra Import CSV option to bulk-upload facts from a spreadsheet.
  • Claims tab: Lists all facts inside the pillar. You can filter by Status (Pending, Approved, Rejected).
    • Per-claim actions: Hover over a claim to reveal a menu allowing you to Approve, Reject, Delete, Mark as pending, Change pillar, or Edit fact.
    • Bulk claim actions: Select checkboxes next to claims to reveal a command bar to bulk Approve, Reject, Delete, Mark as pending, or Change pillar.
    • Approve all pending: A quick button to approve every pending fact in the pillar.
  • Sources tab: Shows a list of every page or document that contributed approved facts to this pillar. Clicking a source filters the Claims tab to only show facts from that specific origin.
Clicking the number in the “Claims” column on the Internal links tab opens this view.
  • Linked pillars: Shows which pillars this page is associated with.
  • Facts sourced from this link: Lists every specific claim extracted from the URL. You can hover over any fact and click the trash can icon to Delete fact individually.

​
Data shown

  • Pillars (Topics): The thematic categories your brand’s information is grouped into.
  • Claims (Facts): The atomic pieces of verified information about your business. These come from web research, manual entry, file uploads, or scraped pages.
  • Internal Links: The library of tracked web pages Athena uses as source material.
  • Content Coverage: A metric showing how effectively your marketing content is utilizing the approved facts you’ve gathered in your Knowledge Base.
  • Active Runs: Live status tracking for background jobs like website discovery, pillar research, or fact verification.

​
Common workflows

Discovering your Knowledge Base from scratch:
  1. Land on the empty Knowledge Base page and click Discover pillars.
  2. Confirm the prompt to start research.
  3. Watch the “Discovering pillars” overlay in the bottom right as Athena scans your site.
  4. Once complete, click into the newly created pillars to review and approve the extracted facts.
Adding a specific PDF or document:
  1. Click the Add knowledge dropdown and select Upload document.
  2. Upload your PDF or DOCX file (or paste raw text).
  3. Click Extract claims. Athena will process the text and add the new facts to your unfiled list (or directly to a pillar if you started from inside a Pillar Detail view).
Cleaning up duplicate pillars:
  1. If Athena detects pillars with the exact same name, a yellow “Duplicate pillars” banner appears on the Pillars tab.
  2. Click Merge duplicates.
  3. Review the list of duplicates that will be combined.
  4. Click Merge N duplicates to automatically fold them into their original pillars.
Reviewing and categorizing Unfiled Facts:
  1. Go to the Unfiled facts tab.
  2. Read through the facts. Check the boxes next to facts that belong together.
  3. In the command bar that appears, click Move to pillar.
  4. Select the appropriate published pillar to file them under.

​
Empty, loading, and error states

  • Empty: If you have absolutely no pillars, links, or unfiled facts, you will see a “No knowledge yet” screen with a large “Discover pillars” button. If a discovery run is actively happening, this is replaced with a “Discovering pillars” live status screen.
  • Loading: When data is fetching, the page displays gray skeleton placeholder rows.
  • Error: If the system fails to load data inside a dialog (like a pillar’s claim list), it shows a “Couldn’t load claims” message with a “Try again” button. This prevents users from confusing a network error with an empty pillar.
  • Linked from: The main sidebar navigation.
  • Linked from: The Oracle page (users are redirected here when managing fact verification).
  • Links to: /knowledge-base/review (via the “Review N pending” button).
  • Links to: External source URLs open in a new browser tab.
  • Links to: The Content editor, via the “Used in N articles” hover chip on individual claims.

​
Common support questions

“Why did my facts disappear when I deleted a link?” Internal links act as the foundation for the facts extracted from them. If you delete a URL from your Internal Links tab, every single fact that was sourced exclusively from that page is permanently deleted along with it. The system will show a warning preview of exactly what facts will be destroyed before you confirm. “I can’t find the Unfiled Facts tab anymore.” The Unfiled Facts tab automatically hides itself when there are zero unfiled facts in your workspace to keep the interface clean. “I’m trying to merge two pillars but the ‘Merge’ button is disabled.” To merge pillars, at least one of the selected pillars must have a “Published” status. You cannot merge a group of pillars if they are all still in “Draft” or “Archived” status because there is no valid target to keep. “I see the Delete button, but when I click it, it says I don’t have permission.” While all users with Knowledge Base access can view the Delete buttons, only users with Organization Admin privileges can actually delete claims, pillars, or internal links. This is a safety measure to prevent accidental data loss. “Why am I being asked to upgrade when I click Export CSV?” Exporting your Knowledge Base data to a spreadsheet is a premium feature. If your workspace is on a free plan, clicking Export will prompt you to view upgrade options.