Dev to main, 14th August, 2026

src/pages/docs/falcon-ai/guides/chat-with-falcon-ai.mdx

@@ -9,10 +9,7 @@ Falcon AI is the AI copilot built into the Future AGI dashboard, reachable from
 
 Click **Falcon AI** in the dashboard's navigation sidebar. It opens the full-page view at `/dashboard/falcon-ai`, with your conversations listed down the left and the chat itself in the center.
 
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/open-nav-item.png" alt="The dashboard navigation sidebar with the Falcon AI item highlighted" style={{ borderRadius: '5px' }} />
-*The Falcon AI item in the dashboard nav opens the full-page view*
-
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/open-full-page.png" alt="The Falcon AI full page with a conversation list on the left and the chat in the center" style={{ borderRadius: '5px' }} />
+<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/open-full-page.png" alt="The Falcon AI full page with the Falcon AI nav item selected in the sidebar, three past conversations listed on the left, and an answer in the center" style={{ borderRadius: '5px' }} />
 *The full page adds a conversation list; the side panel doesn't*
 
 From anywhere else, press `⌘K` (Mac) or `Ctrl+K` (Windows/Linux), or click the floating button in the bottom-right corner of the page, tooltipped **Falcon AI (⌘K)**. Either opens a panel that slides in from the side, so you can keep the page underneath in view while you ask something.
@@ -38,9 +35,11 @@ Below that sit five quick-action chips:
 
 Click one to prefill the input, then edit it before sending, or type your own question instead.
 
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/empty-state-quick-actions.png" alt="Falcon AI's empty state with the How can I help heading and five quick-action chips above the input" style={{ borderRadius: '5px' }} />
+<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/empty-state-quick-actions.png" alt="Falcon AI's empty state with the How can I help heading, five quick-action chips below it, and a row of skill chips just above the input" style={{ borderRadius: '5px' }} />
 *The five chips disappear once the conversation has its first message*
 
+The second row of chips, the one sitting directly above the input, is a different thing: those are the [skills](/docs/falcon-ai/concepts/skills) available in your workspace, shown here as shortcuts.
+
 ## Ask a question and send it
 
 Type your question into the input at the bottom and click **Send**, or press Enter to send and Shift+Enter to add a newline. Send stays inactive until there's something to send, either typed text or [an attached file](#attach-a-file), so an empty input can't be submitted by mistake.
@@ -65,7 +64,7 @@ Falcon AI defaults to Auto, reading the page you're on to work out what you're a
 
 ## Attach a file
 
-Falcon AI reads whatever you attach to help answer your question, alongside anything you type. Click the **+** button in the input area, labeled **More**, and choose **Attach files**, or drag a file onto the input and drop it. Falcon AI accepts:
+Falcon AI reads whatever you attach to help answer your question, alongside anything you type. Click the **+** button in the input area, tooltipped **More**, and choose **Attach files**, or drag a file onto the input and drop it. A paperclip sits beside it, tooltipped **Attach file**. Falcon AI accepts:
 
 - Plain text, CSV, HTML, Markdown, and JSON
 - PDF
@@ -74,8 +73,8 @@ Falcon AI reads whatever you attach to help answer your question, alongside anyt
 
 Each file tops out at 10 MB, and the **Attach files** menu option reads "Uploading..." while the file goes up.
 
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/attach-file.png" alt="The plus menu open above the input with an Attach files option, and a file mid-upload showing Uploading" style={{ borderRadius: '5px' }} />
-*The plus button is labeled More; Attach files is the option that opens the file picker*
+<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/attach-file.png" alt="The plus menu open above the input, listing Attach files and Connectors" style={{ borderRadius: '5px' }} />
+*The menu carries **Connectors** too, which is where you reach [MCP connectors](/docs/falcon-ai/concepts/mcp-connectors) without leaving the chat*
 
 <Note>
 A file over 10 MB is dropped with no message. If an attachment you tried to add never shows up above the input, that's why, so check its size and try a smaller file.
@@ -85,10 +84,10 @@ A file over 10 MB is dropped with no message. If an attachment you tried to add
 
 The response streams in as it's generated, and the input stays disabled until it finishes.
 
-If Falcon AI needs a tool along the way, a card appears in the conversation, starting at "Running...". Open it to see **Parameters**, what was sent, and **Result**, what came back, with **Full output** available when there's more to show. [Understanding Falcon AI](/docs/falcon-ai/concepts/understanding-falcon-ai) covers how it decides which tool to reach for.
+If Falcon AI needs a tool along the way, a card appears in the conversation, starting at "Running...". Collapsed, it shows the tool's name and the first line of what came back. Open it and you get a sentence describing what that tool does, then **Parameters**, **Result**, and **Full output**: **Parameters** is a disclosure of its own, holding the JSON that was sent, and it only appears when the call took arguments; **Result** is the same one-line summary from the collapsed state; **Full output** renders what came back, as a table where the tool returned rows. [Understanding Falcon AI](/docs/falcon-ai/concepts/understanding-falcon-ai) covers how it decides which tool to reach for.
 
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/tool-card-parameters-result.png" alt="An open tool call card showing its Parameters and Result sections, with a Full output option" style={{ borderRadius: '5px' }} />
-*A tool card opens to Parameters and Result; Full output expands longer results*
+<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/tool-card-parameters-result.png" alt="An open tool call card for list_scenarios, showing its Parameters JSON, its Result line, and the Full output table beneath" style={{ borderRadius: '5px' }} />
+*Parameters is collapsed until you open it, and a tool that took no arguments has no Parameters section at all*
 
 If a turn is taking too long, click **Stop**. It cuts the response off where it is and keeps whatever has been written so far, rather than discarding it.
 
@@ -97,9 +96,9 @@ If a turn is taking too long, click **Stop**. It cuts the response off where it
 
 ## Copy or rate an answer
 
-Under each answer sit three actions: **Copy**, which copies the response to your clipboard, and **Good response** or **Bad response**, which record whether it was useful.
+Under each answer sit three icon buttons: **Copy**, which copies the response to your clipboard, and **Good response** or **Bad response**, which record whether it was useful. They carry no labels, so read them by their icons: a pair of pages, a thumbs up, and a thumbs down.
 
-<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/copy-rate-response.png" alt="An assistant message with Copy, Good response, and Bad response actions beneath it" style={{ borderRadius: '5px' }} />
+<img src="/images/docs/falcon-ai/guides/chat-with-falcon-ai/copy-rate-response.png" alt="An assistant message with the copy, thumbs up, and thumbs down icon buttons beneath it" style={{ borderRadius: '5px' }} />
 *Copy, Good response, and Bad response sit under every answer*
 
 ## Pace and cost

src/pages/docs/falcon-ai/guides/connect-mcp-server.mdx

@@ -11,7 +11,10 @@ Before you start, make sure you have access to Workspace Settings in your worksp
 
 Connectors live on the **Falcon AI Connectors** page, under **Workspace Settings** in Settings. Open Settings, then click **Falcon AI Connectors** in the sidebar to go straight there. Click **Add Connector** to open the form.
 
-You can also get here from inside a conversation: **Manage connectors** in the chat input's **+** menu takes you to this same page, or use **Add custom connector** in Customize to add one without leaving the chat.
+<img src="/images/docs/falcon-ai/guides/connect-mcp-server.png" alt="The Falcon AI Connectors settings page with no connectors added, showing the Add Connector button top right and the No connectors configured panel with Add your first connector" style={{ borderRadius: '5px' }} />
+*With nothing added yet, the list column reads **No connectors yet** and the pane beside it offers **Add your first connector***
+
+You can also get here from inside a conversation. The chat input's **+** menu has a **Connectors** submenu ending in **Manage connectors**, and the Customize panel has a **Connectors** section of its own with an **Add connector** button.
 
 ## Name it and point it at the server
 

src/pages/docs/falcon-ai/guides/create-skill.mdx

@@ -9,7 +9,10 @@ A skill packages a multi-step Falcon AI workflow into a slash command that anyon
 
 Skills are built from Falcon AI's full page view; see [Chat with Falcon AI](/docs/falcon-ai/guides/chat-with-falcon-ai) if you haven't opened it yet. For what a skill is, see [Skills](/docs/falcon-ai/concepts/skills).
 
-Click **Customize** in the left rail of the Falcon AI full page to open the Customize panel, then pick **Skills** from its nav to see the skills available in your workspace, with a search field for finding one by name. Click **Create Skill** at the bottom of that list to open the editor for a brand new skill.
+Click **Customize** in the left rail of the Falcon AI full page to open the Customize panel. It opens on **Skills**, its other nav entry being Connectors, and lists the skills available in your workspace with a search field for finding one by name. Click **Create Skill** at the bottom of that list to open the editor for a brand new skill.
+
+<img src="/images/docs/falcon-ai/guides/create-skill.png" alt="The Customize panel with Skills selected in its nav, the workspace skills listed in the next column each tagged SYS, and Create Skill at the bottom of that column" style={{ borderRadius: '5px' }} />
+*The **SYS** tag marks a skill that shipped with Falcon AI, so this workspace has no custom ones yet*
 
 <Tip>
 Already mid-conversation? The Skills menu in the chat header also has a **Create Skill** entry, so you can build a skill without leaving the chat. It's a separate dialog rather than the Customize editor: it adds an **Icon** field, which takes an MDI icon name such as `mdi:bug` and sets the icon shown against the skill in the Skills list and picker, and its button reads **Create** on a new skill instead of **Save**.

src/pages/docs/falcon-ai/guides/manage-conversations.mdx

@@ -21,16 +21,16 @@ Hover over a conversation in the left rail to reveal its row menu, a **⋯** ico
 
 Click it and choose **Rename** to type the new name in the **Rename conversation** prompt, or choose **Delete** to remove the conversation.
 
-<img src="/images/docs/falcon-ai/guides/manage-conversations/row-menu.png" alt="A conversation row in the left rail with its dots menu open, showing Rename and Delete" style={{ borderRadius: '5px' }} />
-*Rename and Delete share the same row menu*
+<img src="/images/docs/falcon-ai/guides/manage-conversations/row-menu.png" alt="A conversation row in the left rail with its row menu open, showing Rename above Delete in red" style={{ borderRadius: '5px' }} />
+*Rename and Delete share the same row menu, and Delete is the red one*
 
 <Warning>
 Delete has no confirmation step: the conversation disappears from your list as soon as you click it, so make sure it's the right row before you choose it. Deleting the conversation you currently have open drops you back to a new, empty chat.
 </Warning>
 
 ## Titles and dropped connections
 
-Falcon AI generates a conversation's title at the end of your first turn, so a thread still labeled "New conversation" hasn't gotten a reply yet. If your connection drops while Falcon AI is answering, it replays whatever you missed on its own once the connection comes back.
+A conversation takes its title from your first message, truncated to fit the rail, and it lands there as soon as you send. That's why the rail reads back as a list of questions rather than summaries, and why renaming is worth doing on any thread you expect to come back to. If your connection drops while Falcon AI is answering, it replays whatever you missed on its own once the connection comes back.
 
 ## Dive deeper
 

src/pages/docs/protect/guides/test-a-guardrail.mdx

@@ -27,6 +27,9 @@ Below the prompt box, "Model (optional)" takes a model name, with placeholder te
 
 Press **Run Test**. It stays disabled until there's a prompt in the box, whether you typed one or picked a chip, and while a test is in flight it reads "Running...".
 
+<img src="/images/docs/protect/guides/test-a-guardrail.png" alt="The Test Guardrails panel with the PII test chip selected, its prompt filled into the box, the optional Model field, and the Run Test button" style={{ borderRadius: '5px' }} />
+*The **PII test** chip fills the box for you, so Run Test is live without typing anything*
+
 ## Read the result
 
 When the test finishes, a result chip reports the outcome: "BLOCKED (446)" if a guardrail stopped the request, "WARNING (246)" if a guardrail flagged it without stopping it, or "OK" with the status code the call actually returned if it passed cleanly. See [Guardrail checks](/docs/protect/reference/guardrail-checks#response-statuses) for the status each action produces. For the PII test walkthrough above, expect "BLOCKED (446)".