Skip to navigation

Concepts

The handful of ideas the rest of the docs rely on.

Read this page once. Every other page uses these words the same way.

Workspace

A workspace is your team’s space in Rydhm. It holds your experts, their knowledge, tools, phone numbers, conversations and billing. Everything you create belongs to one workspace, and the top bar always shows which one you’re in.

Members and roles

People join a workspace as an admin or a member (a workspace can also have an owner).

  • Admins create, configure, publish and delete experts, manage knowledge and tools, and see billing.
  • Members talk to experts, read their settings and conversations, and can edit an expert’s name, description, picture and background. Tabs an admin manages show a lock and read-only values.

See Members and roles.

Expert

An expert is one AI agent. It has:

PartWhat it decidesWhere you set it
Persona and first messageWho it is, how it behaves, what it says firstProfile tab
VariablesBlanks like {{name}} filled in for each conversationProfile tab
GuardrailsHow strictly it stays on topic, rules, blocked topicsProfile tab
KnowledgeWhat it knowsKnowledge tab
Voice engine, voice and languagesHow it hears, thinks and speaksVoice tab
Call experienceTurn-taking, silence, call length, background soundVoice tab
Tools and specialistsWhat it can do, and who it can hand a call toTools tab

The expert editor also has Phone, Meetings, Share and Analysis tabs for its channels and results. An expert has an Active switch on its Profile tab: when it’s off, customers can’t talk to it.

Voice engine

The voice engine is how an expert turns speech into speech. There are three:

  • Pipeline: a transcriber, a language model and a voice, each chosen separately. The default.
  • Gemini Live: one Google model hears and speaks.
  • GPT-Live: OpenAI’s full-duplex model, which listens while it speaks. One-on-one conversations only.

See Voice engines.

Knowledge

Knowledge is the material an expert answers from: files, pasted text, pages imported from a website, and question-and-answer sets. An expert has its own knowledge, and can also use shared knowledge that several experts read at once. When an expert’s knowledge is small, it reads all of it on every turn; when it is large, it searches it for each question. See Knowledge overview.

Tools

A tool is something an expert can do during a conversation: end the call, look up a calendar, send an email, search the web, or call your own API. Some tools ask the caller to confirm before they act. See Tools.

Channels

A channel is a place people reach an expert:

Visibility

Every expert is Private, Unlisted or Public:

  • Private: only your workspace can talk to it.
  • Unlisted: anyone with its link can talk to it, by voice or chat.
  • Public: anyone can, and it is listed in the public directory.

You change visibility with Publish in the expert’s header. Usage on an Unlisted or Public expert is billed to your workspace.

Members and visitors

Rydhm treats two kinds of caller differently:

  • Members are signed in to your workspace: the Test panel, in-app chat and calls, and meetings an expert joins for you.
  • Visitors are everyone else: share links, the website widget and phone callers.

A visitor’s conversation can use the expert’s knowledge, its conversation controls and web search. Actions on your workspace (calendar, email, your own API tools, outside tool servers, hand-offs) run only for members. See Tools.

Conversation

A conversation is one chat, call or meeting with an expert. Rydhm keeps its transcript, and can summarize and analyze it. All of them are listed under Conversations in the sidebar. See Conversations.

Version

Each time an expert is created, saved, published or restored, Rydhm keeps a version: a snapshot of its settings, with who made it and what changed. You can compare versions and restore one. See Versions and testing.