Your agent, explained

Updated July 2026

An agent is one AI worker you set up once and put to work everywhere — answering WhatsApp messages, picking up phone calls, chatting on your website. This page shows what an agent is made of, where everything lives, and what you can do with one.

Think of an agent as a new team member. You give it instructions, a voice, your business information, and the things it's allowed to do — then you put it to work on any channel you like. The same agent can answer a WhatsApp chat, pick up a phone call, and power the chat box on your website, without you rebuilding it for each one.

What an agent is made of

  • Instructions — the agent's standing brief, its opening line, and the placeholders that personalize each conversation. See What your agent says.
  • A voice and dialect — supplied by a reusable persona that bundles voice, language, dialect, and tone. See Voice & dialect.
  • Your business info — knowledge bases (shown as Data sources) the agent answers from instead of guessing. See Add your business info.
  • Actions — things the agent can actually do: built-in actions, custom actions that call your own systems, and ready-made toolkit integrations. See Let it take actions.
  • Rich replies in chat — the cards, buttons, and other UI the agent can show inside a chat window. See Rich replies in chat.
  • Grading rulesSuccess Criteria (weighted rules with a passing score that grade every conversation) and Data Extraction (named details the agent pulls out of each conversation for your records).
Note:
an agent always needs a persona before it can be saved — its voice, language, and tone come from there, not from the agent itself. The AI model behind it comes from your organization-wide settings; see Choose the AI model.

Where your agents live

Click Agents in the left menu to see every agent in your organization, newest first. Each one shows its name and description, a status badge (Active, Paused, or Archived), the persona it uses, and the channels it's connected to. You can search by name and description, filter by status and persona, and switch between list and grid views — your choice is remembered. The dashed + in the Channels column jumps straight to connecting that agent, and the list shows 10 agents per page.

app.qalyb.ai/agents
Screenshot: the Agents list with status badges, persona pills, a connected-channels column, and the List and Grid toggle
Every agent in your organization, with its status, persona, and connected channels.

Create, test, deploy

Every agent goes through the same three moves.

Create it

Click Create Agent on the Agents page. A full-screen wizard opens: give it your website address and a short description of the job, and Qalyb generates a working agent for you — instructions, a suggested persona, and a knowledge base built from your site. The wizard ends by dropping you straight into the Playground.

app.qalyb.ai/agents/new
Screenshot: the Create Agent wizard asking for a website address, with a Research my business on the web toggle
The wizard turns a website and a description into a working agent.
Talk to it

The Playground opens as soon as generation finishes, so you can talk to your new agent right away — over voice or chat. Come back any time with the Test button at the top of the agent's page.

Put it to work

Click Deploy at the top of the agent's page to open the Channels hub, where you connect the agent to a chat widget, WhatsApp, Telegram, a phone number, email, and more. See Where it works.

Two ways to create:
the wizard is the default and the right choice for most people. If you'd rather build by hand — from scratch, from a template, or from a raw AI prompt — open /agents/new?mode=advanced, or deep-link a template with /agents/new?templateId=….
Plan limits:
your plan caps how many agents you can create and how many you can deploy. On the Free plan the deploy limit is 0 — you can test in the Playground, but you'll be asked to upgrade before connecting a channel or creating a share link. How many integrations each agent can attach is also set by your plan.

If the wizard interviews you

When you submit the wizard, Qalyb checks how much detail your description carries. If it's rich enough, you get your agent in one shot. If it's too thin, the wizard asks a short interview instead — 2 to 6 multiple-choice questions, each filling in a missing piece: the job to be done, the audience, how conversations should flow, when to escalate, what data to capture, guardrails, and tone. Every question comes with a recommended answer, and you can Skip to generate right away or go Back a question. Your answers are woven into the generated instructions.

Inside the agent builder

Open any agent to reach its builder, which is organized in the order a real conversation unfolds:

  • Setup — the agent's identity (name, status, description, and the First Message it opens with) and its required persona.
  • In-conversation — the instructions and variables, your data sources, the agent's actions, and its chat UI.
  • Post-analysis — the Success Criteria that grade each conversation and the Data Extraction fields captured from it.
app.qalyb.ai/agents/[id]
Screenshot: the agent builder with Setup, In-conversation, and Post-analysis sections and the sticky Deploy, Test, and Share Links bar
The builder follows the life of a conversation, with the action bar pinned on top.

The sticky bar across the top groups everything you can do to an existing agent:

ActionWhat it doesWho can use it
DeployOpens the Channels hub to connect the agent to a channel.Org members
TestOpens the Playground to talk to the agent over voice or chat.Org members
Share LinksCreates public, no-login URLs to the agent, with optional password, expiry, and outbound-call opt-in.Org members
Save as TemplateSnapshots the current setup into a reusable template under a category.Org admin
DeleteArchives the agent and disconnects it everywhere (see below).Org admin
Delete archives, it doesn't wipe:
deleting an agent first shows you exactly what will happen — phone numbers released, channels disconnected, widgets disabled, in-progress campaigns stopped — and asks you to type I understand. The agent is then archived rather than erased, and your call and chat history stays available in your analytics.

Share it with a link

Share links let anyone talk to your agent through a URL — no Qalyb account needed. From Share Links in the builder's top bar, create a link with a name, an expiry (24 hours, 7 days, 30 days, or never), an optional password, and an Allow outbound calls toggle. You get a QR code and the URL with Copy, Open, Open HQ, and Email actions, and each link keeps its own conversation history that you can review and delete. More in Share links.

Outbound calls from a share link cost you:
when Allow outbound calls is on, visitors can enter a phone number and have the agent call them — and your organization pays for those minutes. It's off by default. A share link also counts as a deployment, so Free plans must upgrade first.

Reuse what works

Save as Template turns a finished agent into a starting point: org admins pick a category, name, and description, and the template then appears in both creation flows — the wizard's Start from a template picker and the advanced From template selector.

Was this guide helpful?