> For the complete documentation index, see [llms.txt](https://docs.aqua-cloud.io/documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aqua-cloud.io/documentation/aqua-intelligence/create-defects-with-aqua-intelligence-from-a-description-or-file.md).

# Create defects with aqua Intelligence from a description or file

You can quickly create defects directly from the navigation page using aqua Intelligence. Instead of filling everything manually, you can describe the issue in your own words, record a short explanation or upload a screenshot or PDF. 

aqua Intelligence will generate a complete defect for you that you can review and save.

### How to create it:

1. Go to the **Navigation** page.
2. Click **Add new**.
3. Select **Defect**.
4. Choose **With aqua Intelligence.**

<figure><img src="/files/6Tb2LhSH8ucjC1uxJZMp" alt=""><figcaption></figcaption></figure>

Choose how you want to describe the problem

#### Option 1: Type a description

1. Select Description.
2. Enter or paste the details of the issue.\
   You can describe what happened, what you expected, where it occurred or any other context.

<figure><img src="/files/Q239WOSmOM6D1KqbDuNf" alt=""><figcaption></figcaption></figure>

#### Option 2: Narrate the issue

1. Click the microphone icon.
2. Briefly explain the problem in your own words.\
   The system will transcribe your narration and use it to generate a defect.

#### Option 3: Upload a screenshot or PDF

1. Select File.
2. Upload one or more screenshots or a PDF.\
   aqua Intelligence will extract visible information and generate a defect based on the content.

Once aqua Intelligence finishes, you will see a preview of the defect. You can:

* Read the generated title, steps, actual result and expected result
* Edit any part of it
* Click **Regenerate** if you want a different result
* Click Cancel if you do not want to create the defect

<figure><img src="/files/R8wQtiL8pFHwR7BdcDjw" alt=""><figcaption></figcaption></figure>

If everything looks correct:

1. Click **Save**.
2. A new defect will be created and opened for you.
3. Any screenshots or PDFs that you uploaded will automatically appear in the Files tab.

You can then adjust priority, version, assignment or any other fields if needed.


---

# 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, and the optional `goal` query parameter:

```
GET https://docs.aqua-cloud.io/documentation/aqua-intelligence/create-defects-with-aqua-intelligence-from-a-description-or-file.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.