Glossary

Quick-reference definitions for every term Saaya uses in code, docs, and the dashboard. When in doubt, check here first.

Platform

• Agent, a unit of conversational behaviour: a system prompt plus a model, a voice, speech settings, and any knowledge bases attached to it.
• Channel, the surface a conversation runs on: voice, video, or chat.
• Session, a single conversation instance, with a transcript, a duration, a cost, and any recording.
• Knowledge base (KB), an indexed corpus the agent retrieves from.
• Version, a snapshot of an agent's configuration; an agent has a draft and, once published, a published version.
• Widget, a published agent wrapped for embedding on a web page.

People and policy

• Organization, the workspace boundary; the unit of billing and access control.
• System role, SUPER_ADMIN (Saaya staff) or USER (everyone).
• Org role, OWNER, ADMIN, MEMBER, VIEWER.
• Permission, a fine-grained capability an endpoint requires, bundled into roles.
• API key, a credential scoped to one organization, used for programmatic calls.

Conversation

• Turn, one speaker contribution in a session (user or agent).
• Barge-in, interrupting the agent mid-sentence with a new utterance.
• Turn detection, deciding when the caller has finished speaking so the agent can reply.
• Retrieval, pulling the most relevant knowledge-base passages into the conversation.
• Top-k and minimum score, the two dials that control how much retrieval returns and how relevant it must be.

Operations

• Campaign, a batch of outbound sessions driven from an uploaded list or a filter.
• Fallback channel, the single alternative channel a campaign may try.
• Reserved concurrency, how many calls one campaign may hold open at once.
• Credit, the Saaya-side unit a session's usage is drawn down against.