Skip to main content
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. What it means depends on the channel:

Voice calls

Each agent handles one call at a time. With 5 agents, you can run 5 calls simultaneously.

Text conversations

Each agent adds 3 messages per minute of capacity. With 10 agents, that’s up to 30 messages per minute.
Text capacity scales linearly: the message rate limit is 3 messages per minute per agent - so 1 agent → 3 messages/minute, and 10 agents → 30 messages/minute. Your agents set both your simultaneous-call capacity on voice and your message rate on text.

​
Set up agents for your activities

Agent allocation is configured from the Pearl overview after the Pearl has been published.
1

Purchase agents

Add agents from Settings > Agents to grow your workspace capacity. How many you need depends on your peak call volume and expected message rate.
2

Allocate them from the overview

After publishing your Pearl, open the Settings section from its overview page and assign agents to an inbound or outbound activity. Allocate 2 agents to a campaign and it calls 2 leads at a time.
3

Adjust anytime

Return to the Pearl overview to scale the number of agents on any activity up or down as your needs change.
To add or remove agents from your workspace, open Settings > Agents, set the number you want, and confirm. To assign those agents to an activity, open the published Pearl’s overview page.

​
Example

Voice - allocate 2 agents to an outbound campaign and it dials 2 leads at the same time. Add more agents to widen your reach. Text - with 10 agents, your text agent handles up to 30 messages per minute across conversations.

​
Subscription and billing

Every plan includes a set number of agents at no extra cost - higher tiers include more. You can add extra 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.

​
Removing an agent

There are no pro-rata refunds. If you remove an agent, it 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). It won’t be billed again in the next cycle.