DocsRun and improve

Safety and usage

Bound what an agent can spend, how long it can work, what it can reach, and where a person should review its work.

Guardrails are the limits you put on an agent so that when something goes sideways it stops for a reason you can read, rather than running all night.

You'd give a new hire a company card with a limit on it. Same idea. Not because you expect trouble, but because a stuck agent at 2am should cost you nothing and leave a clear note about what happened.

The two-minute version

If you read nothing else on this page, do these three things before an agent works without a person watching:

  1. Give it only the actions it needs. This is the strongest control on this page, and the one most often skipped.
  2. Use connected accounts with the right controller and audience. Mobius rechecks that boundary before each provider action.
  3. Set the routine's spending ceilings deliberately when you approve one, rather than accepting whatever was proposed.

The rest of this page is what each of those does, and where you see it working.

What each guardrail is for

The worryWhat handles itWhere you see it working
This could get expensiveThe routine's per-occurrence and rolling 24-hour ceilingsThe occurrence ends, and its outcome says why
We could run out of creditsThe organization's included allowance and per-person limitsSettings > Usage
This turn could run foreverThe agent's turn timeoutThe turn's terminal status and error
It could change another systemWhich actions and connected accounts the agent can use, plus any review required by its instructionsThe interaction, tool call, and destination record
Nobody answered a review requestThe interaction's own deadlineThe interaction resolves as Expired and the conversation that asked receives that outcome
The agent is going round in circlesThe duplicate-tool-call breakerThe turn stops and says so

When work stops at a configured ceiling, inspect the terminal reason and the last completed model or tool call. Tighten the task if it did unnecessary work; raise the ceiling only when the expected path needs more room.

Bound what the agent can reach

An agent can only call the actions you granted it. That grant is the guardrail that operates before anything else, because a capability an agent does not have is a capability it cannot misuse under any prompt.

Give an agent the narrowest set that lets it do its job, with the narrowest provider permissions behind each one. An action's Read-only, Idempotent, and Destructive annotations describe expected behavior; they do not turn a mutating endpoint into a safe one.

When you find yourself reasoning about whether the agent will use a dangerous action carefully, that is the signal to withhold it instead. See tools and skills.

Review an external change when the workflow needs it

Mobius does not automatically pause before a built-in, MCP, custom HTTP, or worker action changes another system. Tool access and connected-account grants are hard dispatch controls: the assistant must hold the action, the selected account must remain eligible, and Mobius rechecks the exact connection before a provider call. Those checks decide whether the assistant may use a capability; they do not ask a person to approve one destination or payload.

For work that needs human judgment, tell the assistant to open an interaction and wait for the answer before it acts. The request should show the proposed content and destination, name an eligible responder, and state what the assistant must do for approval, rejection, cancellation, and expiry. This ordering comes from the assistant's instructions. Mobius does not bind the response to a later action's arguments or add another confirmation at dispatch.

A review is not a rollback and does not prove delivery. Inspect the interaction, the following tool result, and the destination system as separate records. See interactions.

Ceilings on a routine

A routine carries two ceilings:

CeilingWhat it stops
Credits per runOne occurrence, once its recorded spend reaches the limit
Credits per 24 hoursFurther occurrences, once the rolling spend across the routine reaches the limit

The New routine form shows both under Advanced and projects scheduled runs over the next 30 days when it can understand the schedule. A proposal card in a conversation shows the same ceilings and 30-day maximum before approval. Event routines cannot project how many events will arrive, so choose their limits from a measured manual run and the event volume you expect.

Ceilings are enforced between operations, not in the middle of one. Mobius won't kill a model call halfway through and leave you with a half-finished mess. In practice that means an occurrence can finish slightly above its ceiling, by whichever call was already in flight, so don't set one so tight that a single extra call matters.

A clock on every turn

Every agent turn has an active-work limit: 10 minutes by default, raisable to 30. Set it on the agent under Advanced > Turn timeout.

The clock runs during model work and ordinary tool calls. It pauses after the runtime records a durable suspension, such as an event wait. A turn that waits overnight for the answer to a question uses none of its active work budget while suspended. See agent time limits for the full behavior.

Organization-wide limits

Ceilings bound one routine. The organization's credits bound everything.

Open Settings > Usage. In a direct-billed organization, the organization owner can set a default current-period credit limit for each person, apply member overrides, and see per-person usage. Other billing readers, including organization Admins, see the figures without mutation controls. In a managed organization, the service provider sets the pool and controls the shared-pool exhaustion policy.

Set a per-person default before you widen access to agents, not after. See billing and usage.

The repeat-call breaker

An agent that keeps making the exact same tool call with the exact same arguments is stuck, not working. Mobius stops that turn automatically after ten identical calls, and the transcript says why.

This one you do not configure. It exists so a loop of identical calls costs you ten calls rather than a night's worth.

What to keep an eye on

  • Routines that hit their ceilings. Once is informative; every day means the ceiling is wrong or the routine is.
  • Interactions sitting open far longer than the decision should take. Usually a person who never saw the request.
  • Failed turns, grouped by agent. A single agent producing most of them usually has an instruction or a tool problem, not a platform problem.
  • Your artifact storage, before you let an agent generate big files unsupervised.

Before you leave an agent unattended

  1. Grant it only the actions it needs, with the narrowest provider permissions.
  2. Bind the exact accounts and verify that each grant reaches the assistant and intended result audience.
  3. When the workflow needs review, test approval, rejection, cancellation, and expiry, then verify that only the approved path reaches the external action.
  4. Set the turn timeout to what the work actually needs, and no more.
  5. Set the routine's two ceilings from a manual run, expected volume, and the 30-day projection when one is available.
  6. Set a per-person credit limit for the organization.
  7. Read the first few real occurrences in the transcript before widening scope.

FAQ

Why can an occurrence spend slightly more than its ceiling?

Mobius enforces ceilings at checkpoints: before the next model call, after a metered action records usage, and between tool iterations. The call already in flight is allowed to finish, so final spend can include one extra call.

Should the agent check something, or ask a person?

Have it check when the answer is in evidence it can fetch: an exit code, a returned record, a file that exists. Have it ask a person when the decision needs judgment or authority.

Prefer evidence the agent did not produce. "The test action exited 0" is a real check. "Ask the agent that did the work whether it went well" is not; it is a poor judge of its own work, and it is not lying when it says yes.

What's a sensible starting ceiling?

For a routine with one agent turn and a couple of actions, a few credits per occurrence is generous. Approve that, let it fire a few times, then look at what it actually cost and tighten toward reality.

Too tight is a nuisance; too loose defeats the point. Erring loose for the first week and then tightening is the usual approach.

Next