# Searching with Autopilot

> Search Test Manager content using natural language queries with Autopilot to find and act on test artefacts.

:::note
Feature availability depends on the cloud platform you use. For details, refer to the [Test Manager feature availability page](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/test-manager-feature-availability-page).
:::

You can perform searches using everyday language with Autopilot. Autopilot provides recommended actions based on your search results and allows you to search across multiple objects by their properties and relations.

:::note
Autopilot Search is available in Test Manager delivered through Automation Cloud — this page describes that experience. In Test Manager delivered through Test Cloud, use the Autopilot Search tool inside Autopilot Chat instead. For more information, refer to [About Autopilot Chat](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/about-autopilot-chat).
:::

## Prerequisites

To use the Search with Autopilot functionality, ensure you have been assigned the following project scope permissions within Test Manager:

* Requirements - Read
* Test Case - Read
* Test Set - Read
* Test Results - Read
  :::note
  The Test Manager **Viewer** role is pre-configured with all these permissions.
  :::

## Searching within a project

To search information within a project, follow these steps:

1. Open the desired project.
2. Select **Search with Autopilot** in the project's left-navigation panel.
   * If using Test Cloud, use the Autopilot Search tool inside Autopilot Chat instead. For more information, refer to [About Autopilot Chat](https://docs.uipath.com/test-manager/automation-cloud/latest/user-guide/about-autopilot-chat).
3. In the **Describe what you want to find** field, enter the information you want to search within your project. If you are uncertain of what to search for, consider selecting one of the example search queries listed under **Suggestions**. Alternatively, you can choose a category under **Describe what you want to find** to view available suggestions specific to a test artefact type.
4. After you select a suggested search query, select **Search**.
5. Optionally, if you want to search for something else, select **Back**, and repeat these steps.

You can also interact with the search results. For instance, if you search for test cases not linked to any requirement, a list of such test cases is displayed. From this list, you can select test cases and execute actions such as exporting, deleting, or modifying their labels. This applies to other objects as well.

After you perform the first search, your queries will be visible under the **Recent** section of the Autopilot search. After you have searched for five different topics, the **Recent** section will replace the **Suggestions** section.

Figure 1. The Search with Autopilot section within a Test Manager project

   ![The Search with Autopilot section within a Test Manager project](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-the-search-with-autopilot-section-within-a-test-manager-project-642219-ec3ea413-f8fea989.webp)

## Defect support in Autopilot Search

Use Autopilot Search to list defects by status and to check which objects are impacted by these defects.

Here are some examples:

* List all open defects with Open status ordered by severity descending.
* List all requirements which are affected by defects with Open status.

## Test Case log support in Autopilot Search

Use Autopilot Search for the following functions:

* Search for Test Case logs to locate specific errors, messages or patterns without leaving Autopilot Search.
* Select one or more Test Case logs and export the results to Excel.
* Compare Test Case logs against record of test executions to identify root cause of issues.
* Assign or clear assignments one by one or in bulk.

You can search using keywords that match assertions, logs, execution details, affected requirements or healing logs. Here are some examples:

* Find all test case logs which failed.
* Show the executions where the “Assert Verify Dashboard Page” failed more than once.
* Show executions containing “timeout exception”.
* Show all the logs which were executed by robot “user@acme.com-unattended”.
* Show all the execution logs which affect requirement “R:123”.
* Show all the executions where healing was involved.

Figure 2. Test Case logs in Autopilot Search

  ![Test Case logs in Autopilot Search](https://dev-assets.cms.uipath.com/assets/images/test-manager/test-manager-test-case-logs-in-autopilot-search-646089-80664bd5-cca6d496.webp)

## Result

The search results are displayed based on your natural language query. You can interact with the results directly—for example, exporting, deleting, or modifying labels on the returned objects.