Skip to content

Managing Your Document Library

The Document Library is where you decide what the AI assistant knows. Its subtitle says it exactly: “Everything your assistant can read.” Documents you upload or sync here become the material the assistant answers from, and the tags you set here decide which of them it favours.

Click the Apps button — the grid icon in the header, available on every page — and choose Document Library. See Finding and Opening Your Apps if it is not listed.

Tab What it is for
Documents The working list — browse, search, organize, fix, and tag individual documents.
Sync Folders pulled in automatically from a connected system, and anything waiting on your approval.
Activity Health at a glance — what needs attention — and the record of how documents arrived.
Tags Boost tags: which documents and folders the assistant should favour, and by how much.

The Document Library on the Documents tab, with the views and folders rail beside the document list

On the left is a Views and folders rail; on the right, the documents themselves.

Views are questions about your library rather than places in it:

View What it answers
All documents Everything in the library.
Recently added What arrived lately. This is a time window, not a count — so an empty Recently added means nothing new arrived, which is a real answer rather than a fault.
Needs attention Documents that failed, got stuck while processing, or finished processing but never indexed. Start here when the assistant cannot find something you know you uploaded.
Duplicates Documents whose content is identical to another’s.
Untagged Documents the assistant favours for no reason — they carry neither a document tag nor an inherited folder tag.
Synced Documents that arrived from a connected system.
Uploaded Documents someone added by hand.

You can save a filter combination you use often. Saved views appear under My views and are marked Saved on this device — they are yours, not your organization’s, so a colleague will not see them.

Below the views is your folder tree, with New folder to add one and Filter folders to find one in a large tree.

Above the list, Search documents matches names and folders, and three filters narrow it further: File type, Status, and Source.

Select one or more documents and the action bar offers:

  • Move — file them into a different folder
  • Retry processing — re-run extraction and indexing. This is the fix for most things in Needs attention
  • Export CSV — take the current list out as a spreadsheet
  • Delete
  • Add folder tag — see Tags below

A brand-new library shows “Your library is empty” with a Set up sync button, which is usually the faster way to fill it than uploading by hand.

Sync keeps a folder in a system you already use — a document management platform, a cloud drive — mirrored into the library, so you do not have to re-upload anything when it changes.

Each provider’s panel is organized into four sections:

Section What it covers
Folders Which folders are mirrored. Add one, re-point an existing one at a different source folder, or set the safety limit that pauses a sync if a single scan finds more changes than expected.
Pending changes Newly arrived files held back for review. They are not in the library until you approve them, so nothing reaches the assistant unreviewed.
Reconcile Two kinds of mismatch between the library and the source: files whose content matches something already present, and documents whose location in the library no longer matches the source. When there is nothing to settle it says “Everything is where it should be.”
Usage API budget today — every scan and download spends calls against the source system’s daily allowance — plus the Sync queue and Pause history.

The Document Library Sync tab, showing the sync provider list

Activity leads with findings — five cards answering “is anything wrong?” — and follows with the record.

Card What it means, and what to do
Needs attention Broken down as failed · stuck · never indexed. Click Review them to open the matching document list.
Awaiting approval New files not in the library until approved. Click Approve or reject to clear the queue. This is the Activity tab’s view of the Sync tab’s Pending changes queue.
Sync paused A scan exceeded its safety limit. Click Review and resume.
Orphaned sections Searchable content whose document is gone — and it is still returned by search. Click Clean them up.
Library size How many documents are loaded. The list streams the newest 5,000; beyond that it says so rather than quietly truncating.

Below the findings, Library history records how documents arrived: sync runs and the last 50 manual uploads. Sync runs are kept for 90 days; upload records travel with the documents themselves, so they last as long as the document does.

The Document Library Activity tab, showing the finding cards above the library history

A boost tag tells the assistant a document is authoritative, so retrieval favours it. This is how you make sure the current policy wins over a three-year-old draft that happens to use the same words.

The tab has two sections, in the order the questions usually get asked:

  1. Tagged folders — which folders carry a tag. Read from the folders themselves, so it is the authoritative answer.
  2. Categories — the tag definitions, with what each one costs and how selective it is.
Type Multiplier range Use it for
Document Tag 2x to 20x, default 10x A specific critical document you want surfaced whenever it is even slightly relevant.
Folder Tag 0.25x to 2x, default 0.5x A whole collection. The gentler range is deliberate — it nudges ranking rather than dominating it, because it applies to many documents at once.
  1. Add a category and give it a clear Name.

  2. Choose the Tag Type — document or folder.

  3. Write a Category Description. This is how the assistant knows which questions the tag should apply to, so be specific and include synonyms and example phrasings.

    • Folder tags require at least 100 characters — the form counts down until you reach it.
    • For document tags it is optional. Left empty, the category’s name is used for matching instead.
    • Maximum 2,000 characters either way.
  4. Set the Boost Multiplier within the range for that type.

  5. Set the Similarity Threshold0.15 to 0.90, default 0.50. This applies to both tag types.

On the Documents tab, use Add folder tag. Because the tag is inherited, one tag on the right folder does the work of hundreds of document tags.

The Document Library Tags tab, showing tagged folders above the boost categories list

  • Tag folders before documents. Inheritance means one well-placed folder tag beats a long tagging session.
  • Write descriptions for the question, not the document. You are describing what someone would ask, not what the file is called.
  • Check Untagged periodically. Documents there get no preference at all, which may be exactly right — or may mean an important collection was missed.
  • Clear Needs attention before blaming the assistant. “The AI can’t find our safety manual” is usually a never-indexed document, not a retrieval problem.
  • Do not over-boost. If everything is authoritative, nothing is. Reserve high multipliers for documents that genuinely should win.
  • Keep the approval queue short. Files waiting there are invisible to the assistant, so a neglected queue looks like missing knowledge.

A document is in the library but the assistant never uses it

Section titled “A document is in the library but the assistant never uses it”

Solutions:

  • Open Needs attention. The likely cause is never indexed — the document processed, but no searchable content came out of it.
  • Select it and click Retry processing.
  • Scanned PDFs with no text layer are the common culprit. If retrying does not help, replace the file with a text-bearing version.

I tagged a document but answers have not changed

Section titled “I tagged a document but answers have not changed”

Solutions: check these in order.

  1. Is the Similarity Threshold too high for the questions being asked? Lower it and try again.
  2. Is the Category Description specific enough to match the question?
  3. Is the document actually indexed? A boost cannot promote content that was never indexed.

Solutions:

  • Check Tagged folders on the Tags tab. If your folders carry no tags, then Untagged is accurate rather than a fault.
  • Tag the folder that holds your authoritative material. The count drops sharply, because the tag is inherited by everything inside it.

Solutions:

  • Look at the Sync paused card on Activity. A scan that found more changes than its safety limit pauses deliberately — review what changed, then resume.
  • Check API budget today. A source system’s daily allowance can be used up, which stops the sync until it resets.

Solutions:

  • That is Orphaned sections on the Activity tab — the searchable content outlived its document.
  • Click Clean them up to remove it.