Assistant updates

guides/assistant.mdx

@@ -5,24 +5,32 @@
 ---
 
 <Info>
-  The AI assistant is available on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant).
+  The AI assistant is automatically enabled on [Pro, Growth, and Enterprise plans](https://mintlify.com/pricing?ref=assistant).
 </Info>
 
 ## About the assistant
 
-The assistant answers questions about your documentation through natural language queries. When users ask a question, the assistant searches your content, cites relevant sources, and provides contextual answers sourced from your documentation.
+The assistant answers questions about your documentation through natural language queries. It is embedded directly in your documentation site, providing users with immediate access to contextual help.
 
-The assistant uses agentic RAG (retrieval-augmented generation) with tool calling and runs on Claude Sonnet 4 by default.
+The assistant uses agentic RAG (retrieval-augmented generation) with tool calling powered by Claude Sonnet 4. When users ask questions, the assistant:
 
-You can monitor user interactions and export query data from your dashboard to gain insights into user needs and identify content gaps.
+* **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.
 
-The assistant is automatically enabled for accounts on Pro, Growth, and Enterprise plans. See [Pricing](https://mintlify.com/pricing) for details.
+You can monitor assistant usage through your dashboard to understand user behavior and documentation effectiveness. Query data and interaction patterns can 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.
+
+Export query data to analyze trends and prioritize documentation improvements based on real user needs.
 
 ## Using the assistant
 
 Users can access the assistant in two ways:
 
 - **Keyboard shortcut**: <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"
@@ -45,7 +53,7 @@
 
 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.
 
 ## Making content AI ingestible
 
 Structure your documentation to help the assistant provide accurate, relevant answers. Clear organization and comprehensive context benefit both human readers and AI understanding.
 
@@ -54,7 +62,7 @@
   - Write descriptive headings for sections.
   - Create a logical information hierarchy.
   - Use consistent formatting across your docs.
   - Include comprehensive metadata in page frontmatter.
   - Break up long blocks of text into shorter paragraphs.
 </Card>