# Interactive Demo

Describe what you want to test in plain English, point ContextQA at your application URL, and the AI generates structured, ready-to-run test cases automatically. This demo walks through the full workflow from input to execution.

{% tabs %}
{% tab title="From URL" %}
{% stepper %}
{% step %}

#### Describe Your Test

Provide the application URL and a plain-English description of what you want to test. Optionally give the test case a name.

**Example input:**

* **URL:** `https://demo.contextqa.com/login`
* **Description:** Verify that a user can log in with valid credentials and see the dashboard. Then navigate to the Reports section and verify at least one report is visible.
* **Test Case Name:** Login and access Reports

{% hint style="info" %}
**AI Agent:** Accepts free-form test descriptions — no structured syntax or scripting required. Also supports Jira ticket, Swagger spec, or Figma design as the source.
{% endhint %}
{% endstep %}

{% step %}

#### AI Generates Steps

ContextQA navigates to the target URL, analyzes the page structure, parses your description, and generates individual test steps automatically.

**Generation log (live):**

```
→ Navigating to https://demo.contextqa.com/login
→ Analyzing page structure and UI elements…
✓ Found: Email field, Password field, Sign In button
→ Parsing test description…
→ Generating step 1/5: Navigate to login URL
→ Generating step 2/5: Enter email credentials
→ Generating step 3/5: Enter password
→ Generating step 4/5: Click Sign In button
→ Generating step 5/5: Verify dashboard text
✓ Test case #18750 created (5 steps)
→ Discovering Reports navigation flow…
✓ Test case #18751 created (3 steps)
✓ Generation complete — 2 test cases, 8 steps total
```

{% hint style="info" %}
**AI Agent:** Automatically discovers UI elements on the page and maps them to the natural language steps in your description.
{% endhint %}
{% endstep %}

{% step %}

#### Review & Run

Two test cases are generated and ready to review, edit, or execute immediately.

**TC #18750 — Login with valid credentials** (5 steps)

1. Navigate to `https://demo.contextqa.com/login`
2. Enter email in the Email field
3. Enter password in the Password field
4. Click the "Sign In" button
5. Verify the text "Welcome back" appears on the page

**TC #18751 — Navigate to Reports and verify content** (3 steps)

1. Click "Reports" in the navigation menu
2. Verify the Reports page title is visible
3. Verify at least one report item is displayed in the list

{% hint style="info" %}
**AI Agent:** Generated test cases are fully editable. Steps can be modified, reordered, or deleted before running.
{% endhint %}
{% endstep %}

{% step %}

#### Run Both Tests ✓

Click **Run Both Tests** to execute. ContextQA launches a real browser, executes each step, and captures screenshots at every stage.

{% hint style="success" %}
**AI Agent:** Executing in Chrome on cloud infrastructure — screenshots captured after every step, full session video recorded, results available immediately after completion.

**Available after run:**

* Per-step screenshots
* Session video recording
* AI root cause analysis (on failure)
* Export as Playwright option
  {% endhint %}

| Artifact             | Detail           |
| -------------------- | ---------------- |
| Test Cases Generated | 2                |
| Total Steps          | 8                |
| Generation Time      | Under 30 seconds |
| Code Required        | None             |
| {% endstep %}        |                  |
| {% endstepper %}     |                  |
| {% endtab %}         |                  |

{% tab title="From Jira Ticket" %}
{% stepper %}
{% step %}

#### Connect Jira Integration

Select **From Jira Ticket** as the source and provide the Jira issue key. ContextQA reads the ticket title, description, and acceptance criteria automatically.

{% hint style="info" %}
**AI Agent:** Reads the Jira ticket content and extracts testable requirements from the acceptance criteria and description fields.
{% endhint %}
{% endstep %}

{% step %}

#### Review Generated Tests

ContextQA maps each acceptance criterion to one or more test cases, complete with steps derived from the feature description.

{% hint style="info" %}
**AI Agent:** Each acceptance criterion in the Jira ticket typically maps to one test case. Edge cases and negative paths are also generated where relevant.
{% endhint %}
{% endstep %}

{% step %}

#### Link Tests Back to Jira ✓

Generated test cases are linked to the originating Jira ticket. Execution results automatically update the ticket status.

{% hint style="success" %}
**AI Agent:** Two-way Jira sync — test results flow back to the ticket, and test cases reference the originating issue for full traceability.
{% endhint %}
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="From Swagger" %}
{% stepper %}
{% step %}

#### Provide Swagger / OpenAPI URL

Select **From Swagger** and paste the URL to your OpenAPI specification. ContextQA parses all endpoints, request schemas, and response codes.

{% hint style="info" %}
**AI Agent:** Reads the full OpenAPI spec — endpoints, parameters, request bodies, and expected response codes are all used to generate test cases.
{% endhint %}
{% endstep %}

{% step %}

#### Generate API Test Cases

A test case is generated for each endpoint, covering the happy path, required field validation, and common error responses (400, 401, 404, 500).

{% hint style="info" %}
**AI Agent:** Automatically generates positive and negative test cases for each endpoint. Authentication flows are detected and included as prerequisites.
{% endhint %}
{% endstep %}

{% step %}

#### Execute API Tests ✓

Run the generated API tests against your staging or production environment. Response validation, schema checks, and status code assertions are all included.

{% hint style="success" %}
**AI Agent:** API tests run without a browser — faster execution with full request/response logging captured as evidence.
{% endhint %}
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}

***

{% hint style="success" %}
**Try it yourself** — [🚀 Start Free Trial →](https://app.contextqa.com/signup) · [Book a Demo](https://contextqa.com/book-a-demo/)
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learning.contextqa.com/ai-features/demo.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.