Overview
Knowledge Stack’s AI assistant is powered by a fleet of stateless agents that can search your knowledge base, process information, and stream responses in real time. Each agent invocation is independent and self-contained — no state persists between conversations.Key Properties
How It Works
When you send a message to the AI assistant, the following sequence occurs:- You send a message via
POST /v1/threads/{id}/run - The API returns immediately with
202 Acceptedand aworkflow_id - An agent worker picks up the task from the queue
- The agent retrieves context — your thread history and any memory documents you have configured
- The agent processes your request, potentially searching your knowledge base or using other tools
- Responses stream in real time via SSE (Server-Sent Events) as the agent generates them
- The final message is saved to your thread
Performance Targets
Agent Capabilities
What Agents Can Do
Agents have access to a focused set of tools for working with your knowledge base:What Agents Cannot Do
By design, agents have a restricted scope:- Agents can read from your knowledge base and write to threads only
- Agents cannot modify documents, folders, or any other content
- Agents cannot access external networks or services beyond the knowledge base and LLM provider
Memory Documents
You can influence agent behavior by providing memory documents — regular documents in your knowledge base that are injected as context for the agent’s system prompt. This means you can:- Give the agent domain-specific instructions
- Define response formatting guidelines
- Provide background context that the agent should always consider