> ## Documentation Index
> Fetch the complete documentation index at: https://docs.athenahq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Knowledge Base

> Lets users build and manage a structured fact bank of claims organized into content pillars, sourced from URLs, documents, text, or Content Hub articles, to power AI fact verification.

<Card title="Open in AthenaHQ" icon="arrow-up-right-from-square" href="https://app.athenahq.ai/knowledge-base" horizontal>
  `app.athenahq.ai/knowledge-base`
</Card>

## Purpose

The Knowledge Base page allows customers to build and manage a structured fact bank of claims organized into content pillars. This fact bank powers Athena's AI fact verification and ensures the AI relies on a curated, accurate foundation of information about your business.

Customers can populate their knowledge base from various sources: uploading documents, pasting text, adding URLs to an internal link bank, or pulling from published articles in the Content Hub. Once claims are extracted, users review, approve, and categorize them into "pillars" so Athena can accurately evaluate content coverage and detect AI-generated discrepancies.

## What's on the page

### Page Header

Displays the page title and the primary top-level action buttons: a prompt to review pending claims (if any exist), a button to start verifying facts, and a dropdown menu to add new knowledge.

### Pillars Tab

Shows the core organizational structure of your fact bank. Pillars (or topics) group related claims together.

**Pillars Table**
Lists all knowledge base pillars with selection checkboxes and coverage data.

* **(checkbox)**: Select/deselect this pillar for bulk actions.
* **Pillar**: Name and description of the pillar. Shows an orange "N pending" badge if claims await review. *Tooltip: "Content pillars that group related claims and measure content coverage"*
* **Content coverage**: A visual progress bar showing what fraction of the pillar's approved claims are already covered by existing site content. *Tooltip: "Percentage of a pillar's claims covered by your existing content"*

### Internal Links Tab

Shows all internal pages from your site that have been added to the link bank for monitoring and claim extraction.

**Internal Links Table**
Lists all tracked internal pages with their claim counts and scrape status.

* **(checkbox)**: Select/deselect this link for bulk actions.
* **URL**: The normalized URL of the internal page. Clicking the URL opens the page in a new tab.
* **Title**: The page title scraped from the URL.
* **Claims**: The number of claims extracted from this page. Clicking this badge opens a dialog showing those specific claims.
* **Status**: The current processing status of the link (e.g., finished, scraped, pending, failed).

### Empty State

If no pillars and no internal links exist yet, the page displays a "No knowledge yet" message and provides a button to automatically discover pillars relevant to your website.

### Charts

* **Content Coverage Bar**: A horizontal progress bar in the Pillars table. The width represents the coverage percentage (0–100%), showing at a glance what fraction of a pillar's approved claims are already covered by existing site content.

### Filters

* **Pillars / Internal links tab switcher**: Switches the main table between the Pillars view and the Internal Links view.
* **All / Pending / Approved filter**: Located inside the Pillar Detail dialog. Filters the claims list within a pillar to show all claims, only pending claims, or only approved claims.

### Drilldowns

* **Clicking a pillar row**: Opens the **Pillar Detail dialog (modal)**. This view contains tabs for Claims, Pages, Document, and Matching Articles for that specific pillar, along with claim review actions and add-knowledge options.
* **Clicking the claims badge on an internal link**: Opens the **Source Link Claims dialog (modal)**. Shows all claims extracted from that link, grouped by linked pillar, with options to delete claims.
* **Clicking 'Review N pending'**: Navigates directly to the `/knowledge-base/review` page to review the full queue of pending claims.
* **Clicking 'Verify facts'**: Opens the Verify Facts modal, allowing you to select pillars and start a fact-verification analysis run.
* **Starting verification in the Verify Facts dialog**: Redirects you to the `/oracle` page to view the AI analysis runs.
* **Clicking a claim's source URL** (in the Claim Detail dialog) or **open-link icon** (on an internal link URL): Opens the source page in a new browser tab.
* **Clicking 'View AI response'** (in the Claim Detail dialog): Opens the Oracle response view to show the AI response that sourced the claim.

## What you can do here

**Top-level & Header Actions:**

* **Review N pending**: Navigates to the review queue to approve or reject pending claims.
* **Verify facts**: Opens the Verify Facts dialog to select pillars and run a fact-verification analysis.
* **Add knowledge (dropdown trigger)**: Opens a menu with options to bring in new data.
  * **Create pillar**: Opens the Add Pillar dialog to manually create a new pillar.
  * **Discover pillars**: Opens the Confirm Research dialog to auto-discover pillars by scanning your website.
  * **Add URLs**: Opens a dialog to paste URLs or crawl a path to add pages to your link bank and extract claims.
  * **Upload document**: Opens the Upload dialog to extract claims from a PDF, DOCX file, or pasted text.
  * **Extract from Content Hub**: Opens the Bootstrap from Content Hub dialog to extract claims from published articles.
* **Discover pillars (empty state button)**: A shortcut to open the Confirm Research dialog when your fact bank is empty.

**Bulk Actions (Command Bar):**
*Appears at the bottom of the screen after selecting rows using the checkboxes.*

* **Pillars table bulk actions:**
  * **Edit**: Opens the Edit Pillar dialog (only available when a single pillar is selected).
  * **Refresh**: Re-associates pages and regenerates synthesis docs for the selected pillars. *Confirmation: "Re-associates pages and regenerates synthesis docs for the selected pillars. May take a few minutes."*
  * **Verify facts**: Opens the Verify Facts dialog pre-seeded with your selected eligible pillars.
  * **Delete**: Deletes selected pillars and all their associated claims. **(Destructive)** *Confirmation: "All claims for these pillars will be deleted."*
  * **Reset**: Clears your current selection.
* **Internal Links table bulk actions:**
  * **Refresh**: Re-scrapes the selected links and re-extracts claims. *Confirmation: "Re-scrapes the URL and re-extracts claims. Existing duplicates are kept; new claims are routed to pillars."*
  * **Delete**: Deletes selected links and all claims sourced from them. **(Destructive)** *Confirmation: "Also deletes N claims sourced from these links."*
  * **Reset**: Clears your current selection.

**Dialog Actions:**

* **Add Pillar dialog**:
  * **Create**: Creates the new pillar.
  * **Auto-research toggle**: When enabled, Athena automatically starts discovering and extracting claims for the new pillar immediately after creation.
* **Confirm Research dialog**:
  * **Start research**: Kicks off the automated pillar discovery and research workflow.
* **Upload dialog**:
  * **Extract claims**: Starts claim extraction from the provided file or pasted text.
* **Bootstrap from Content Hub dialog**:
  * **Extract from N articles**: Starts claim extraction from the selected articles (this action costs credits).
* **Add URLs dialog**:
  * **Discover** (Crawl path tab): Crawls the entered domain/path and returns a list of URLs.
  * **Select all / Clear**: Toggles selection for the discovered URLs.
  * **Add N URLs**: Adds the selected URLs to your link bank and/or extracts their claims.
* **Verify Facts dialog**:
  * **Start verification**: Begins the fact-checking run for the selected pillars and takes you to the results.
* **Edit Pillar dialog**:
  * **Save**: Saves the updated pillar name and description.

**Pillar Detail Dialog Actions:**
*(Accessible by clicking any pillar row)*

* **Expand / Collapse**: Toggles the dialog width between normal and expanded views.
* **Pillar options menu (⋯)**: Found in the top right of the dialog.
  * **Edit**: Opens the Edit Pillar dialog.
  * **Refresh**: Starts a refresh for the current pillar.
  * **Delete**: Deletes the pillar and all its claims entirely. **(Destructive)**
* **Claims Tab actions**:
  * **Add knowledge**: Opens a menu directly inside the empty claims state to Add URLs, Upload documents, Paste text, Extract from Content Hub, or Import CSV.
  * **Approve all pending**: Approves every pending claim in the pillar at once.
  * **Claim row dropdown (⋯)**: Approve, Reject, or Delete **(Destructive)** a single claim.
  * **Bulk claims toolbar**: Appears when selecting specific claims to bulk Approve, Reject, or Delete **(Destructive)**.
* **Pages Tab actions**:
  * **Find matching pages**: Starts a workflow to find pages on your site that match the pillar's content.
  * **Remove page**: Unlinks a page from the pillar. **(Destructive)**
* **Document Tab actions**:
  * **Generate document**: Creates a synthesized document from all of the pillar's approved claims.

**Source Link Claims Dialog Actions:**
*(Accessible by clicking the claims badge on an Internal Links row)*

* **Delete claim**: Permanently deletes a claim sourced from that specific link. **(Destructive)**

## Data shown

* **Pillars and claims**: Sourced from your active website's knowledge base. Claims represent verified or pending facts Athena has gathered about your business.
* **Internal pages**: Tracked in your link bank for the active website, allowing Athena to monitor them and extract future claims.
* **Content Hub articles**: Pulls published articles you have written inside the Athena Content Hub to seed the knowledge base.
* **Claim-content coverage matches**: Computed dynamically by the coverage analysis workflow to grade how well your website's actual content covers your documented pillars.
* **Pending claim count**: Real-time count of claims waiting for human approval.

## Common workflows

**1. Add a new pillar manually**

1. Click the **Add knowledge** dropdown in the top-right page header.
2. Select **Create pillar**.
3. Enter a pillar name and an optional description.
4. Optionally enable the **Auto-research** toggle if you want Athena to immediately hunt for facts.
5. Click **Create**.

**2. Discover pillars automatically**

1. Click the **Add knowledge** dropdown in the top-right page header.
2. Select **Discover pillars**.
3. Review the confirmation dialog explaining the automated research process.
4. Click **Start research**.
5. Wait for the pillars to appear on the page as Athena discovers them.

**3. Add URLs to the link bank and extract claims**

1. Click the **Add knowledge** dropdown and select **Add URLs**.
2. Choose either the **Paste URLs** tab or the **Crawl path** tab.
3. Paste your URLs, or enter a domain path to crawl and click **Discover**.
4. Toggle **Add to link bank** and/or **Extract claims** depending on your needs.
5. Click **Add N URLs** to begin processing.

**4. Review and approve pending claims**

1. Click the **Review N pending** button in the header (if claims await review) to go to the full review queue, OR click a specific pillar row to open the Pillar Detail dialog.
2. In the Pillar Detail dialog, switch to the **Claims** tab and filter by **Pending**.
3. Approve or reject individual claims via the row menu, or use the **Approve all pending** button.

**5. Verify facts against AI responses**

1. Click **Verify facts** in the top-right page header.
2. In the modal, select one or more pillars that contain approved claims.
3. Click **Start verification**.
4. You will be redirected to the Oracle page to view the fact-checking analysis results.

## Empty, loading, and error states

* **Empty**: When no pillars and no internal links exist, the page shows a large "No knowledge yet" message with a prompt to **Discover pillars**. If you have pillars but no links (or vice versa), the empty tab will show a simple "No pillars yet" or "No internal links yet" message.
* **Loading**: Skeleton (placeholder) rows animate in the table while the data loads. Dialogs also display skeleton lines while their specific data fetches.
* **Error**:
  * If your subscription plan cannot be verified (e.g., a billing service outage), an error screen stating "Something went wrong" or "Couldn't verify access" appears with a **Retry** button.
  * If your current subscription plan does not include Knowledge Base access, a "locked" screen will appear indicating you need to upgrade.

## Linked from / links to

* **Linked from**: The main sidebar navigation (under the "Knowledge Base" item) and from Oracle or Verify Facts flows that link back to the KB review queue.
* **Links to**: The `/knowledge-base/review` page (when reviewing pending claims) and the `/oracle` page (when starting a fact verification run).

## Common support questions

**Why can't I delete a claim or an internal link?**
Deleting claims and internal links permanently removes data from the knowledge base. For security and data integrity, this action is restricted to organization admins only. Non-admin team members will see an error if they try to delete them.

**What does the Content coverage bar mean?**
The Content coverage bar shows you the percentage of a pillar's *approved* claims that are already discussed or covered by your website's existing content. It helps you identify gaps in your content strategy.

**Why don't I see my pending links in the Internal Links table?**
Links that have a status of "pending" (meaning they are waiting to be scraped and processed) are hidden from the UI because no actions can be taken on them yet. They will automatically appear in the table once they are successfully scraped or have claims extracted.

**Does importing from the Content Hub cost credits?**
Yes. Extracting claims from your published Content Hub articles costs credits. The cost is calculated as 1 credit per batch of 10 articles. The Bootstrap dialog will display the exact credit cost before you confirm the action.

**Where do my claims go after auto-research finishes?**
Claims found during auto-research are inserted into the fact bank as "pending". They must be manually reviewed and approved before they are published to the topic document and used as the ground truth for fact-checking.

**Why is the "Verify facts" button grayed out or unavailable for some pillars?**
To run a verification analysis, a pillar must be in a "published" status and contain at least one *approved* claim. If a pillar only contains pending claims, or has no claims at all, it cannot be used for verification yet.