Test a flow
mimiq.test_flowUse this after you build or change anything a user goes through (signup, onboarding, checkout, settings, a new feature), on the preview or staging URL, and again after each fix. AI agents, each acting as one of the app's users, open it in their own real browser and try the task by clicking, typing and filling in forms (they get a working inbox for verification codes). They report what was broken, what did nothing, where they got stuck or gave up and why, with the step and a screenshot, and the problems ranked by how many agents hit them. Pass the URL and, as goal, the task a user would try in plain words. For a protected preview or pages behind a sign-in, pass access (a Vercel bypass secret, a username and password, or a test account). Each agent keeps going until it finishes the task or gets stuck, so a run takes a few minutes, longer for a long task; each agent uses 5 credits. This call answers within a minute with status still_running, a session_id and a report link while the run goes on: call mimiq.show_report with the session_id until it is finished (if it returns a review, handle that audience warning as below). The same call made again joins that run and uses no more credits. It starts right away and the result includes the audience summary, examples and fit. If the recruited crowd is not the requested audience (more than 1 in 5 wrong) or the page could not be read to check its market, the result is an audience_review instead: show the warning, then continue with review_id, confirm_audience and audience_fit_acknowledged, or recruit again with audience_correction.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"url": "<url>"
},
"name": "mimiq.test_flow"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Where the flow starts. Must be publicly reachable. For localhost, open a cloudflared tunnel and pass the tunnel URL. | |
| goal | No | The task each person tries, e.g. "complete the signup and reach the dashboard". Default: sign up and start using it. | |
| count | No | How many simulated people (default 5, max 10; without a key a free flow has up to 3, and defaults to 3). Each runs a full browser session and uses 5 credits. | |
| access | No | Only for a site that is not open to everyone. vercel_bypass: a Vercel "Protection Bypass for Automation" secret for a protected preview. basic_auth: a username and password the site asks for in a browser prompt. headers: up to 4 headers sent only to this site. login: a test account (email or username, password, optional note) that the people sign in with to reach pages behind a sign-in. Used for this run only and never shown in results or reports. Ask the user before passing a password, and use a test account, not a real one. | |
| devices | No | Which devices the agents use. "mix" (the default): about 4 in 10 on a phone-sized touch screen, the rest on a laptop. "phone" or "laptop" puts every agent on one. | |
| new_run | No | Start a new run even if this same test is still running or has a result nobody has read. Use it after you change the build. Uses credits. | |
| audience | No | Who the simulated people should be, in plain words, e.g. "startup founders in SF" or "parents shopping for kids toys". If omitted, Mimiq picks the likely audience from the content. | |
| max_steps | No | Usually leave this out: each agent keeps going until it finishes the task or gets stuck, within the server's limit. Set it (10 to 200) only to cap a run on purpose. | |
| review_id | No | The review_id from a low-fit review or completed/running result. Bound to this URL and test kind. | |
| confirm_audience | No | Start with the reviewed people after showing them to the user. | |
| audience_correction | No | Not quite? Change who and rerun: use with review_id. Recruits a new crowd under the existing credit rules; starts unless the new crowd is wrong, otherwise returns a new review. | |
| audience_fit_acknowledged | No | Set only after telling the user about an audience-fit warning and they choose to continue. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| run | No | ||
| call | No | ||
| tool | Yes | ||
| status | No | ||
| report_url | No | ||
| summary_card | No |