Skip to main content

Knowledge

Knowledge is where you bring your own content into RedFlare so your agents answer from facts you trust. You group documents and web pages into collections, and your agents draw on them to stay accurate and consistent instead of guessing.

Knowledge

Think of a collection as a folder of source material. Inside it you add articles, which are the actual documents or URLs RedFlare reads, indexes, and makes searchable. When you connect a collection to an agent, it can refer to that content the moment it needs to answer a question.

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, RedFlare does more than store a file. It runs your content through an indexing pipeline so your agents can find the right passage by meaning, not just by keyword.

  1. Upload and capture. Your document is uploaded to secure storage. For web articles, RedFlare scrapes each page you listed and saves the text it pulls back.
  2. Queued for processing. The article is handed to a background worker. While it waits and runs, you will see it move through states like waiting, queued, and processing, so you always know it is in flight.
  3. Read and split. RedFlare extracts the text from your PDF or scraped pages and breaks it into smaller, searchable passages.
  4. Vectorize. Each passage is turned into a numerical fingerprint (an embedding) that captures its meaning. RedFlare uses a high-quality embedding model for this.
  5. Index for search. Those fingerprints are stored in a vector index tied to your collection and your tenant, kept separate from every other customer's data.
  6. Ready to use. When indexing finishes the article is marked complete. If you turned on Publish When Ready, it goes live to your agents automatically; otherwise it waits for you to publish it.

Because content is matched by meaning, an agent can answer a question even when the wording does not exactly match your source. When an agent has a collection attached, it searches that index for the most relevant passages and grounds its reply in them.

note

Web articles are fetched once at the time you add them. RedFlare 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.

tip

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, vectorized knowledge hub.

  1. Open the collection you want to add to.
  2. Select New Article (or Create New Article).
  3. Enter a name in the Enter Article Name field and a summary 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.
  5. Select the create action to save the article.

When you choose Document, RedFlare shows the supported formats beneath the drop zone (currently PDF). When you choose URL, you can add several pages to a single article, up to a maximum of 5 URLs, and RedFlare scrapes each one and combines the text into a single searchable article.

note

Article names must be between 6 and 30 characters, and descriptions between 20 and 100 characters. RedFlare will prompt you if either is too short or too long. A file is required for a document-type article.

Publish when ready​

While creating an article you can turn on Publish When Ready. With it enabled, the article is published automatically once indexing is complete, so you do not have to come back and publish it yourself.

After you add an article, RedFlare reads, splits, and indexes it. Each article shows a status so you always know where it stands:

  • processing while RedFlare reads, splits, and indexes the content
  • published when it is live and available to your agents
  • un_published when it is held back from agents
  • draft before it goes live
  • failed if processing did not complete
tip

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​

Content changes, and RedFlare keeps a history so you can update without losing the past. Each version carries its own version number and file size, so you can tell them apart at a glance.

  1. Open the article you want to change.
  2. Choose Update Article to edit its details, or Upload New Version to replace the source content.
  3. When uploading a new version, tick Make this as active version to set it as the current one immediately and re-index it.

To review past versions, open Version History. From there you can Set Active on any version to make it the one your agents use. If an article has no history yet, you will see No Version Found.

tip

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​

Knowledge becomes useful when an agent draws on it. When you configure an agent, you can attach a collection so it has documents and sources to refer to when answering, choosing a collection to get data from the Knowledge Base.

Use Select Collection in the agent's knowledge settings to point it at the right material. From then on, the agent searches that collection's index for the most relevant passages and grounds its answers in them. This is what keeps your agents accurate and consistent instead of guessing.

note

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.

  • To remove a single article, open it and choose Delete this Article. This also removes its indexed content so agents stop drawing on it.
  • To remove an entire collection, choose Delete this Collection. RedFlare asks you to confirm by typing the collection name before it proceeds.
caution

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