# The Advanced editor The Advanced editor is a full-screen editor for everything the analysis generated for a Web Agent. It has the agent's files, your repository and a chat with Faustine AI on one screen, and you can change a file by typing in it or by asking for the change. To open it, select your agent in [**Web Agents**](https://auth.faustine.ai/go?to=%2Fweb-assistants), open the **Actions** menu in the header and select **Advanced editor**. ## How it works The editor works on the same draft as the rest of the portal. An edit you make here shows in the **Actions** tab, and an edit you make there shows here. Nothing reaches your site until the draft is published. Faustine AI reads your code before it changes anything. The repository is open at the commit the draft's base version was generated from, so its answers match how the app works at that version. For an agent built from a ZIP, it reads the stored archive. The editor needs a published version to start from. For a new agent, finish the setup wizard or publish the draft first. ## The screen | Area | What is in it | | --- | --- | | Explorer | The agent's files, then your code. **Assistant tools** holds `authentication.js`, `navigation.js`, `sdk-runtime.js` and one file for each action under `actions//`. **Persona** holds `app-description.md`, `assistant-role.md` and `user-audience.md`. **Look** holds the look of the components. Test suites are listed next. **Repository** and **Reference** are your code and your reference material. | | Editor | The open files, in tabs. An action shows its JSDoc and its implementation. | | **Faustine AI** | The chat. Each conversation is kept, and **Conversations** lists them. | Your repository, the reference material and `sdk-runtime.js` are read-only. A dot next to a file marks it as changed in this draft. ![The Advanced editor: the explorer with the agent's files and the uploaded code, authentication.js open in the middle, and Faustine AI on the right.](https://docs.faustine.ai/images/web-agents/advanced-editor-light.png) ## Ask for a change Describe what is wrong or what you want in the chat, such as `listCompanies should support pagination`. Faustine AI reads the files it needs from the repository, edits the agent's files in the draft and says what it changed. The files it read are listed in the conversation, and you can open each one. While a reply is being written, the editor's fields are locked. **Stop** ends the reply. Faustine AI can also write a test suite. The suite appears in the explorer, and you run it from the agent's **Tests** tab. See [Tests](https://docs.faustine.ai/web-agents/tests/). ## Edit by hand Open a file from the explorer and type. The editor saves to the draft on its own, and the status bar shows **saving…** and then **saved**. There is no separate save step. Each file has two modes. | Mode | What it shows | | --- | --- | | **Edit** | The file, editable. | | **Diff** | The draft next to the version it is based on. | ## Publish from the editor **Publish** followed by the next version number, such as **Publish v4**, publishes the draft as a new version. It is the same operation as **Publish** in the agent's header. See [Publish a version](https://docs.faustine.ai/web-agents/publish-a-version/). ## When a newer version exists If a version is published elsewhere while the editor is open, the draft in the editor is marked **Stale** and a banner asks you to rebase. **Rebase…** starts the draft again from the latest version. > **Warning:** Rebasing discards the edits in the editor's draft. The dialog says whether there are edits to lose before you confirm with **Rebase & discard**. ## The editor's copy of your code Faustine AI works on the editor's copy of your code. The status bar shows the state of that copy and calls it the workspace. | State | Meaning | | --- | --- | | **Workspace ready** or **Workspace live** | You can send a message. | | **Workspace asleep** | The copy stopped after a period without use. Your next message starts it again. | | **Code unavailable** | Faustine cannot read the code. The connection to the repository was revoked or expired, or the uploaded code was deleted. | ## Keyboard shortcuts On Windows and Linux, use Ctrl in place of Cmd. | Shortcut | Action | | --- | --- | | Cmd+P | Go to a file | | Cmd+Shift+P | Open the command palette | | Cmd+B | Show or hide the explorer | | Cmd+I | Show or hide Faustine AI | | Cmd+S | Save the pending edit now | ## Troubleshooting | Symptom | Cause | Fix | | --- | --- | --- | | **Publish a version first** | The agent has no published version. | Publish the draft from the agent's page, then open the editor again. | | **Advanced editor** is disabled in the **Actions** menu | The agent was built from a ZIP and the stored code was deleted. | Select **Upload the code again** in the same menu. | | **Code unavailable** | The repository connection no longer works. | Reconnect the account under which the repository was connected. | | **Your draft is based on an older version — rebase it before applying.** | A newer version was published after the draft was started. | Select **Rebase…**. | | **The draft failed validation** | The code in the draft has an error. The message names it. | Fix the file, or ask Faustine AI to fix it, and publish again. | ## Next steps - [Edit an action](https://docs.faustine.ai/web-agents/edit-an-action/): the smaller editor for one action. - [Publish a version](https://docs.faustine.ai/web-agents/publish-a-version/): what publishing does to your environments. - [Add reference repositories and API docs](https://docs.faustine.ai/web-agents/reference-repositories/): give Faustine AI your backend to read.