Manuals · manuals/04-knowledge-spaces.md Docs Home

Manual 04: Knowledge Spaces

What This Guide Is For

Use this guide to add knowledge that Agents can search and cite.

What A Space Is

A Space is a knowledge area. It can contain files, websites, videos, conversations, and other sources.

Agents can use Spaces to answer questions with workspace-specific context.

Step 1: Create A Space

  1. Go to Spaces.
  2. Select Create Space.
  3. Add a name and description.
  4. Choose who can access it.

Expected result: an empty Space is ready for sources.

Step 2: Add Files

  1. Open the Space.
  2. Select Add files.
  3. Upload documents, PDFs, images, audio, video, or spreadsheets.
  4. Wait for processing to finish.

Expected result: files appear in the Space with a processing status.

Step 3: Add Websites

  1. Select Add website.
  2. Paste a URL.
  3. Choose single page or crawl options if available.
  4. Start ingestion.

Expected result: the website content becomes searchable after processing.

Step 4: Add Video Or Audio

  1. Upload the media file or add a supported URL.
  2. Wait for transcription or analysis.
  3. Review extracted text if the platform provides a preview.

Expected result: Agents can search the transcript or extracted content.

Step 5: Connect A Space To An Agent

  1. Go to Agents.
  2. Open the Agent.
  3. Open Knowledge.
  4. Select the Space.
  5. Save and test.

Expected result: the Agent can answer using that Space.

Step 6: Review Sources

  1. Ask the Agent a question based on the Space.
  2. Check the answer.
  3. Open cited sources or source previews.
  4. Fix or remove bad sources if needed.

Troubleshooting

  • If a source is not searchable yet, check ingestion status.
  • If answers are wrong, inspect the source preview.
  • If the Agent cannot access a Space, check Agent knowledge settings and user permissions.
  • If processing fails, try a smaller file or supported format.

Product Decisions Needed

  • Final ingestion statuses.
  • Whether Spaces remain Google-backed or move into the Hetzner stack.
  • How source citations appear in chat and reports.