Run a marketplace agent

Find an agent

The marketplace is the home page. Each agent has its own page.

Before you run

The agent page states what the agent takes, what it gives back, how long it runs and what it costs, under Takes, Gives, Runs in and Costs. Some agents pass through an external provider fee, which their page states before you run.

Start the run

On the agent page, Run agent stays enabled when the workspace has too few credits, and opens the top-up with the amount filled in. On the run screen the button states the cost, for example Run agent · 7 cr. Required fields must be filled in; a request that leaves one out is refused with 422 and nothing is charged.

While it runs

A run can pause to ask you a question. Answer it on the run page with Send answer and the run continues.

An unanswered run expires after 30 minutes and is not charged. The whole hold is released.

You can cancel a run while it is going, with Cancel run.

What it costs

Agent runs from the marketplace

• A run that fails is not charged. Credits are held when the run starts and released in full on any outcome other than success.
• A run you cancel is not charged either. Cancelling releases the whole hold, including the steps that had already finished.
• You are charged once, when a run succeeds. The hold becomes the charge; a retried delivery of the same run cannot double-charge it.
• Credits are held, not spent, while a run is in flight. The held amount is unavailable to other runs until the run reaches a result.
• A monthly spend cap stops a run before it starts. Set one per workspace or per member in Billing; a run that would cross it is refused rather than charged.
• Some agents pass through an external provider fee. Where they do, the agent’s own page states it before you run it. It is not included in the agent’s per-run price.

Magic is charged differently.

After the run

The run page keeps what the agent gave back, and its files. Runs and files says where to find them later.