Core concepts

Five nouns carry almost everything you build on Saaya: agent, knowledge base, channel, session, and version. Get these right and the rest of the platform is just configuration.

Agents

An agent is the unit of behaviour. It bundles a system prompt, an LLM choice, a voice, speech-to-text settings, and optional knowledge bases. Agents live inside an organization and never leak across workspaces.

Knowledge bases

A knowledge base is an indexed corpus the agent can ground answers in. You add sources to it, and at runtime the agent retrieves the most relevant passages. Retrieval is tunable per agent with a minimum-score threshold and a top-k limit.

Channels

A channel is the surface the conversation runs on: voice, video, or chat. One agent can be attached to more than one channel, the prompt is the same, but Saaya adapts turn-taking and speech output per surface.

Sessions

A session is a single conversation. It has an id, a transcript, a duration, a cost, and (on voice / video) a media recording. Sessions are append-only, you observe and export them, but you do not edit them.

Versions

An agent carries a draft version and, once published, a published version. Publishing promotes the current draft; an earlier version can be restored from the version list.