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

# Bubble AI Agent

The **Bubble AI Agent** is an in-editor assistant that helps you build, troubleshoot, and understand your app more efficiently. It uses Bubble documentation and app context to provide hands-on guidance so you can spend less time searching for answers and more time building.

## How to access the AI Agent

The Agent opens automatically the first time you load your app — there’s nothing to install or activate. You can minimize it at any time and reopen it by clicking the magic wand icon in the top navigation bar: <img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FywEwNavcFGIHpu7stf8w%2Fai-agent%402x.png?alt=media&#x26;token=42d4446f-f741-4dc7-a0d0-5f17f1ce9d7f" alt="" data-size="line">. The window is resizable and responsive, and it remains open until minimized <img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FYF95EINdFcC5jhh8JDXu%2Fminimize-icon%402x.png?alt=media&#x26;token=ced46c82-344a-4dd4-880c-0da76adb816d" alt="" data-size="line">. You can keep it visible while working in the editor or hide it when you prefer a cleaner workspace.

<figure><img src="https://34394582-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-M5sbzwG7CljeZdkntrL%2Fuploads%2FmnRcUk58ltSuEzsHMIrY%2Fai-agent-pinned.png?alt=media&amp;token=ae2367a3-8d2a-4804-920c-706c14754b50" alt="The toolbar button that opens the AI agent, and the AI agent pinned to the right"><figcaption><p>Quickly access the AI Agent whenever you need it, by clicking the AI Agent in the top toolbar.</p></figcaption></figure>

## Permissions

The Bubble AI Agent works with the same permissions as the person who starts the chat, with one additional limit on reading app data.

<table><thead><tr><th width="202.171875">Your permissions</th><th>What the Agent can do</th></tr></thead><tbody><tr><td>Editor</td><td>Make edits to the app on your behalf.</td></tr><tr><td>View only</td><td>Inspect the app and give guidance, without making changes.</td></tr></tbody></table>

Reading app data (the records stored in your app's database) is further limited to owners and admins, and only for the data types enabled in *Agent settings*. This means that even when an editor starts the chat, the Agent can't read the app's data unless that person is an owner or admin.

If you have collaborators in your app, each collaborator's Agent follows their own permissions. Someone with view-only access can't use the Agent to edit your app. If they ask it to, the Agent declines.

## Generate apps with AI

The AI Agent helps you refine your idea, build a blueprint for your app, and generate it from scratch. Instead of starting from a blank canvas, you can describe what you want your app to do the the AI Agent, and it will set up a plan and execute with your approval.

The finished product comes complete with pages, elements, a database, workflows and sample data for your [development environment](#user-content-fn-1)[^1]. In addition to the features you specifically ask for, the Agent will also build out typical needed core features like sign-up, login and reset password flows.

This allows you to get started instantly, reducing the time it takes to go from idea to working prototype. By seeing the app in the editor, and asking the AI Agent questions, you'll also quickly learn how Bubble's logic works.

**Article:** [Generate apps with AI](/help-guides/ai/bubble-ai-agent/generate-apps-with-ai.md)

## Edit existing apps

The AI Agent also helps you continue developing your app after the first version is done. It can add and edit pages, wire up workflows, structure your database, connect to external APIs, make style changes and many other things.

Additionally, the Agent can explain how your app works, read data and offer guidance as you keep building. The combination of the know-it-all Agent and Bubble's easy-to-use visual editor makes powerful app development approachable, whether you're building your first app or your fiftieth.

**Article:** [Edit apps with AI](/help-guides/ai/bubble-ai-agent/edit-apps-with-ai.md)

[^1]: The development environment is where you build and test changes to your app before they go live. Changes made here don't affect your users until you deploy them to the live environment.

    **Article series:** [Version control](/help-guides/maintaining-an-application/version-control.md)