> For the complete documentation index, see [llms.txt](https://help.felt.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.felt.com/felt-ai/ai-assistant.md).

# AI assistant

Learn Felt and build maps with Felt AI. Ask it to find data, run analysis and SQL, style layers, or create dashboards.

Ask Felt AI to explain Felt, find data, analyze it, or change your map. It shows each step as it works. Click **Felt AI** (the sparkle icon) in the toolbar at the top right of the map, between **Comment** and **Share**, or press **Shift+Cmd+K** (Mac) or **Ctrl+Shift+K** (Windows). Enter your request and press **Enter**.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2FNCAaKL0cFrYYwIAgLd1S%2FFelt%20AI%20Demo%20(1%20prompt%20light)-blog.mp4?alt=media&token=31b55546-38bd-4357-a268-4f692469a8d1>" %}

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-5f655ce781416f9597abede6026630671e0bb582%2Ffelt-ai-panel.webp?alt=media" alt="Felt AI panel open on the right of a Seattle schools map, with the Felt AI button selected in the toolbar, the prompt box, and suggested prompts."><figcaption></figcaption></figure>

## Learn Felt with Felt AI

Felt AI uses the help center to explain tasks and guide you through them on your map, such as "How do I upload a spreadsheet of addresses?" Ask it to explain its changes as you go. For more prompts, see [Learn as you go](/felt-ai/prompting-tips.md#learn-as-you-go).

## Who can use Felt AI

Felt AI needs a seat but no setup. Workspace admins can't turn it off. If you don't have a seat, click **Request** in the Felt AI panel to ask an admin. See [Seats and viewers](/plans-and-billing/seats-and-viewers.md).

Viewers and people using a public link or embed can't use Felt AI, but they see its changes to the map.

Requests use the workspace's shared monthly Felt AI credits. At the limit, Felt AI stops taking new requests until credits reset or an admin buys more usage. See [Plan usage](/plans-and-billing/plan-usage.md).

## What Felt AI can do

Enter **@** in the prompt box to choose a layer or source. Felt AI also sees your selection, such as a polygon you drew, so you can ask about "the selected area".

<figure><img src="https://217108486-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FmRfGitkyjOEMvVsEyGWN%2Fuploads%2Fgit-blob-5d23bc01ead15b3d80c86b201f89a0b74b8dce86%2Ffelt-ai-at-picker.webp?alt=media" alt="Felt AI prompt box with @ entered and a list of map layers and sources to choose from."><figcaption></figcaption></figure>

### Find and add data

Felt AI looks for data in this order and stops at the first match:

1. Layers already on the map
2. Your workspace's [Felt Servers](/upload-anything/felt-servers.md)
3. Your workspace's connected [data sources](/upload-anything/data-sources.md), such as databases and buckets
4. The [Global Library](/upload-anything/global-library.md)
5. A curated catalog of public GIS services, ArcGIS Online, ArcGIS Hub, and USGS 3DEP elevation data

Name the place you want data for. Data from your workspace or the Global Library usually appears within a minute, and a search of public GIS services can take a few minutes.

Felt AI doesn't search the web. When it can't find data, it says where it looked and suggests alternatives. It can also add data from a URL. For example prompts, see [Prompts to start with](/felt-ai/prompting-tips.md#prompts-to-start-with).

### Analyze and query data

Felt AI runs buffers, joins, and other spatial analysis and adds the results as layers. A result layer doesn't update when its inputs change: ask Felt AI to rerun the analysis, or use a [SQL query](/upload-anything/sql-queries.md) on a source for a layer that stays current. Felt AI also answers questions in chat, such as a count or the elevation at a point, and runs read-only SQL on database sources.

### Query map layers with SQL

Map layers have no SQL editor. Describe the query, such as a join or a group-by, and Felt AI writes and runs the SQL. To see the SQL, expand the steps and click **Result** on a step.

### Travel-time areas

{% hint style="success" %}
Available on the Business and Enterprise plans. [Compare plans](https://felt.com/pricing#compare)
{% endhint %}

Ask Felt AI for the area reachable in a set time by car, bike, or on foot. See [Spatial analysis](/analysis-and-dashboards/spatial-analysis.md#create-travel-time-areas).

### Style layers and build dashboards

Felt AI styles layers by category or value, with heatmaps, H3 hexbins, labels, popups, and filters. It also adds [dashboard components](/analysis-and-dashboards/dashboards.md), such as a statistic, bar chart, or filter.

### Edit data

Felt AI can calculate values from other columns, split a column, or make other bulk edits. For example, ask Felt AI to split values from a KML or KMZ file's description column into separate columns. It can also add or delete features, and add, rename, or delete columns. See [Edit features](/layers/edit-features.md).

### Mark up and manage the map

Felt AI draws annotations, finds places by name or address, organizes layers, and exports the map as a PNG, JPG, or PDF. It also lays out and exports [print layout](/export-and-print/print-layouts.md#make-a-page-with-felt-ai) pages.

## Changes Felt AI makes to your map

Felt AI changes the map as it works, asking for approval only when your request is unclear. Everyone with access to the map sees the result.

Felt AI works on a copy of the map in your workspace when you have View or Contribute access, or when you're in view mode. If you have Edit access, click **Edit this map instead** before you send your request, and Felt AI works on the original.

{% hint style="danger" %}
Felt AI edits can't be undone. Before a large change, duplicate the map and turn off **Sync** on the copy's Felt Server layers, so data edits don't reach both maps. See [How copies stay in step](/layers/copy-and-duplicate-layers.md#how-copies-stay-in-step).
{% endhint %}

## What Felt AI can't do

Felt AI can't:

* Create a new map or work on another map. To create maps from an AI tool, use [MCP integrations](/felt-ai/mcp.md).
* Accept files, images, or prompts over 10,000 characters. To add a file, [upload it](/upload-anything/files.md).
* Refresh a layer, add comments, or invite people.

Felt AI reads a layer's columns before it queries or edits the layer. Still, check its results, especially column names, before you rely on them.

## Felt AI conversations

Felt AI saves each conversation with its map. Conversations stay private unless you share them.

* Reopen the panel to continue your latest conversation on the map.
* To find an earlier conversation, open its map, click **New chat**, and select it under **Recent chats**.
* To share one, click **Copy link to this chat**. People with map access can read it but not change it.

You can't delete or export a conversation. To keep a response, hover over it and click **Copy**.

## Felt AI and your data

Felt AI runs on frontier models through Amazon Bedrock. Your data is never used to train models. Felt AI can access only what you can. See [Security and privacy](/administration/security-and-privacy.md).

## Felt AI in other editors

{% hint style="success" %}
Available on the Business and Enterprise plans. [Compare plans](https://felt.com/pricing#compare)
{% endhint %}

Felt AI also drafts editable code in the **Felt AI** tab of the [Extension editor](/developers/extensions.md), the [custom HTML popup editor](/styling/popups.md#custom-html-popups), and the [SQL query editor](/upload-anything/sql-queries.md). See [Prompting tips](/felt-ai/prompting-tips.md).


---

# 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://help.felt.com/felt-ai/ai-assistant.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.