> ## Documentation Index
> Fetch the complete documentation index at: https://docs.empirical.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Requests

> Ask our agents to write new tests

A request is how you ask our agents to write a new test. Describe what needs to be tested — our agents take it from there.

## Creating a request

<Steps>
  <Step title="Navigate to Requests">
    Go to the **Requests** page
  </Step>

  <Step title="Create a new request">
    Click **"Create New Request"**
  </Step>

  <Step title="Fill in the details">
    Fill in the details and submit
  </Step>

  <Step title="Track progress">
    Track progress from the dashboard
  </Step>
</Steps>

A clear request leads to a better test. Cover these four things:

* **What to test** — the feature or user flow
* **Steps** — the actions the user takes, in order
* **Expected outcome** — what a passing test looks like
* **Edge cases** — any variations or special conditions to account for

You can attach **videos**, **screenshots**, or plain **text.**

### Example Prompt

```
Test the checkout flow for a returning customer:
1. User logs in with existing credentials
2. Adds product to cart from the search results
3. Navigates to checkout
4. Selects saved payment method
5. Completes purchase
6. Verify order confirmation appears with correct order details
```