> For the complete documentation index, see [llms.txt](https://docs.dogq.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.dogq.io/documentation/ai-powered-tools/ai-suggester.md).
# AI Suggester
This AI-powered assistant is designed to help you boost your coverage by generating tailor-made Scenarios that you can add to your project. It's a very handy feature you can use to turn test descriptions into entire sets of new Scenarios.
### How does it work
Suggester operates on a Module level. Once you've created some tests in your Module, it can analyze them and use the test data inside to suggest new Scenarios. It strongly depends on the existing Scenarios and may not perform ideally when there isn't enough data (URLs, selectors, values, etc). In such cases it can generate a dummy value, which you can later adjust manually.
### How to use
On the buttons panel inside every Module you can find the Suggest Scenarios button.
To see the buttons panel you need to have at least 1 Scenario in current Module
Clicking on it opens a modal window. Here you can choose to add any extra specifications for Suggester or just click and continue without a prompt.
The process may take up to 5 minutes. It analyzes your Module, its name, its Scenarios, steps and descriptions inside them. Based on all that data, Suggester generates a list of test you can selectively add to your Module.
Sometimes the page needs to be refreshed for the tests to become clickable.
Once the generation is complete you can click on every test individually to view the details.
Use the Save to Module toggle on the right side to select the tests you need and click
{% hint style="success" %}
To help Suggester perform better, add descriptions to Scenarios and key Steps.
{% endhint %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## 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://docs.dogq.io/documentation/ai-powered-tools/ai-suggester.md?ask=
```
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.