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

# Missing from the KB

> How to review what agents needed and the knowledge base didn't have, and decide whether to write a page, link an existing one or dismiss it.

**Missing from the KB** gathers what agents needed and the knowledge base didn't have. It's the most direct way to know what's worth writing: each item comes from a real session, ticket or conversation.

Flexxible Assist agents don't write pages on their own from a session. Instead, they report what was missing and the people who know the environment decide what to document.

## What appears

An item reaches the list in two ways:

* **An agent reports it.** When the knowledge base had nothing, or had something incorrect, and the session was resolved another way or passed to a person.
* **A search finds nothing.** When agents search for the same thing in more than one session and no page answers it.

Reports and searches about the same topic are grouped into a single item, even if they come from different agents, in other words or in another language.

## The list

![Missing from the KB screen: list of open items, each with the agents that reported it, the number of sessions and how many were escalated.](https://mintcdn.com/flexxible/luynIZmFTttZPpU9/images/features/kb-gaps.png?fit=max\&auto=format\&n=luynIZmFTttZPpU9\&q=85\&s=348fe67413ada479eb48a942d418471f)

It opens from **Missing from the KB**, in the sidebar, which shows the number of pending items. Items are sorted by weight, with the most relevant first. Each one shows:

* Which agents reported it or searched for it without results.
* In how many sessions, tickets and chats it came up.
* How many of those sessions were escalated, that is, ended up in the hands of a person.
* Whether it has come back after being closed.

The **Open** view shows what's pending and **Closed**, what has already been handled.

## Review an item

When you open an item, it shows:

| Section | What it contains |
| - | - |
| **What the agents said** | Each agent's description of what was missing and how its session ended: resolved another way, escalated or abandoned. |
| **Searches tried** | The searches that found nothing and the ones the agents said they tried. |
| **Pages that came close** | The pages the agents read that were wrong or not enough. |

## What to do with an item

| Action | When to use it |
| - | - |
| **Write a page** | The topic isn't documented. A new page opens in the editor, with what the agents said alongside as a reference. |
| **Improve** the indicated page | A page on the topic already exists, but it didn't answer. That page opens so you can fix it. |
| **Covered by…** | A page that covers it already exists and the search didn't find it. Choose the page: the item's searches are associated with it so it's found next time. |
| **Dismiss** | It's not something for the knowledge base. Indicate the reason: "Any model knows this", "Not for the KB", "Won't happen again" or one of your own. |

Any of them closes the item. A closed item can be **Reopened**, and the notices for each action include **Undo**.

> [!TIP]
>
> Before writing, review [What to write in the knowledge base](https://docs.flexxible.com/en/features/flexxible-kb/writing-guide.md). An ongoing incident or a generic procedure doesn't need a page.

## When an item comes back

If an agent reports again a topic that was already closed, the item reappears in **Open** and shows why: the page that should have covered it didn't, or it had been dismissed. It's the sign that the page needs another review.

## Shared pages

If another organization's agents read a page that your organization has [shared](https://docs.flexxible.com/en/features/flexxible-kb/sharing.md) with them and it isn't enough, what they miss also reaches your list.

## Next steps

* [What to write in the knowledge base](https://docs.flexxible.com/en/features/flexxible-kb/writing-guide.md)
* [Flexxible Assist agents](https://docs.flexxible.com/en/features/flexxible-kb/assist-agents.md)
* [Ratings and reactions](https://docs.flexxible.com/en/features/flexxible-kb/ratings-reactions.md)
