Mechasmmechasm logoMechasmbeta
Back to Docs

Creating a New Test

Learn how to create a new test in Mechasm, from defining the test steps to running it for the first time.

Creating a new test in Mechasm is a straightforward process that begins on the main Tests page.

1. Navigate to the Create Test Form

From the main Tests dashboard, click the “Create Test” button. This will take you to the test creation form, where you can define your new test case.

2. Define Your Test

The test creation form has two main fields:

  • Name: A descriptive name for your test (e.g., “User Login Flow”).

  • Prompt: The detailed, step-by-step instructions for the test. This is where you will write the user actions to be performed.

  • Managing Tags: You can assign tags to your tests to organize and filter them. The tag input component provides two ways to add tags:

    • Select Existing Tags: Click the “Select existing” button to open a dropdown of all tags currently used in the project. You can search and select multiple tags.
    • Create New Tags: Simply type a new tag name into the input field and press Enter to add it.
mechasm.ai/dashboard/tests/create
Create Test Form

Using Environment Variables

If your project has environment variables, type $ in the prompt to search and insert one with the keyboard. You can also use Insert Variable. Variables appear as compact tokens; missing variables are marked so they can be corrected before running the test.

mechasm.ai/dashboard/tests/...
Insert Environment Variable

3. Create and Run the Test

Once you have filled out the form, click the “Create Test” button at the bottom. The system will first validate your test steps. If they are valid, a new test will be created, and you will be automatically redirected to the Test Run Details page, where you can watch your new test execute in real-time.