Skip to main content

Open in AthenaHQ

app.athenahq.ai/knowledge-base

​
Purpose

This page is the detail view for a single pillar inside the Knowledge Base (sometimes called the “fact bank”). A pillar is a topic that groups together verified facts (“claims”) about the customer’s brand, product, or domain. Athena uses these pillars to ground its analysis of how AI search engines describe the brand and to power downstream features like Oracle and the AI-generated topic documents. From this page, the customer can review every claim attached to the pillar, add new claims manually, manage which website pages are associated with the pillar, generate or regenerate an AI-written summary document, and see which of their own existing articles already cover the pillar’s claims. It sits one level deep from the main Knowledge Base list: customers land here by clicking a pillar from /knowledge-base. Most knowledge-base work happens here: this is where customers spend time curating claims, checking coverage on their site, and getting the synthesised document that they can then use as a reference or feed into other Athena features.

​
What’s on the page

  • Back link: a “Knowledge Base” link with a left arrow returns the customer to the main Knowledge Base list.
  • Last researched timestamp: shown in the top-right of the header when the pillar has previously been researched (e.g., “Last researched 2 days ago”). Absent on pillars that have never been researched.
  • Pillar name: large heading, the topic title.
  • Pillar description: short descriptive text underneath the title.
  • Status selector: a dropdown showing the current status. Options: Draft, Published, Researching, Archived. Changing it updates the pillar’s status immediately.
  • Kebab menu (⋯): overflow menu in the top right with three actions: Edit, Regenerate, Delete (see “What you can do here”).

​
Tabs

Four tabs sit directly under the header. Each shows a count where relevant.

​
Claims tab

Lists every claim currently attached to this pillar. Each claim is a small card showing:
  • The claim text (one-line summary, click to expand).
  • A hover-revealed three-dot menu (top-right of each card) with a Delete option.
Clicking the body of a claim card opens the Claim detail dialog (see Drilldowns). At the bottom-right of the viewport, a floating Add claim button is always visible while this tab is active.

​
Associated pages tab

Lists internal website pages that Athena has linked to this pillar based on content similarity. Each row shows:
  • The page title (or URL if no title is available).
  • A match score badge showing the confidence of the link as a percentage (e.g., “87% match”).
  • An optional short summary of the page.
Clicking a row opens the page in a new browser tab. If no pages are linked yet, the tab shows a Find matching pages button that triggers a site scan.

​
Document tab

Shows the AI-synthesised markdown document Athena has generated from the pillar’s approved claims. Rendered as formatted markdown with headings, lists, links, and bold text. If no document has been generated yet, the tab shows a Generate document button (disabled if the pillar has no claims).

​
Matching articles tab

Lists articles from the customer’s own content (their content hub) whose text matches one or more claims in this pillar. Each row shows:
  • The article title (or URL fallback).
  • The article URL underneath.
  • A match score badge (e.g., “72% match”) indicating how strongly the article’s content matches.
  • A count showing how many of the pillar’s claims appear in that article (e.g., “3 claims”).
Clicking a row opens the article in a new browser tab. The empty state copy reads: “No matching articles found. Existing content on your site that covers this pillar’s claims will appear here.”

​
What you can do here

​
Top-level actions (always visible)

  • Back to Knowledge Base: top-left link, returns to /knowledge-base.
  • Change pillar status: use the status dropdown in the header. Selecting Draft, Published, Researching, or Archived applies immediately and shows a confirmation toast. There is no separate save step.
  • Edit pillar: open the kebab (⋯) menu in the top-right of the header and choose Edit. Opens a dialog where the name and description can be updated. Save commits the changes; Cancel discards them.
  • Regenerate the document: kebab menu → Regenerate. Asks Athena to rebuild the AI-generated document from the pillar’s current approved claims. This option is disabled when the pillar has zero claims.
  • Delete the pillar: kebab menu → Delete. Opens a confirmation dialog with the warning: “This will permanently delete this pillar and all its claims. This action cannot be undone.” Clicking the red Delete button permanently removes the pillar and every claim attached to it, then returns the user to /knowledge-base. Cancel closes the dialog without action.

​
Claims tab actions

  • View a claim’s evidence: click any claim card to open the Claim detail dialog.
  • Delete a single claim: hover (or keyboard-focus) a claim card, click the three-dot icon on the right edge, choose Delete. The claim is removed immediately with no separate confirmation.
  • Add a claim: click the floating Add claim button (rounded pill in the bottom-right of the viewport). Opens the Add claim dialog with two fields:
    • Claim text (required)
    • Source URL (optional) Click Add to save, or Cancel to discard.

​
Associated pages tab actions

  • Find matching pages: visible only in the empty state. Starts a background scan of the customer’s website to look for pages that match this pillar. A toast appears: “Searching your site for matching pages: they’ll appear once analysis completes.” Results appear once the scan finishes (not instantly).
  • Open a linked page: click any page row to open the URL in a new tab.

​
Document tab actions

  • Generate document: visible only in the empty state. Builds the AI document from the pillar’s claims. Disabled when there are no claims.
  • Regenerate (from kebab menu): see Top-level actions.
  • Open external links inside the document: any link inside the rendered markdown opens in a new tab.

​
Matching articles tab actions

  • Open a matching article: click a row to open it in a new tab.

​
Data shown

  • Claims: the verified facts the customer (or Athena’s research) has approved for this pillar. Only approved claims are shown here.
  • Associated pages: internal pages on the customer’s website that Athena’s analysis has linked to this pillar.
  • Document: an AI-generated markdown synthesis of the pillar’s claims, written by Athena.
  • Matching articles: articles already published on the customer’s site (from their content hub) that contain content matching one or more of this pillar’s claims, along with a match score and the number of matched claims.
  • Pillar metadata: name, description, status, and the timestamp of the last research run.

​
Common workflows

​
Review and manage claims

  1. Open the pillar from the Knowledge Base list.
  2. Stay on the Claims tab (default).
  3. Click any claim card to inspect its evidence: source type, confidence, quoted source text, source URL, and date added.
  4. To remove a claim, hover the card, click the three-dot icon, choose Delete.
  5. To add a claim, click the floating Add claim button, fill in claim text and an optional source URL, click Add.

​
Generate or refresh the AI document

  1. Open the pillar.
  2. Click the Document tab.
  3. If no document exists, click Generate document (must have at least one claim).
  4. If the pillar has been updated since the last generation, use the kebab menu → Regenerate to rebuild.
  5. Review the rendered markdown.

​
Find website pages that already cover this pillar

  1. Open the pillar.
  2. Click the Associated pages tab.
  3. If empty, click Find matching pages to start the background scan.
  4. Wait for the scan to finish (results don’t appear instantly).
  5. Click any returned page to open it in a new tab.

​
Change a pillar’s status

  1. Click the status dropdown in the header.
  2. Pick Draft, Published, Researching, or Archived.
  3. The change applies immediately.

​
Edit or delete the pillar

  1. Click the kebab (⋯) menu in the top-right of the header.
  2. Choose Edit to rename or update the description, or Delete to permanently remove the pillar and all of its claims (confirmation required).

​
Empty, loading, and error states

  • Loading the pillar: a series of skeleton placeholders are shown in place of the header and main content while the pillar loads.
  • Pillar not found, if the pillar does not exist (e.g., it was deleted), the page shows the message “Pillar not found.” with a link back to the Knowledge Base.
  • Claims tab empty: “No claims yet. Add claims below or run pillar research.”
  • Claims loading: skeleton claim cards.
  • Associated pages empty: “No pages linked yet. Scan your site for pages whose content matches this pillar.” with a Find matching pages button.
  • Associated pages loading: skeleton rows.
  • Document tab empty: “No document generated yet” with a Generate document button (disabled if no claims).
  • Document loading: skeleton lines.
  • Matching articles empty: “No matching articles found. Existing content on your site that covers this pillar’s claims will appear here.”
  • Matching articles loading: skeleton rows.
  • Error states: any failed action (status change, claim add or delete, regenerate, scan, delete pillar) surfaces a red toast notification describing the failure. The previous data remains intact.
  • Linked from: the Knowledge Base list page (/knowledge-base). Clicking any pillar card on that page lands the customer here.
  • Links to:
    • The Knowledge Base list (top-left back link).
    • External tabs for matching articles, associated pages, and any links rendered inside the AI document.
    • On delete, automatically redirects back to the Knowledge Base list.

​
Common support questions

Q: Why can’t I click the Regenerate or Generate document button? A: Both options require at least one claim on the pillar. Add a claim first, then try again. Q: I clicked “Find matching pages” but I don’t see anything yet. A: This kicks off a background scan of the customer’s site. Results appear once the analysis completes: it isn’t instant. The toast on screen confirms that the scan has started. Q: I deleted a claim by mistake: can I get it back? A: Claim deletion is permanent. The claim would need to be re-added manually (or rediscovered if research is run again). Q: I can’t find the delete option on a claim. A: The three-dot menu on each claim card is hover-revealed. Hover the claim card (or focus it with the keyboard) and the icon appears on the right side. Q: I deleted the pillar: can I undo it? A: No. Deleting a pillar permanently removes the pillar and every claim attached to it. The confirmation dialog warns about this before deletion. Q: Where do the claims come from? A: They can be added manually here (via the Add claim button), or they can come from Athena’s research / extraction workflows. Only approved claims are shown on this page. Q: What does the percentage on associated pages and matching articles mean? A: It’s a match score: how confident Athena is that the page or article corresponds to this pillar’s content. Higher means stronger match. Q: Status changed but nothing seems to have happened: did it save? A: Yes. Status changes save immediately on selection and you’ll see a brief confirmation toast. There is no separate save button.