kestrel-one

Reuse trusted material with Knowledge

Add organization documents once, track their processing state, and make them available to the Projects that need them.

Kestrel OnebeginnerCurrent releases
Verified 2026-08-04View sourceReport a docs issue

Knowledge is reusable source material owned by your organization. A Project can select relevant Knowledge without copying the same document into every Thread.

Knowledge versus runtime memory

Knowledge contains organization or Project documents selected through revisioned context. Runtime memory contains governed durable facts with subject, issuer, provenance, and query authority. Conversation history remains the Thread itself.

Kestrel One Knowledge library showing organization documents and processing status
Knowledge makes document readiness visible before a Project depends on the material.

Add a document

  1. Open Knowledge at /knowledge.
  2. Upload a supported document or promote an attachment from a Thread.
  3. Wait for processing to reach ready before relying on it in new work.
  4. Open a Project and select the material its Threads should be able to retrieve.

Read the processing state

StateMeaningWhat to do
uploadedThe original file is storedWait for processing to begin
processingText and searchable sections are being preparedReturn later to check progress
readyThe document is searchableAdd it to the intended Project
partialSome material is usable, with warningsReview the warning before relying on it
failedProcessing did not completeCorrect the source problem or request a reindex

Governed retrieval

Kestrel resolves the signed-in actor, organization, Project, selected revision, and query authority before returning grouped results. Each result retains document and section provenance.

Use Knowledge in a Thread

Select the material in the Project, start a turn under the resulting context revision, and inspect cited sources. Adding a document to the organization does not make it available to every Project automatically.

Remove or replace material

Changes affect future revisions. Historical turns retain the source identity they actually used even if the current Project selects a replacement.

Troubleshoot retrieval

Inspect processing state, organization/Project access, selection in the current revision, indexing warnings, and query authority before requesting a reindex.