# Data Explorer & AI Search

*Currently in Beta*

## What is AI Search?

Finding exactly what you're looking for in your data catalog just got a whole lot easier. **AI Search** is a new feature that lets you search your data assets using plain English — no need to manually configure filters or know the exact name of a data element or category.

Instead of clicking through dropdowns to narrow down results, you can just type what you're looking for in natural language and let AI do the heavy lifting.

## What is Data Explorer?

**Data Explorer** is Teleskope's unified view of all your data assets across connected sources — S3, Google Drive, SharePoint, and more. It gives you a single place to browse, filter, and search every file, table, and object that Teleskope has scanned, with rich context about what sensitive data lives inside, who has access to it, and whether it has any active findings.

Each resource in the Data Explorer shows:

* **Sensitivity** — the highest sensitivity level detected in the resource (Critical, High, Medium, Low)
* **Data elements** — the specific types of sensitive data found (e.g., SSN, credit card numbers, email addresses)
* **Document Types** — document type and classification tags applied to the resource
* **Connector** — the data source the resource lives in
* **Findings** — any active policy violations associated with the resource
* **File path** — where the resource lives within its data source

Clicking any row opens a **detail panel** with a deeper view of the resource, including its full data classification breakdown, permissions, and findings history.

The Data Explorer has two modes: **Browse**, which lets you manually apply filters and sort the full catalog, and **AI Search**, which lets you find resources using plain English queries.

## How It Works

When you type a query, AI Search interprets your natural language input and automatically maps it to the right filters and data catalog parameters. Here's what happens behind the scenes:

1. **Your query is analyzed** — The AI identifies key terms in your search, such as data types (PII, SSN, PHI), connectors (S3, Google Drive, SharePoint), sensitivity levels, and compliance policies (GDPR, HIPAA).
2. **Terms are resolved** — Each term is matched to the right internal concept. For example, "PII" gets mapped to the relevant data category, and "S3" gets mapped to the correct connector type. When there's some ambiguity, the AI picks the best match and notes alternatives.
3. **Results are returned** — The catalog is queried and results are surfaced, just like if you'd applied the filters manually — but in seconds, with a single sentence.
4. **You see how it interpreted your query** — After each search, AI Search shows you a plain-language explanation of how it understood your input and what filters it applied. This helps you verify the results are accurate and refine your search if needed.

## What You Can Search For

AI Search currently supports the following types of search criteria:

* **Resource type** — e.g., CSV files, spreadsheets, Word documents
* **Data elements** — e.g., SSN, credit card numbers, phone numbers, email addresses
* **Data categories** — e.g., PII, PHI, PCI, Financial
* **Risk** — e.g., critical, high, medium, low
* **Data size** — e.g., large files
* **Connector / data source** — e.g., S3, Google Drive, SharePoint
* **Findings** — e.g., resources with active violations, GDPR findings
* **Document Types** — custom tags applied to resources
* **Access & permissions** — e.g., files shared with a specific user, domain-readable files in Drive, externally accessible SharePoint resources

## How to Use AI Search

1. Navigate to **Data Explorer** in the left-hand navigation
2. Click into the search bar at the top of the page — suggested example queries are surfaced here to help you get started
3. Type your query in plain English and press Enter
4. Review the results — AI Search will display a short message showing how it interpreted your query
5. If the results aren't quite right, try refining your query using the suggestions provided, or add more specific terms

**Tips for better results:**

* Be specific about the connector when you can (e.g., "S3 files" rather than just "files")
* Use familiar data terms like "PII", "SSN", "PHI", or "credit card" — AI Search understands these
* If you're looking for something related to violations or policy breaches, include terms like "violating", "at risk", or "with violations"
* If results are too broad, try narrowing by adding more context (e.g., instead of "PII files", try "critical PII files in Google Drive")

## Feedback

AI Search is new and actively improving. This is only supported for S3, Google Drive and Sharepoint/One Drive connectors. If you run into unexpected results, have suggestions, or want to share what's working well, please reach out to your Customer Engineer — your feedback directly shapes the roadmap.


---

# Agent Instructions: 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.teleskope.ai/the-platform/ai-search.md?ask=<question>
```

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.
