Help Center

Docs

Building Your Own Agent

Describe the agent in your own words, read the plan it comes back with, decide what it may do on its own, and test it on real data before anything runs.

You describe it, in a conversation

From the Agents home, choose New agent. What opens is a thread, not a form.

New agent opens a conversation. You say what you want an agent to handle, Laureo looks at your data, works out what the agent needs, and shows you the whole thing before anything is created. There is no wizard to step through and no set of fields to fill in first.

1

Describe it

Write what the agent should watch for and what it should do about it. A sentence or two is enough, the way you would brief a new teammate.
2

At most one round of questions

If something it genuinely needs cannot be worked out from your data, it asks once: which records it should work on, and anything it should leave alone. If nothing is missing, it does not ask at all.
3

It works out the scope

It reads what your workspace actually holds to decide which record type, which actions and which schedule fit what you asked for.
4

It shows you the plan

The closing turn is a set of cards you can inspect: what the agent will do, what it will be allowed to change, when it runs and on which records, and the real records it would act on first.
5

You decide how it should run

Three rows, one press. Nothing exists until you press one of them.
6

You test it

Once it exists as a draft, run it against one of your real records and read what it would do, before you publish it.
This is a Business and Ultra feature
Building your own agent is available on the Business and Ultra plans. On lower paid plans you can still run the preset agents and build deterministic automation rules.

Start from an example

A row of example briefs above the box, for when a blank box is the hard part.

Above the box is a row of example briefs, each one a job an agent can do. Pressing one puts its brief in the box so you can change it. A chip never sends: what you press is a starting sentence, and what the agent is built from is whatever you leave in the box.

FieldDescription
Lead RouterAssigns each new lead to the right owner and opens a first task for them.
Meeting Follow-UpTurns each finished meeting into a recap on the record and a drafted follow-up.
Ticket TriageSorts new support tickets by urgency and drafts a first reply for review.
Project Check-InWrites a weekly update for every live project and flags the ones slipping.
Onboarding KickoffOpens a delivery project with its first tasks the moment a deal is won.
Campaign RecapReports how each campaign performed and opens the follow-ups worth making.
Win-Loss ReviewReviews closed deals and records why each one was won or lost.
No-Show RecoverySpots bookings nobody turned up to and drafts an offer of another time.

Building one with a form instead

A short deterministic form for when the conversation cannot run.

When the conversation is unavailable, the composer offers Build it with the form instead. The form asks for three things: a name, a brief, and a preset agent to start from. Under them it states, read only, what that preset will be able to do, so you can see the whole shape before you create anything.

Three things are worth knowing about the form. It creates a draft, and nothing runs until you publish it. It has no per-action control, so you change a permission afterwards on the agent’s own page. And it asks no question about how much the agent may do on its own, so the agent lands on Ask before acting, the most supervised setting.

The plan it comes back with

Four things you can read before anything is created.

The closing turn opens with one line, Here is what I would build. Nothing is created yet., and then four cards. Each one has a change link that puts a request back in the box: the conversation is the editor, so nothing opens a second one.

FieldDescription
What it will doThe brief the agent will follow, in plain English, and the record type it works on.
What this agent can doOne row per action that changes something, each with its own control. Reads are not listed here: what the agent can look at is one sentence under the rows.
When it runsThe schedule or the event, read back as a sentence, with any run conditions named in the same sentence.
What it would act onTwo or three real records from your workspace, each with the reason it would or would not be acted on.

The close is three rows and one press: Create it, ask me before acting, Create it, act on routine work, or Save as a draft for now. Under them, once: Nothing runs until you publish it. Pressing one creates the agent as a draft at the level you picked and opens it; the receipt reads Created as a draft. Nothing runs until you publish it.

When the agent runs

On a schedule, or when something happens. One question, one answer.

An agent either runs on a schedule or runs when something happens. The frequency control offers six answers, and the last one is the other kind of trigger.

  • Every hour
  • Every day
  • Every weekday
  • Every week, on the days you pick
  • Every month, on the day you pick
  • Only when something happens

Whatever you choose reads back as one sentence, in your own time zone and never as a schedule expression: Every weekday at 9:00 AM, Mondays, Wednesdays and Fridays at 9:00 AM, On the 1st of each month at 9:00 AM, or Only when something happens. Under it sits the preview, Next run: tomorrow at 9:00 AM. A paused agent reads Paused. It will not run until you turn it back on. instead.

Answer Only when something happens and you pick the event instead: a record being created or updated, a field changing, a campaign finishing sending, or a goal firing. An event agent runs once per matching event, not once a day, so ten qualifying records in an afternoon is ten runs.

Tickets carry their own group of events
On a ticket, the event picker adds a Service group with six rows: an SLA breached, an SLA at risk, a ticket reopened, a satisfaction rating submitted, a low satisfaction rating, and a survey submitted. The group appears on tickets and on nothing else.

What an agent can be built on

Eleven record types, and the reason the rest are not on the list.

An agent, like a rule, can be built on Companies, People, Deals, Projects, Tasks, Activities, Tickets, Quotes, Products, Campaigns and Goals. Inbound email and sequence leads are driven by the email sync and the sequence builder themselves, so you do not build an agent on them. Invoices and knowledge base articles can be acted on by an agent, but an agent is not built on one yet.

One record type carries a narrower rule: a campaign agent runs only when a campaign finishes sending.

Run conditions

Optional filters that decide which records are worth a run.

A run condition narrows which records qualify. Fields are grouped so the list stays readable: Basics, Owner, Dates and Amounts, with identity fields and the ones that have no list to pick from behind Advanced.

What a row can say depends on the kind of field. A record is picked from a list, never typed as an identifier. A choice field shows its label rather than the value underneath it. A yes-or-no field reads Yes or No. A date row can say is before, is after, is within the next 7 days, is more than 30 days ago or is empty; the two relative rows take a whole number of days.

A scheduled agent has no record to test
This agent runs on a schedule across your whole workspace, so there is no single record to check before it starts. Conditions saved earlier on an agent that later moved to a schedule are kept and shown, and they are not applied.

What the agent is allowed to do

The exact set of things it is permitted to do, split in two.

The action list splits once, at the only line that matters to a reader: what the agent can look at, and what it can do. Find data holds everything it may read, which never changes anything. Take action holds everything it may draft or write. Families sit inside each group, so an action that changes what it does moves group by itself.

Each row says in a word what its action does: Read, Draft or Write. A row that always stops for a person is marked Needs approval, and a row the preset you started from already uses is marked In preset. The agent cannot read, draft or write outside this list or the records in its scope. A new Assistant capability is unavailable here until it has been reviewed for autonomous use.

Granting actions is admin-managed
Because granting an action is an organization-wide governance decision, only admins edit grants. Other teammates see the list read-only. Creating a record, importing a template, forking a preset, using an alias, or racing another edit cannot self-grant a write capability. Current role, plan, grant revision, record scope, and approver authority are checked again before each effect.

How much it may do on its own

Three levels, and a floor none of them moves.

One control, three positions, and every agent starts on the first. The picker shows all three at once with both lines under each, because the question is which of these three you want rather than how far to push a dial.

FieldDescriptionDefault
Ask before actingLooking things up and drafting. Nothing is saved, sent or changed. Your first weeks with an agent, and anything a customer will see.Asks first
Act on routine workEveryday updates you can undo, like logging a next step or tidying a record. Work you would approve every time anyway.Routine work
Act automaticallyEverything you have allowed. You read what it did in the run history. Summaries and internal briefs you read after the fact.Automatic

Always asks, whatever you choose: deleting records · sending anything to a customer · taking or refunding a payment · anything that cannot be undone.

That line is printed under the control at every level, and it is not a setting. There is no score to tune and no threshold to clear: what decides whether an action runs on its own is the risk the action carries and the permission you gave that action, and nothing else.

Per-action permission

The second axis, on the things that change something.

The permission card counts its own rows and then hands each of them to you: one row per action that changes something, each with its own three-position control, and a place to add a note saying what the agent should do there.

FieldDescription
AllowRuns without asking.
Ask firstWaits for your approval each time.
NeverThis agent cannot do it.

Reads are never permissioned. Looking something up always just works, which is what keeps this list short enough to read and every row on it consequential. When two answers disagree, the order is fixed: Never wins, then the always-asks floor, then Ask first, then Allow, and only then the level you set above. First match wins.

A row you have no authority to grant reads Your admin needs to allow this. and carries no control. A row on the always-asks floor reads This one always asks., because the server refuses to run it unattended whatever the control said. An agent that changes nothing reads This agent does not need any new permissions.

Your AI allowance

One sentence, in two places, and nothing to set up.

Everything your agents use counts against your plan’s AI allowance, the same allowance the rest of Laureo’s AI shares. There is nothing to configure and no limit to set: the allowance comes from your plan, and it grows when your plan does.

You are told where you stand in one sentence, and it appears in exactly two places: once under the header of the Agents home, and once at the foot of a test run. It reads Used about 2% of this month’s AI allowance, resets Sep 14. The word “about” is always there, because the figure is an estimate and saying so is better than defending a number. Below ten percent it carries one decimal; at ten and above it is a whole number. The date is when your billing cycle resets, and a plan with no reset date drops that clause.

When it is all used, the sentence reads This month’s AI allowance is used up, resets Sep 14. and your agents pause themselves. They resume on their own when the cycle resets, and Extra AI Credits start them again before then. If the figure cannot be read at all, the sentence says so rather than showing a confident zero: AI allowance is temporarily unavailable.

No bar, no gauge, no per-run figure
The allowance is a sentence and never a chart. Individual runs carry no figure of their own, and no amount of money is shown anywhere on an agent surface.

Untrusted context stays untrusted

Record, file, email, and tool text cannot widen an agent's authority.

Content read from records, files, emails, triggers, and earlier tool results is treated as untrusted data. That safety state remains attached through later hops, retries, worker recovery, compaction, and approval continuation. If Laureo cannot determine whether the run is tainted, it treats the run as tainted.

Instructions inside business data cannot add capabilities, change recipients, raise how much the agent may do on its own, widen its record scope, or turn preview work into a live effect.

Try it: a test run that changes nothing

See exactly what the agent would do on a real record, with no side effects.

Try it sits in the page header of the agent rather than inside a tab, so it is there on all three of Build, Runs and Settings, on a draft and on an agent that is already live. Directly under the control, in the same words every time: Runs on your real data. Won't send, change or charge anything. Beside it, the version it will use: Runs the saved draft. on an agent with unpublished changes, and Runs the published version. otherwise.

1

Pick a record

Search for and choose a real record in your CRM to test against.
2

Run the test

The agent genuinely reads that record and works out what to do. Every action is built and then returned instead of being carried out, so nothing is written and nothing is sent.
3

Read what it would have done

The result opens with what did not happen, then what it would do, then what it would skip and why. Each proposed action carries its own disposition, and none of them reaches the approvals queue.
FieldDescription
Would run automaticallyThe level and the permission you set would let this one run without asking.
Would wait for your approvalIt would land in the approvals queue for a person to decide.
Blocked by this agent's permissionsThis agent is not permitted to do it at all, so it would not happen either way.
A test run appears in the run history marked Test, so you can open its trace and read the same detail a real run would show. A test run uses your AI allowance like any other run, and the allowance sentence sits at the foot of the result.

Publish, edit, and version

Nothing runs until you publish, and every publish is a restore point.

A new agent is a draft. Choose Publish & activate to make it live. Every publish captures the previous configuration as a version you can restore, so you can always roll back to how an agent was set up before a change.

Opening a live agent’s Build tab shows you the published version, read only: This is the published version. Editing starts a draft; the live agent keeps running. Choose Edit as draft to start changing it. While you have unpublished changes the tab says so: Unpublished changes. The live agent keeps running the published version. Publishing while a run is actually in flight asks you once which you want: Pause and save or Save and keep running. On every other publish there is no confirm at all. Records already mid-run finish on the version they started, and new runs use the new one.

The agent's own settings

Its name, its notifications, and archiving it.

The Settings tab on an agent holds its identity, its notifications and its archive control. Under Notifications there is one switch, Tell me when this agent keeps failing, on for every agent that has never been touched. Off leaves this agent out of the repeated failure notifications. Every run is still in its history. With it off, the tab reads Repeated failure notifications are off for this agent. It changes nothing about any other agent.

The anatomy rail

A rail down the side of the builder that shows the whole agent at a glance.

The build screen keeps a persistent anatomy rail laying the agent out as six stages, in the same order as the sections of the build screen. Each stage summarises how it is configured and jumps to that section when you click it, so you can see what is set and what is still missing.

FieldDescription
TriggerWhat starts the agent: its schedule, or the event it waits for.
Run conditionsWhich records qualify, or the note that a scheduled agent has none.
InstructionsThe plain-English brief the agent follows.
ActionsWhat it is allowed to find, and what it is allowed to do.
How much it may do on its ownThe level it is set to, and the actions held for a person.
OutputWhat it produces: drafts for review, or actions proposed for approval.