Update a knowledge base
Add documents, rename, remove files, or delete a knowledge base you already have running.
A knowledge base rarely stays static: policies get revised, new documents arrive, and old ones get pulled. Continuing with the FAQ knowledge base from Create a knowledge base, this guide covers the four ways you keep it current: adding more documents, renaming it, removing individual files, and deleting it altogether.
Open FAQ knowledge base from the knowledge base list (/dashboard/knowledge) by clicking its row to reach its detail screen at /dashboard/knowledge/:knowledgeId. Adding documents, renaming, and removing files all happen from that detail screen; deleting the knowledge base itself happens from the list instead.
The detail screen carries every file with its processing status, and Add docs in the header
Note
Create Synthetic data on the detail screen, which grounds a synthetic dataset in this knowledge base, stays disabled until the knowledge base’s status reads Completed on that screen. Adding or removing files restarts reprocessing, so check the status shown on the detail screen after either change before trying to generate synthetic data.
Add more documents
From the knowledge base detail screen, click Add docs. This opens the same drawer you used in Create a knowledge base, now titled Add files with the helper text “Add more files to update your knowledge base.” Pick your files the same way, then click Add to submit.
Everything you add still counts against the knowledge base’s 1 GB total, and a file whose name already exists in FAQ knowledge base is refused at submission rather than added as a duplicate.
Rename the knowledge base
Click the pencil icon button on the detail screen to open the Edit Name dialog. It has a single field labeled Knowledge base holding the current name. Change it and click Save, or Cancel to leave it as it is.
Remove files
From the knowledge base detail screen, select one or more file rows. A bar reading {n} Selected appears with Delete and Cancel buttons. Click Delete on the selection bar, then confirm in the dialog titled Delete {n} file(s), which asks whether you’re sure you want to delete the selected file(s).
Confirming switches the detail screen to an “Updating Knowledge Base” state while the change processes, then a toast confirms the result, for example {n} files have been deleted.
Selecting all rows in the table only selects up to 20 at a time. A deleted file is gone; there’s no way to bring it back. Clicking Delete without selecting anything just warns “No files selected.”
Delete the knowledge base
Deletion happens from the knowledge base list, not the detail screen. Select one or more knowledge bases there to bring up the same {n} Selected bar, and click Delete. Confirm in the dialog that follows, titled Delete Knowledge Base for one or Delete Knowledge Bases for several, asking “Are you sure you want to delete this knowledge base?” A toast then reads “Knowledge base deleted successfully.”
A deleted knowledge base is gone along with its files. You can delete one even while its files are still processing; doing so stops that work in progress rather than waiting for it to finish.
Dive deeper
Questions & Discussion