> For the complete documentation index, see [llms.txt](https://docs.docontrol.io/docontrol-user-guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docontrol.io/docontrol-user-guide/risk-management/ai-based-global-search.md).

# AI-based global search

Navigate your data maze to quickly pinpoint the riskiest use cases and SaaS security threats in your organization, or ask any AI question about your Google assets and identities.

## Prerequisites

To leverage global search and AI search in DoControl, make sure you have the necessary integrations:

* **Global search** - You must be integrated with Google Workspace&#x20;
* **AI search** - In addition to Google Workspace, you must be integrated with an HR system or Okta (for identity-related questions)

## Access AI-based global search

To access AI-based global search:

* In the top-right corner from any DoControl screen, click the **Global search** <img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FOMu4w5mAFJoSWvuWjnHg%2Fsearch%20icon.png?alt=media&amp;token=1ffb4e64-cbe3-49db-9e6e-220bd15825ed" alt="" data-size="line"> icon, or
* Click **Ctrl + K** (Windows) or **⌘ + K** (Mac) from anywhere in the DoControl platform\
  \
  ![](https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FpOMWRl6WMYLsA8pnJrTC%2FGo%20to%20nav%20bar.png?alt=media\&token=ed561ada-9805-4af2-936d-8edf1f17f303)

## Global search

You can search for risky use cases across your organization, as well as specific users, assets, workflows and shadow apps.&#x20;

For fast and efficient results, global search also offers you these shortcuts:

* [Exposure shortcuts](#exposure-shortcuts)
* [Feature shortcuts](#feature-shortcuts)
* [User exposure shortcuts](#user-exposure-shortcuts)

{% hint style="warning" %}
**LLM disclaimer**

AI-based global search leverages large language models (LLM) by reading your natural language question and translating it to the most relevant area in the DoControl product. This helps you to find exactly what you're looking for faster and more accurately. \
**For example** if you ask, Who are the riskiest users in the Marketing department?\
DoControl displays Marketing department users with critical risk.

**We do not share or store customer data with any LLM engine**. DoControl only translates and maps your question to a relevant area in the product. When you search for specific data items in global search, DoControl leverages internal search capabilities, and not LLM.
{% endhint %}

### Global search for users, assets, workflows and shadow apps

{% hint style="info" %}
To use global search, make sure you're integrated with Google Workspace.
{% endhint %}

1. Click **Ctrl + K** (Windows) or **⌘ + K** (Mac) to access global search from anywhere in the DoControl platform.
2. Start typing. All identities, internal and external users, Google assets, workflows, and shadow apps containing that string are displayed:<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FRCpSwtZnClrE1JXt7uCV%2Fglobal%20search%20users.png?alt=media&amp;token=b356a8ea-f245-4292-bab1-37454bba0c4b" alt=""><figcaption></figcaption></figure>
3. Click an **identity** to display the risk tab for that user in the Identities module.
4. Click an **internal user** to display exposure shortcuts for that user:

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2FfMmrVQcIoHsxFk8jagoj%2Fglobal%20search%20user%20ID.png?alt=media&amp;token=94c4908a-b9db-434c-8b5b-c9e54e5e8b13" alt=""><figcaption></figcaption></figure>
5. Select a [user exposure shortcut](#user-exposure-shortcuts) to display for the internal user.
6. Click an **external user** to display [user exposure shortcuts](#user-exposure-shortcuts) for that user.
7. Click a specific **Google asset** to open the asset view, with related events and collaborators, in your asset inventory.&#x20;
8. Click **View all results** to display all Google assets with the entered string.
9. Click a **workflow** to open it in the Workflow editor.
10. Click a **shadow app** to open it in the Shadow app module.

### Exposure shortcuts

1. Click **Ctrl + K** (Windows) or **⌘ + K** (Mac) to access global search from anywhere in the DoControl platform.<br>

   <figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2F95poytmOOuyv2s8HR7uZ%2Frisky%20use%20cases.png?alt=media&amp;token=b55720b1-e7ca-4381-aa97-d8d2189bf2fc" alt=""><figcaption></figcaption></figure>
2. Select an exposure shortcut to display the riskiest use cases for your organization's users:<br>

   <table><thead><tr><th width="273">Exposure shortcut</th><th>Filtered results</th></tr></thead><tbody><tr><td>Risky about-to-leave and terminated users</td><td>Display departing and terminated employees with the highest risk score in your organization</td></tr><tr><td>Exposed private email accounts</td><td><p>Display email addresses of non-corporate accounts with access to your assets in these apps:</p><ul><li><strong>Google Workspace</strong> - External users outside your organization with access to the most Google assets</li><li><strong>Slack</strong> - External users outside your organization</li></ul></td></tr><tr><td>Highly sensitive exposed assets</td><td><p>Display all sensitive exposed files in these integrated apps:</p><ul><li><strong>Google Drive</strong> - Public and externally shared assets with a high sensitivity ranking</li><li><strong>Slack</strong> - Public or externally shared files with a high sensitivity ranking</li></ul></td></tr><tr><td>Uploaded encryption keys and certificates</td><td>Display all Google assets with encryption key file suffixes</td></tr><tr><td>Inactive exposed assets</td><td><p>Display all unviewed files that were exposed in these integrated apps over the last 6 months:</p><ul><li><strong>Google Drive</strong> - Public and externally shared files that were never viewed</li><li><strong>Box</strong> - Publicly shared files that were never viewed</li></ul></td></tr><tr><td>Potentially risky events (Google and Slack)</td><td><p>Display all risky events involving Google and Slack files that were triggered in the last 30 days:</p><ul><li><strong>Public share</strong> - File visibility was changed to public</li><li><strong>External share</strong> - File was externally shared</li><li><strong>User operations</strong> - Login or admin action was initiated, such as suspend user, or move user to a different org unit</li><li><strong>Upload/download</strong> - A file was uploaded or downloaded</li></ul></td></tr></tbody></table>

### Feature shortcuts

1. Click **Ctrl + K** (Windows) or **⌘ + K** (Mac) to access global search from anywhere in the DoControl platform.
2. Select a **feature shortcut** to jump to a specific area in the product: <br>

   <table><thead><tr><th width="300">Feature shortcut</th><th>Filtered results</th></tr></thead><tbody><tr><td>High severity alerts</td><td>Display all active high severity alerts</td></tr><tr><td>Risky identities</td><td>Display the internal users with the highest risk score in your organization</td></tr><tr><td>Risky shadow apps</td><td><p>Display all risky shadow apps in these integrated apps:</p><ul><li><strong>Google Workspace</strong> - Display all apps with a risk score greater than 7</li><li><strong>Microsoft 365 -</strong> Display all Microsoft Entra ID apps with Write permission</li><li><strong>GitHub</strong> - Display all GitHub apps with Write permission</li></ul></td></tr><tr><td>Recently detected misconfigurations</td><td>Display the status of all recent SPM security checks per the CIS compliance standard</td></tr><tr><td>Workflow-triggering events</td><td>Display all events (from the last 30 days) that triggered a workflow</td></tr><tr><td>Recommended playbooks</td><td>Displays DoControl readymade playbooks per app</td></tr></tbody></table>

### User exposure shortcuts

For any internal or external user, you can drill-down to investigate these exposure use cases:

<table><thead><tr><th width="238">Exposure shortcut</th><th>Filtered results</th></tr></thead><tbody><tr><td>Active alerts </td><td>Display all active alerts where the user is the actor who triggered the alert</td></tr><tr><td>User exposed assets</td><td><p>Display all files that the user exposed in these integrated apps:</p><ul><li><strong>Google Drive</strong> - Public and externally shared files</li><li><strong>Slack</strong> - Public or externally shared files</li><li><strong>Box</strong> - Externally shared files</li><li><strong>Salesforce</strong> - Publicly shared files</li><li><strong>Zoom</strong> - Publicly shared recordings</li></ul></td></tr><tr><td>Highly sensitive exposed assets</td><td><p>Display all files that the user exposed in these integrated apps:</p><ul><li><strong>Google Drive</strong> - Public and externally shared files with a high sensitivity ranking</li><li><strong>Slack</strong> - Public or externally shared files with a high sensitivity ranking</li></ul></td></tr><tr><td>Uploaded encryption keys and certificates</td><td>Display all Google assets with encryption key file suffixes that the user shared from My Drive</td></tr><tr><td>Shared assets with labels</td><td>Display all Google assets with labels that the user publicly or externally shared from My Drive</td></tr><tr><td>Inactive exposed assets</td><td><p>Display all unviewed files that the user exposed in these integrated apps over the last 6 months:</p><ul><li><strong>Google Drive</strong> - Public and externally shared files that were never viewed</li><li><strong>Box</strong> - Publicly shared files that were never viewed</li></ul></td></tr><tr><td>Workflow-triggering events</td><td>Display all events (from the last 30 days) involving the user as actor where a workflow was triggered</td></tr><tr><td>Potentially risky events </td><td><p>Display all risky events involving Google and Slack files that were triggered by the user in the last 30 days:</p><ul><li><strong>Public share</strong> - User changed file visibility to public</li><li><strong>External share</strong> - User externally shared a file</li><li><strong>User operations</strong> - Actor initiated login or admin action, such as suspend user, or move user to a different org unit</li><li><strong>Upload/download</strong> - User uploaded or downloaded a file</li></ul></td></tr></tbody></table>

## AI search

You can leverage AI to ask anything related to Google assets and identities across your organization.&#x20;

{% hint style="info" %}

* To use AI search for identities questions, make sure you're integrated with Google Workspace and HRIS.
* AI search is a beta feature.&#x20;
* Check that the filters in your results match your search criteria.
  {% endhint %}

<figure><img src="https://3236294211-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MesrnyDMZGYg1V-tOBo%2Fuploads%2Fp19ed8M9PicgmsFzBUVI%2FAI%20search.png?alt=media&amp;token=c1ec3496-b6bc-4f32-afc7-e237351fded9" alt=""><figcaption></figcaption></figure>

1. Type any question to search for an answer across your Google assets and identities.
2. Click a [suggested question](#suggested-questions) from the list

{% hint style="success" %}
**Tip**: When searching for a specific user, enter the full user name or email.
{% endhint %}

### Suggested questions

DoControl displays a set of questions that leverage AI to display these results for Google assets and identities:

| Suggested question                                                    | Filtered results                                                                                                                                         |
| --------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Show me all employees that are considered risky                       | Users with a critical risk score (80-100) are displayed in the Identities module                                                                         |
| Show me all sensitive assets that are exposed to former employees     | Sensitive Google assets that were externally shared with a former employee's personal email account                                                      |
| Show me all highly sensitive exposed files                            | Google assets with a high sensitivity ranking that were shared with external collaborators or via a public link                                          |
| What inactive sensitive files are shared with external collaborators? | Google assets with a high sensitivity ranking that were shared with external collaborators or via a public link, and were last viewed before 90 days ago |
| What files are shared with employees' personal email accounts?        | Google assets that were shared with collaborators belonging to the personal email account group                                                          |
| What files are shared with untrusted domains?                         | Google assets that were shared with non-trusted domains                                                                                                  |
| Show me all exposed files that were not viewed in the last 90 days    | Google assets that were shared with external collaborators or via a public link, and were last viewed before 90 days ago                                 |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docontrol.io/docontrol-user-guide/risk-management/ai-based-global-search.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
