---
title: "Generate from documents with AI"
section: "Analyze"
description: "The SmartestQA Analyze AI wizard: import specs and screenshots, review the outline, generate steps, check coverage, create requirements and tests."
url: https://docs.smartestqa.ai/en/analyze-import.html
audience: [customer, admin]
updated: 2026-11-08
keywords: "import analyze document ai analysis outline scenarios generate steps check coverage review create target scope coverage depth negative test intensity select entities pipeline draft screenshot pdf docx"
---
# Analyze: Generate requirements and tests from documents

Select a folder and Analyze becomes a three-step wizard. The AI reads your document, proposes requirements and scenarios, writes steps from your Discover actions, and creates it all when you approve.

## In short

**On this page you can**

- Attach DOCX, PDF, text files or screenshots, several at once.
- Limit the AI to one module or page with Target scope .
- Edit the proposed requirements and scenarios before any step is written.
- Generate steps, then check which steps match existing actions with Check Coverage .
- Create requirements, test cases and optionally a pipeline in one click.

**How to use it**

1. Select a module folder; on Import , add files and set Target scope .
2. Choose preferences and entities, then click Analyze with AI .
3. On Requirements & Scenarios , edit the outline and click Generate steps .
4. Click Continue to review , fix ✗ steps with Record Actions and Check Coverage .
5. On Review & Create , click Create .

The wizard appears when you select a folder in the tree (not Documents). Its tabs are **Import**, **Requirements & Scenarios** and **Review & Create**. Tabs 2 and 3 open once an outline exists; their badges count scenarios (see [Wizard counts](https://docs.smartestqa.ai/en/analyze-numbers.html#wizard-counts)).

## Before you start

- **AI is on.** **Analyze with AI** needs [**Enable AI**](https://docs.smartestqa.ai/en/project-settings-ai.html#enable-ai) and [**AI Document Analysis**](https://docs.smartestqa.ai/en/project-settings-ai.html#what-each-switch-unlocks) in [Project Panel › AI Options](https://docs.smartestqa.ai/en/project-settings-ai.html#capabilities); otherwise its tooltip says which one to enable. Only an [Admin](https://docs.smartestqa.ai/en/company-settings-roles.html#admin-screens) can open [Project Panel](https://docs.smartestqa.ai/en/project-settings.html).
- **The right folder is selected.** Requirements are created in the folder you selected, and test cases in that [module’s folder in Automate](https://docs.smartestqa.ai/en/automate-test-cases.html#modules). Select the module, or a sub folder inside it.
- **Discover knows the app.** The line **AI generation reads:** shows what the AI will get: [App Map pages](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) (and how many are verified) and active [Notes](https://docs.smartestqa.ai/en/discover-notes.html). With nothing there you see “No application metadata yet — no page map, no notes. Scenarios will be generated from the document alone.” **Metadata** takes you to [Discover](https://docs.smartestqa.ai/en/discover.html).

## 1. Import

![The Import tab.](https://docs.smartestqa.ai/media/shots/ANA-SHOT-04.png)

1. **Add files**

   Drop files on the box, click it (**Click to select a file**) or use **Add files**. Paste screenshots with `Ctrl`/`Cmd`+`V`: “*n* screenshot(s) pasted from clipboard”. The box shows “*n* file(s) attached”. A file with the same name, size and date is skipped.
2. **Set Target scope**

   Pick **Whole project**, one [module](https://docs.smartestqa.ai/en/analyze-folders.html#modules) or one page. With a module or page, “The actions, App Map metadata and screenshots of *n* page(s) are sent.” Without one, “No scope: matching actions are chosen by similarity to the document.”
3. **Set preferences**

   Under **AI Analysis Preferences**, see the [table below](https://docs.smartestqa.ai/en/analyze-import.html#preferences).
4. **Choose what to generate**

   Under **Select Entities to Generate**, tick what you want. Requirement is always on; the others depend on each other (see [Entities](https://docs.smartestqa.ai/en/analyze-import.html#entities)).
5. **Add instructions (optional)**

   In **Additional Instructions for AI**, for example “Focus on login and payment flows; ignore the admin chapter.”
6. **Click Analyze with AI**

   The status moves from “Reading document...” to “Building the requirement outline...”. The browser waits up to 3 minutes.

   “Outline ready: *n* requirement(s), *m* scenario(s) — review and edit before generating steps”, and tab 2 opens.

**Accepted files:** .docx, .doc, .pdf, .txt, .md, .markdown, .html, .htm, .json, .csv, .tsv, .yaml, .yml, .xml, .xlsx, .xls, and images .png, .jpg, .jpeg, .gif, .webp, .bmp, .svg. PDFs must contain text; a scanned PDF has none (add it as screenshots instead).

**Save without AI:** [**Create as Document**](https://docs.smartestqa.ai/en/analyze-folders.html#add-document) stores the first attached file in the [Documents folder](https://docs.smartestqa.ai/en/analyze-folders.html#documents) and runs no analysis.

### AI Analysis Preferences

| Preference | Options | Effect |
| --- | --- | --- |
| **Coverage Depth** | Minimal · Standard · Comprehensive | Minimal asks for the critical paths only, Comprehensive for full coverage. Default Standard. |
| **Negative Test Intensity** | Low · Medium · High | How many error, invalid-input and edge-case scenarios to add. Default Medium. |
| **Default Priority** | Low · Medium · High | Passed to the AI as the default priority. Default Medium. |
| **Requirement Type** | Functional · Non-Functional · Both | Which kind of requirements to derive. |

### Select Entities to Generate

| Entity | Rule |
| --- | --- |
| Requirement | Always on. |
| Sub-Requirement | Turning it off also turns off Test Case, Test Step and Pipeline. |
| Test Case | Needs Sub-Requirement. Turning it off also turns off Test Step and Pipeline. |
| Test Step | Turning it on also turns on Test Case and Sub-Requirement. |
| Pipeline | Needs Test Case. Off by default. See [what gets created](https://docs.smartestqa.ai/en/analyze-import.html#what-gets-created). |

### What the AI receives

- The text of every attached document, and the images, for models that can read images.
- Your [actions](https://docs.smartestqa.ai/en/discover-actions.html) as a page graph: those of the scope pages, or ones chosen by similarity to the document.
- Your [template test cases](https://docs.smartestqa.ai/en/automate-steps-flow.html#template), so steps can reuse them.
- Up to 10 existing requirements similar to the document, so it does not create duplicates.
- Your active [Notes](https://docs.smartestqa.ai/en/discover-notes.html#notes-to-ai) and the [App Map descriptions](https://docs.smartestqa.ai/en/discover-app-map.html#page-information) of the scope, plus up to 6 page screenshots when a scope is set.

> **Warning: Your document goes to the AI provider**
>
> Everything above is sent to the [AI provider configured for the project](https://docs.smartestqa.ai/en/project-settings-ai.html#ai-account). Use documents without personal or customer data.

## 2. Requirements & Scenarios

The outline is a tree: requirement › sub-requirement › scenario. No steps exist yet; each scenario shows the chip **outline**. Everything is selected at first.

1. **Edit the outline**

   Use the pencil to rename requirements, sub-requirements and scenarios. **Add sub-requirement**, **Add scenario** and **Delete sub-requirement** change the structure. Untick what you do not want.
2. **Generate steps**

   Click **Generate steps (n)** for the selected scenarios. The browser waits up to 10 minutes.

   “Steps generated for *n* scenario(s)”. Each scenario now shows a coverage percentage instead of **outline**.
3. **Retry failures**

   A scenario without steps shows **failed** and “Step generation failed for this scenario. You can try again.” Keep it selected and click **Generate steps** again; scenarios that already have steps are skipped.
4. **Continue**

   Click **Continue to review (n)**. It needs at least one selected scenario with steps.

Also on this tab: **Check Coverage**, **Record Actions** and **Save as Draft** (see [Fix uncovered steps](https://docs.smartestqa.ai/en/analyze-import.html#coverage-check) and [Drafts](https://docs.smartestqa.ai/en/analyze-import.html#drafts)). **Cancel** discards the outline.

## 3. Review & Create

Each scenario lists its steps. A step marked **✓** uses an existing action (its name and type are shown) or another test case; a step marked **✗** has no matching action yet. The chip **Coverage: n%** and the bar sum this up; see [how coverage is counted](https://docs.smartestqa.ai/en/analyze-numbers.html#step-coverage).

### Fix uncovered steps

1. **Record the missing actions (web)**

   Click **Record Actions**, pick the [**Start Page URL**](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) and **Environment** ([DEV, TEST or PRP Environment](https://docs.smartestqa.ai/en/concepts.html#environments)) and start. “Recording started! Create actions in the new tab.” Record the controls the ✗ steps need, as in [Record Actions](https://docs.smartestqa.ai/en/discover-your-app.html#record-actions).
2. **Check Coverage**

   Back here, click **Check Coverage**. Every step is matched again against your current actions: “Coverage check completed!”.

### Create

1. **Review the selection**

   The button reads **Create (*x* req, *y* TC)**, with **+ Pipeline** when you chose Pipeline on Import. Selected scenarios must have steps; otherwise saving is blocked with “*n* selected scenario(s) have no steps yet…”.
2. **Click Create**

   “*n* requirements and *m* test cases created successfully!” The outline becomes read-only.

**Back to scenarios** returns to tab 2 without losing anything.

## What gets created

| Item | Where | Details |
| --- | --- | --- |
| Main requirements | The folder you selected in Analyze | One tree row each |
| Sub-requirements | Inside their main requirement | No tree rows |
| Test cases | The [Automate twin of the folder](https://docs.smartestqa.ai/en/automate-test-cases.html#modules): the module’s folder, or a sub folder with the same name inside it | Linked to their sub-requirement, in order |
| Steps | In the test cases | A step that matches an action uses it; a step that matches none gets a new [action](https://docs.smartestqa.ai/en/discover-actions.html) |
| Template test cases | Automate | A run of 3 or more steps that appears in 2 or more selected scenarios becomes a [shared template](https://docs.smartestqa.ai/en/automate-steps-flow.html#template) named `[Auto] step → step → …`, and the scenarios call it |
| Test suite and pipeline | [Schedule](https://docs.smartestqa.ai/en/schedule.html) | Only with Pipeline ticked: a suite with all new test cases and a pipeline named `AI Generated Pipeline - YYYY-MM-DD` that runs on the [SmartestQA server](https://docs.smartestqa.ai/en/schedule-where.html#server). It needs a [Start Page URL](https://docs.smartestqa.ai/en/quick-start-connect.html#start-page-url) (the default one, else the first); without one only the suite is created. |

Next: open the test cases in **Automate** to [run](https://docs.smartestqa.ai/en/automate-dry-run.html#start-dry-run) and [refine them](https://docs.smartestqa.ai/en/automate-editor.html#edit-steps), then check the requirement with [Assessment (AI)](https://docs.smartestqa.ai/en/analyze-assessment.html).

## Drafts and what is kept

- **The outline lives on your screen** until you click **Save as Draft** or Create. Save a draft before you switch folders or leave the page.
- **A folder remembers** its draft, its preferences and the first file you attached. Attachments beyond the first and the Target scope are not kept.
- **After Create** the draft is read-only. Start a new analysis for more.
- **A folder with requirements but no draft** opens on tab 2 with its main requirements listed read-only.

## Limits of this step

| Item | Limit |
| --- | --- |
| Browser wait for the outline | 3 minutes |
| Browser wait for step generation | 10 minutes |
| Server time for one step generation | 420 seconds, in batches of 4 scenarios, 4 batches at a time |
| Step generations running at once on the server | 3 (others wait up to 60 seconds for a slot) |
| App Map screenshots with a scope | 6 |
| Similar existing requirements sent | 10 |

## If something goes wrong

- [Analyze with AI is greyed out](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-ai-disabled)
- [“No requirements could be derived…”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-no-outline)
- [“Analysis failed”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-analysis-failed)
- [A file “could not be read”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-file-unreadable)
- [Scenarios show “failed”](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-steps-failed)
- [Create is blocked](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-save-blocked)
- [No pipeline in Schedule after Create](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-pipeline-missing)
- [My outline is gone](https://docs.smartestqa.ai/en/analyze-troubleshooting.html#fix-outline-lost)
