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

# Creating a test

> How to go from a URL to a finished usability report

Tests in the web app are created through a guided conversation. Paste a URL, answer a few questions, pick a persona, and run.

## The short version

1. Go to **Tests**.
2. Paste the URL you want to test.
3. Percio scrapes page context so it understands what it's looking at.
4. Answer 2–5 quick questions about what you want to test.
5. Review the generated scenario.
6. Pick a persona.
7. Hit **Run Test**.

## What you'll need

* **A reachable URL.** Production, staging, or a public preview link all work in the web app. To test `localhost` or URLs behind your dev machine, use the [agent CLI](/agent/overview) instead.
* **A clear goal.** Even a rough sentence is enough to start. Percio's conversation will help sharpen it.
* **A persona.** Your onboarding persona works for a first run. To cover different segments, create additional personas and run separate tests against them.
* **Credits.** Each test run consumes credits. If you're low, Percio shows an **Insufficient credits** dialog before the run starts.

## In depth

<Columns cols={2}>
  <Card title="The conversation flow" icon="comments" href="/tests/conversation-flow">
    Exactly how the Q\&A works and what each step does.
  </Card>

  <Card title="Writing good scenarios" icon="pen-fancy" href="/tests/writing-scenarios">
    The highest-leverage skill for getting useful reports.
  </Card>

  <Card title="Picking a persona" icon="users" href="/tests/picking-personas">
    How to choose the right persona for a test.
  </Card>

  <Card title="Credits" icon="coins" href="/tests/credits">
    What a test costs and how to avoid running out.
  </Card>

  <Card title="Live execution view" icon="play" href="/tests/live-execution">
    The progress ring, step timeline, and reasoning panel.
  </Card>
</Columns>
