Skip to main content

How to try agents with draft runs

Written by Sam B.

Start A Draft Run

  1. Select the agent you want to test in the builder.

  2. Click Try it in the agent toolbar.

  3. Under Validate agent actions, set Approve actions.

    1. Choose Auto if you want the run to continue without approval stops.

    2. Choose Manual if you want the run to pause before actions so you can approve or retry them.

  4. Set Consistency checks to Off, 3, or 30.

    1. Off or 3 are recommended for initial tests

    2. 30 is recommended when your agent has been previously tested and now you're looking to gain confidence.

  5. If Choose run settings appears, use Inherit settings from to choose which top-level agent settings the draft run should use.

  6. Under Provide input values, enter the required inputs. If this section does not appear, the agent does not need input values for this draft run.

    1. Use List for the guided input form, or JSON when the inputs are easier to paste as JSON.

  7. Leave Save values for later on if you want Magical to remember these input values the next time you open Try it.

  8. Click Try it.

After you click Try it, Magical saves pending edits first. If a save-blocker modal appears, resolve the issues, save, and start Try it again.

Watch And Control The Run

  1. When the run starts, the Preview overlay opens over the builder.

  2. Use the live preview to watch what the automation is doing.

  3. Use the activity feed below the preview to read the run steps.

  4. Click the Manual or Auto control in the preview top bar to change approval mode during the run.

  5. Click the consistency check control to cycle between Off, 3, and 30 during the run.

  6. If the run pauses for approval, click Approve when the proposed action is correct.

    1. Edit the agent instructions or settings, then click Retry if the proposed action is wrong.

  7. Click Collapse preview window if you want to return to the builder without stopping the run.

  8. Click Terminate run or Stop when you want to end the draft run.

Review A Previous Draft Run

  1. Select the relevant agent in the builder.

  2. Click the Draft runs icon next to Try it.

  3. Use the Draft Runs table to review runs for that agent and its ancestor agents.

  4. Use the Agent, Started At, Duration, and Status columns to choose a run.

  5. Click a run row to reopen that draft run in the preview overlay.

Watchouts

  • If the selected agent or a connected downstream agent has empty instructions, the submit button is disabled.

  • If an API agent is missing URL, method, or a required connection, the submit button is disabled.

  • Draft runs use the current saved draft instructions. They are for testing before you publish.

  • Draft runs currently test the selected agent. If an agent queues another agent, Magical records the queue action but does not run the next agent as part of that draft run.

Did this answer your question?