Knowledge

The library the agent answers from, with folders, documents, uploads and suggested knowledge.

The agent searches the documents here when it answers. How it searches is on Built-in abilities.

The library

Each row is a document or a folder. A document row shows an icon for its source, its title, and a badge when its state needs attention.

Search and filter

• The search box, Search by title, matches document titles only and returns up to 30 results.
• The source filter narrows the list to one source.
• Searching or filtering shows a flat list. Clear both to get the folders back.
• The tree holds the 1,000 most recently updated documents and up to 200 folders. Search reaches every document.

Who sees what

Pull fresh copies

The arrows button, Pull fresh copies from GitHub and Notion, appears once the library holds a GitHub document, or a Notion page while Notion is still connected. Its tooltip names only the sources you have. It reads every file in every connected repository again, and pulls every imported Notion page again. A repository already syncing runs it once that sync finishes. It spins while any of those documents is indexing. For when each source refreshes on its own, see Connected sources.

Folders and selection

Folders

Create a folder from Add → New folder, or inside another folder from its menu.

• Folders nest 3 levels deep. Past that, Folders go three levels deep, and no further.
• The number beside a folder counts the items directly inside it.

A document row’s menu has Add public link or Change public link, Move to and Delete. Right-click any row for the same menu.

Drag to arrange

Drag a row to reorder it or file it in a folder. The top and bottom edges of a folder row place the item beside the folder. The middle places it inside. Hold a dragged item over a closed folder for half a second to open it.

Select several

1. Hover a row. Its icon turns into a checkbox.
2. Tick it. While anything is selected, clicking a row toggles it.
3. Shift-click to select a range.

The bar at the bottom reads N selected, with Move to, Delete and a button to clear the selection. Escape clears it too.

Organize the library

The wand button, Organize documents into folders, appears once the library holds two documents.

1. Press the wand. The Organize dialog reads your library.
2. Review the proposed changes. A folder that does not exist yet is marked New, and new titles are listed under Renamed.
3. Press Organize. Nothing moves before that.

• It reads document titles, sources, file names and paths, one line from the top of each document, and folder names and descriptions.
• It never renames or deletes a folder.
• It looks at the 200 most recently updated documents. A larger library shows Only the 200 most recent documents were looked at.
• No changes suggested. means everything already fits.
• It needs Standard or Pro. On Explore the dialog shows AI organization is available on Standard and Pro. See Plans.

Add content

Open Add → Add content.

Notion, GitHub, docs sites and websites are covered on Connected sources.

Every new or changed document is indexed. Indexing uses AI credits, so it needs Standard or Pro and credits left. Without them a document shows Failed with Indexing is paused. Check available credits or try again later. Press Try again once credits are back. See Plans.

Admins and owners see a line under the page title while indexing can’t run: “Indexing needs Standard or Pro, so new documents won’t be searchable yet.” on Explore, or “Indexing is paused until you add credits, so new documents won’t be searchable yet.” when credits run out.

Create a document

1. Choose Create a document, or New document in a folder’s menu.
2. Enter a title, up to 120 characters.
3. Write the body. Type / for the block menu. Select text for the formatting toolbar. Drag the handle in the margin to move a block.
4. Press Save, or Cmd+S / Ctrl+S.

The body is stored as markdown, up to 900 KB. The document opens once saved and shows Indexing until it is ready.

Upload files

Choose Upload files and pick up to 10 files at a time, up to 20 MB each.

• Each file becomes a document titled with its file name, minus the extension.
• The row appears at once with Indexing. Conversion runs in the background.
• Markdown and text files are stored as they are. Everything else is converted to markdown.
• When every file makes it, you return to the library.

Errors under the upload button:

Errors on a document that shows Failed:

Documents

Open a document to read it. The line under the title shows its source, the file name or repository path, its public link, when it was last updated, and any status badge.

What you can edit

How links are worked out and checked is on Published links.

Edit a document

1. Press Edit. The title, body and Public link field become editable.
2. Press Save, or Cmd+S / Ctrl+S. The document is indexed again.

Cancel with unsaved changes asks Discard changes?

Document actions

The three-dot Document actions menu holds the items that apply to the document.

Try again

A Failed document shows the reason under its title and a Try again button.

A link to a deleted document shows Document not found.

Suggested knowledge

Suggested knowledge sits above the library when a suggestion is waiting. It shows a count and the newest 100. Only admins and owners see it. The dashboard lists the same suggestions under Knowledge suggestions.

Where suggestions come from

The switches are on Agent → Behavior. See Agent.

Turn both off and no new suggestions arrive. Both need Standard or Pro. See Plans.

The card

Hover or tab into a card to expand it.

• An update can only target a Written, Uploaded, Scraped or Learned document of 8,000 characters or fewer.
• A settled suggestion stays on record, so the same suggestion from the same conversation is not filed again.
• Each new suggestion also sends the knowledge.suggestion.created event. See Webhooks.

What belongs in knowledge

The agent reads live data through tools.