Workspace

Knowledge

Knowledge is the retrieval input layer in Calypso RAG. Use it to add, review, search, and govern the source pool your grounded agents are allowed to use.

What Knowledge is for

Knowledge is the source-management center for Calypso RAG. It defines what the agent can search before it answers.

This is where the product becomes trustworthy or noisy. Good knowledge design improves every downstream surface. Poor knowledge design creates confusion everywhere else.

Source types

The app supports these source kinds:

  • Files
  • Websites
  • Q&A
  • Intents (legacy-compatible content path)

For most RAG-first teams:

  • files and websites are the main path
  • Q&A is useful for curated deterministic answers
  • intents matter mainly when carrying legacy assets forward

Good source design

Aim for sources that are:

  • canonical
  • reviewable
  • current enough to trust
  • narrow enough to avoid noise

Avoid:

  • secrets
  • credentials
  • personal data you would not want repeated
  • unstable pages with no clear source of truth

Operational tasks

The Knowledge page supports:

  • adding sources with a wizard
  • filtering by source type
  • searching by title, URL, filename, tags, and intent content
  • inspecting details
  • deleting sources
  • replacing legacy intents JSON when needed

Indexing reality

Do not assume "uploaded" means "ready for retrieval."

Knowledge items may move through states such as:

  • queued
  • processing
  • active
  • ready
  • failed

Playground results are much easier to interpret when indexing has settled first.

  1. start with the smallest reliable source set
  2. test it in Playground
  3. add more material only when you can explain why it improves retrieval

Next steps