Documentation edits made through Mintlify web editor

Author: tiffany-mintlify

guides/assistant.mdx

@@ -14,17 +14,17 @@ The assistant answers questions about your documentation through natural languag
 
 The assistant uses agentic RAG (retrieval-augmented generation) with tool calling powered by Claude Sonnet 4. When users ask questions, the assistant:
 
-* **Searches and retrieves** relevant content from your documentation to provide accurate answers.
-* **Cites sources** and provides navigable links to take users directly to referenced pages.
-* **Generates copyable code examples** to help users implement solutions from your documentation.
+- **Searches and retrieves** relevant content from your documentation to provide accurate answers.
+- **Cites sources** and provides navigable links to take users directly to referenced pages.
+- **Generates copyable code examples** to help users implement solutions from your documentation.
 
 Each message sent to the assistant counts toward your plan's message allowance. If you exceed your allowance, additional messages incur overage charges. You can set spending limits or disable the assistant if you reach your message allowance.
 
 You can view assistant usage through your dashboard to understand user behavior and documentation effectiveness. Export and analyze query data to help identify:
 
-* Frequently asked questions that might need better coverage.
-* Content gaps where users struggle to find answers.
-* Popular topics that could benefit from additional content.
+- Frequently asked questions that might need better coverage.
+- Content gaps where users struggle to find answers.
+- Popular topics that could benefit from additional content.
 
 ## Configuring the assistant
 
@@ -34,15 +34,15 @@ The assistant is enabled by default for Pro and Custom plans. You can manage the
 
 Toggle the assistant status to enable or disable the assistant for your documentation site.
 
-### Response handling
+### Response customization
 
-Configure how the assistant responds when it cannot find answers in your documentation. You can redirect unanswered questions to your support team and enable the assistant to search external websites.
+When the assistant cannot find answers in your documentation, you can surface your support team email to redirect users. 
 
-- **Assistant Deflection**: When enabled, the assistant directs users to your support team for questions that it cannot answer.
-- **Search Sites**: The assistant can search specified external sites for additional context when answering questions.
-  <Note>
-    Site search is in beta. To enable it for your documentation site, [contact our sales team](mailto:[email protected]). 
-  </Note>
+To provide additional context when answering questions, you can enable the assistant to search external sites such as your blog, pricing page, or partner integration docs.
+
+<Info>
+  Site search is in beta. To enable it for your documentation site, [contact our sales team](mailto:[email protected]).
+</Info>
 
 ### Spend limit
 
@@ -56,27 +56,33 @@ You can also set usage alerts to receive an email when you reach a certain perce
 
 Users can access the assistant in three ways:
 
-- **Keyboard shortcuts**: <kbd>?</kbd> or <kbd>Command</kbd> + <kbd>I</kbd> (<kbd>Ctrl</kbd> + <kbd>I</kbd> on Windows)
+- **Keyboard shortcuts**: <kbd>?</kbd>
+
+   or <kbd>Command</kbd>
+
+   \+ <kbd>I</kbd>
+
+   (<kbd>Ctrl</kbd>
+
+   \+ <kbd>I</kbd>
+
+   on Windows)
 - **Assistant button** next to the search bar
+
   <img
     src="/images/assistant/assistant-button-light.png"
     className="block dark:hidden rounded-2xl border border-gray-100 shadow-lg"
-    style={{
-      width: '268px',
-      height: 'auto',
-    }}
+    style={{ width:"268px",height:"auto" }}
     alt="Search bar and assistant button in light mode."
   />
+
   <img
     src="/images/assistant/assistant-button-dark.png"
     className="hidden dark:block rounded-2xl border border-white/10 shadow-lg"
-    style={{
-      width: '268px',
-      height: 'auto',
-    }}
+    style={{ width:"268px",height:"auto" }}
     alt="Search bar and assistant button in dark mode."
   />
-- **URLs** with `?assistant=open` appended will open the assistant when the page loads. For example, [https://mintlify.com/docs?assistant=open](https://mintlify.com/docs?assistant=open).
+- **URLs** with `?assistant=open` appended will open the assistant when the page loads. For example, https://mintlify.com/docs?assistant=open.
 
 Both methods open a chat panel on the right side of your docs. Users can ask any question and the assistant will search your documentation for an answer. If no relevant information is found, the assistant will respond that it cannot answer the question.
 
@@ -119,4 +125,4 @@ You can explore queries from your [dashboard](https://dashboard.mintlify.com/pro
   - Summarize the most common themes of the queries.
   - List any queries that had no sources cited.
   - Find patterns in unsuccessful interactions.
-</Card>
+</Card>