This guide walks you through creating and running simulations to help your agents learn your application’s interface.

​
Before You Start

You’ll need:
  • An application registered in Marketrix (URL accessible, credentials valid)
  • An agent that will run the simulation
  • Clear instructions about what you want the agent to explore

​
Step 1: Navigate to Simulations

  1. Log into your account at the Marketrix dashboard
  2. Click “Simulations” in the left sidebar

​
Step 2: Select Your Application

Choose the application you want the agent to explore. Verify the URL and credentials are current.

​
Step 3: Select Your Agent

Choose the agent that will run the simulation. The agent should have relevant knowledge about your product.

​
Step 4: Write Simulation Instructions

​
Template Variables

You can use these variables in your instructions — they are automatically replaced with application details:
  • {{url}} — Your application’s URL
  • {{username}} — Username for authentication
  • {{password}} — Password for authentication

​
Example Instructions

General exploration: 
Navigate through the application at {{url}} and learn how users:
- Set up their workspace
- Create and manage projects
- Invite team members
- Configure settings and preferences
E-commerce platform: 
Explore the online store at {{url}} using the credentials {{username}}/{{password}}.
Learn the complete shopping experience including:
- Product browsing and search
- Shopping cart management
- Checkout and payment process
- Account management and order tracking
User onboarding: 
Walk through the complete user onboarding process from {{url}}.
Learn how new users:
- Create accounts
- Complete profile setup
- Navigate to the main dashboard
- Access key features for the first time

​
Writing Tips

  • Be specific about what areas to explore
  • Focus on user goals rather than just pages to visit
  • Include context like user roles (“As a new user…”, “As an admin…”)
  • Start broad, then get specific — cover overall structure first, then focus on specific workflows

​
Step 5: Start the Simulation

  1. Click “Start New Simulation”
  2. Review your settings (application, agent, instructions)
  3. Click “Generate Simulation”

​
Step 6: Monitor Progress

Your agent will provide real-time status updates as it explores. The agent may ask questions during the simulation — respond promptly to keep exploration moving. See Monitoring Simulations for details.

​
Troubleshooting

IssueSolution
Simulation won’t startCheck application URL is accessible, verify credentials
Agent gets stuckProvide more specific instructions, answer questions promptly
Incomplete explorationRun additional simulations for missed areas, break down complex tasks

​
Next Steps

  1. Monitor the simulation — Watch your agent learn in real-time
  2. Review simulation results — See what your agent discovered
  3. Test in the playground — Verify improved agent performance