Skip to main content
Agents cover
Agents cover
In NLPearl, agents are your capacity to handle activity. They power both your voice calls and your text conversations - the number of agents you have determines how much you can run at the same time.

​
How agent capacity works

An agent is a virtual unit of capacity — not a person and not a specific Pearl. Think of it as one “lane” of throughput that your whole workspace shares.
The more agents you own, the more activity you can run in parallel. What a single agent unlocks depends on the channel:

Voice calls

Each agent handles one call at a time. With 5 agents, you can run 5 calls simultaneously — a 6th call waits until one frees up.

Text conversations

Each agent adds 3 messages per minute of throughput. With 10 agents, that’s up to 30 messages per minute, spread across all your open chats.
The key difference: on voice, an agent limits how many calls run at the same time (concurrency). On text, an agent doesn’t cap the number of open conversations — it sets how fast Pearl can reply across all of them (a message rate). Capacity scales linearly: 1 agent → 3 messages/minute, 10 agents → 30 messages/minute.
Agents are shared at the workspace level. You buy them once, then allocate them to each inbound or outbound activity from the Pearl overview — so a busy campaign can use more lanes while a quieter one uses fewer.

​
Set up agents for your activities

Agents are managed at the workspace level from your Settings, then allocated to each Pearl from its overview page once published.
1

Open the Agent(s) settings

Click your profile card at the bottom-left of the sidebar, open Settings, then select the Agent(s) tab. This is where you purchase, review, and remove the agents in your workspace.
Agent(s) tab in workspace Settings
2

Purchase agents

Use the Purchase New Agent(s) bar at the top: set the quantity, review the monthly price, and click Purchase Agent(s). You’re billed immediately (see Subscription and billing).
Adding concurrent agents requires an active paid subscription. Extra agents can only be purchased on a paid plan.
Purchase New Agent(s) bar in the Agent(s) settings
3

Review your agents

The list shows every agent in your workspace, with its creation date.
List of agents in the workspace
Agents that come with your subscription are flagged with an Included in your plan badge — these are free and can’t be removed.
Included in your plan badge on a plan agent
4

Remove an agent

To remove an extra agent, click the red trash icon next to it.
Remove an agent with the trash icon
There are no pro-rata refunds — the agent stays active until the end of the period you’ve already paid for.Example: you remove an agent on the 5th, but your last renewal was on the 1st. The agent stays available until the end of that paid period (the 30th), and won’t be billed again in the next cycle.
5

Allocate agents to a Pearl

After publishing your Pearl, open its overview page, open the Settings popover, and set the number of Agent(s) for that activity. Allocate 2 agents to a campaign and it handles 2 leads at a time. You can scale this up or down anytime.
Allocate agents to a Pearl from its overview Settings

​
Example

The same number of agents translates differently on voice and text. Here’s how a given allocation plays out:For example, allocate 2 agents to an outbound voice campaign and it dials 2 leads at the same time; the same 2 agents on a text Pearl let it reply at up to 6 messages per minute across all open chats.

​
Subscription and billing

Every plan includes a set number of agents at no extra cost - higher tiers include more. On an active paid subscription, you can add extra concurrent agents at any time to grow your capacity. Standard agents are billed at a flat monthly rate. Enterprise use and fine-tuned models cost more, depending on model complexity. See Billing for current pricing.

​
When you’re billed

When you purchase an agent, you’re billed for it immediately, whatever point you’re at in your billing cycle. On your renewal date, every additional agent renews automatically for the next period.
Buying an agent shortly before your renewal date means two charges close together: one when you purchase, and one when everything renews.Example - your subscription renews on the 1st and you add an agent on the 29th. You’re billed for it right away. On the 1st, the whole subscription (including that agent) renews, so it’s billed again for the new period. You’ve effectively paid for two periods, and you keep the agent for the full duration of each.