> For the complete documentation index, see [llms.txt](https://cortex-docs.paloaltonetworks.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/investigate-and-respond-to-incidents/build-xql-queries/about-the-query-builder.md).
# About the Query Builder
{% hint style="info" %}
### Notice
Building Cortex Query Language (XQL) queries in the Query Builder requires a Cortex XDR Pro license.
{% endhint %}
The Query Builder aids in the detection of threats by allowing you to search for indicators of compromise and suspicious patterns within data sources. It assists in expanding incident investigations by identifying related events and entities, such as activities associated with specific user accounts or network lateral movement. In addition, the Query Builder enables data analytics on suspected threats, helping organizations analyze large volumes of data to identify trends, anomalies, and correlations that may indicate potential security issues.
To support investigation and analysis, you can search all of the data ingested by Cortex XDR by creating queries in the Query Builder. You can create queries that investigate leads, expose the root cause of an alert, perform damage assessment, and hunt for threats from your data sources.
Cortex XDR provides different options in the Query Builder for creating queries:
* XQL Search (Build your own queries)
You can use the Cortex Query Language (XQL) to build complex and flexible queries that search specific datasets or presets, or the entire `xdr_data` dataset. With XQL Search you create queries based on stages, functions, and operators. To help you build your queries, Cortex XDR provides tools in the interface that provide suggestions as you type, or you can look up predefined queries, common stages and examples.
Note
Schema changes to datasets may not be reflected in the autocomplete suggestions and deļ¬nitions as you type in real time the XQL query and can appear with a slight delay.
Tip
When creating XQL queries, you can:
Use the up and down arrow keys to navigate through the auto-suggestion commands and definitions.
Select an auto-suggestion command by pressing either the Enter or Tab key.
Press Shift+Enter to add a new line, and easily ignore the auto-suggestion output.
Cose the auto-suggestion output by pressing the Esc key.
* Predefined queries for different types of entities
---
# 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://cortex-docs.paloaltonetworks.com/cortex-xdr-3.x/cortex-xdr-3.x-documentation/investigate-and-respond-to-incidents/build-xql-queries/about-the-query-builder.md?ask=&goal=
```
`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.