Enok

Knowledge

Knowledge is where you bring your own content into Enok so agents answer from material you control. Content is organised into collections, logical groupings of source material, which contain articles, the individual PDFs and web pages that Enok reads, indexes, and makes searchable by meaning.

When a collection is attached to an agent, the agent searches it at the moment it needs to answer a question, retrieving the most relevant passages from across all published articles in that collection. Sources remain private to your workspace and are never shared across workspaces.

What you can do

  • Create collections to group and organize multiple knowledge bases into a single collection for related datasets or projects.
  • Add articles by uploading a document (PDF) or connecting one or more web pages.
  • Keep articles current by uploading new versions and choosing which version is active.
  • Track each article's status as it moves from processing to published.
  • Search across your collections and the articles inside them.
  • Choose a collection to feed an agent, so it answers from your own content.

How it works

When you add an article, Enok does more than store the file. It processes the content to prepare it for semantic retrieval.

  1. Upload and capture. The document is stored in secure storage. For web articles, Enok fetches each URL and captures the page text.
  2. Processing queue. The article enters a processing pipeline. Status indicators, waiting, queued, processing, reflect progress in real time.
  3. Text extraction and indexing. Enok extracts the text from the PDF or web content, splits it into passages, and builds a semantic index.
  4. Publication. When indexing completes, the article is marked as ready. If Publish When Ready was enabled, it goes live automatically. Otherwise, it waits for manual publication.

Because content is matched by meaning, an agent can answer a question even when the wording does not exactly match your source. Your sources stay private to your workspace, separate from everyone else's. When an agent has a collection attached, it searches your content for the most relevant passages and grounds its reply in them.

Web articles are fetched once at the time you add them. Enok indexes the text it captured, so if a page changes later you will want to upload a new version to refresh it.

Create a collection

Collections sit in the left panel under the Collections header. If you have none yet, you will see the empty state titled Create a New Collection.

  1. Open Knowledge from the sidebar.
  2. Select New Collection (or Create New Collection).
  3. Enter a name in the Enter collection name field.
  4. Add a short summary in the Enter collection description field.
  5. Select Create Collection to save it.

Your new collection appears in the list, ready for you to add articles. To rename or revise it later, open Edit Collection.

Use one collection per project or topic. Grouping related material keeps your agents focused and makes it easier to manage datasets as they grow.

Add an article

Open a collection to see its articles. A fresh collection shows the Get Started with Your Knowledge Base empty state, inviting you to turn your data into a searchable knowledge hub.

  1. Open the collection you want to add to.
  2. Select New Article (or Create New Article).
  3. Give it a short name in the Enter Article Name field and a one-line description in the Enter Article Description field.
  4. Under Article Type, choose how to add your content:
  • Document to upload a file. Drag a file into the drop zone or browse to it.
  • URL to connect a web page. Type the address in the Enter URL field.
  1. Select the create action to save the article.

When you choose Document, Enok shows the supported formats beneath the drop zone (currently PDF). When you choose URL, you can group a few related pages into one article, and Enok reads each one and combines the text into a single searchable article.

A file is required for a document-type article.

Publish when ready

While creating an article, you can enable Publish When Ready. With this on, the article is published automatically once indexing completes, removing the need to return and publish it manually.

Article statuses reflect the processing pipeline:

  • Processing - Enok is reading, splitting, and indexing the content.
  • Published - the article is live and available to agents.
  • Un-published - the article exists but has been withheld from agents.
  • Draft - Yet to be live.
  • Failed - processing did not complete successfully.

If an article lands on failed, the source was uploaded but could not be fully indexed, often a scanned or image-only PDF, or a web page that blocked scraping. Upload a new version with selectable text or a different source to try again.

Update an article and manage versions

Enok maintains a version history for each article so content can be updated without losing prior versions.

  1. Open the article you want to update.
  2. Select Update Article to edit metadata, or Upload New Version to replace the source content.
  3. When uploading a new version, enable Make this the active version to reindex immediately.

To review prior versions, open Version History. Any version can be reinstated with Set Active. Only the active version is searched by agents.. If an article has no history yet, you will see No Version Found.

Uploading a new version is the safe way to refresh a document. Your earlier versions stay in Version History, so you can always switch back with Set Active. Only the active version is what your agents search.

Connect a collection to your agents

A collection becomes available to an agent when it is explicitly attached. In the agent's Configure → General tab, use Select knowledge base to choose the collection. From that point forward, the agent searches the collection's published articles whenever it needs to answer a question. This is what keeps your agents accurate and consistent instead of guessing.

Only published articles in the attached collection are available to an agent. Articles still processing, held back, or in draft will not be searched until they go live.

Find things quickly

As your knowledge base grows, two search boxes keep it manageable:

  • Search collections to filter the list in the left panel.
  • Search articles to find an article within the open collection.

Delete a collection or article

Cleaning up is deliberate, so nothing important disappears by accident.

  • Delete an article. Open the article and select Delete this Article. This removes the article and its indexed content; agents stop drawing on it immediately.
  • Delete a collection. Select Delete this Collection. Enok requires you to confirm by typing the collection name before proceeding.

Deleting a collection cannot be undone. Once you delete a collection, there is no going back, so be certain before you confirm.