Skip to content

Documentation

Knowledge base

Versioned articles that move from Draft to Review to Published, and can later be Retired. Revert to an earlier version, search the full text, and collect reader feedback.

Where
Agent workspace → Knowledge base · Portal → Knowledge base
Permission
EDIT_KNOWLEDGE_BASE · APPROVE_KNOWLEDGE_BASE
Updated
October 2026

Overview

Articles move from Draft to In review to Published. Each transition is audited.

A Published article can later be Retired. That removes it from search and the portal without deleting it.

A version is saved whenever an article's content changes and when it is published. Each version records who saved it and when (for a publish, the approver).

Restoring an earlier version brings back its content and keeps the article's current status.

Portal and editor search use PostgreSQL full-text search: every word must match, with a substring fallback. No extra database extension is needed.

The global search box also matches near spellings.

Semantic search (matching by meaning) and AI-assisted query extraction can be turned on in addition. Admin → Settings → Evee AI shows how many published articles are indexed for it.

Readers mark an article helpful or not helpful. Each article in the list shows its helpful rate.

The analytics strip at the top of Agent workspace → Knowledge base counts portal searches, the click-through rate and content gaps (searches that found nothing).

Step by step

  1. 01

    Write a draft

    Go to Agent workspace → Knowledge base → New article. Save it as Draft to keep the article private.

    • Start blank or from a template
    • Write in Markdown
  2. 02

    Send for review

    Set Status to In review and save. Reviewers who hold the Approve knowledge base permission are notified.

    • A reviewer approves the article, or declines it with a note that goes to the author
    • The author can edit a declined article and resubmit it
  3. 03

    Publish

    Click Publish. A new version is saved.

    • The article appears in portal search for workspace users
    • It also appears in the agent reply composer
  4. 04

    Track usage

    Open Agent workspace → Knowledge base to see how articles are used.

    • The analytics strip shows searches, click-through rate and content gaps
    • Pick a window from 7 to 90 days
    • Each article shows its helpful rate
    • Use the content gaps list to decide what to write next

Good to know

  • Link an article from the agent reply composer with Article: search the published articles and choose Insert link.
  • With Evee turned on, Find KB suggests knowledge base articles for the request.
  • Retire an outdated article instead of deleting it. A retired article leaves search and the portal and keeps its history.
  • A retired article can be returned to Draft and published again.