Documentation edits made through Mintlify web editor

Author: ethanpalm

guides/assistant.mdx

@@ -27,17 +27,30 @@ There are two ways to access the assistant in your documentation:
 - **Select the assistant button** next to the search bar.
 
   <Frame>
-    <img src="/images/assistant/assistant-button-light.png" className="block dark:hidden" alt="Search bar and assistant button in light mode."/>
-    <img src="/images/assistant/assistant-button-dark.png" className="block light:hidden" alt="Search bar and assistant button in dark mode."/>
+    <img
+      src="/images/assistant/assistant-button-light.png"
+      className="block dark:hidden"
+      alt="Search bar and assistant button in light mode."
+    />
+
+    <img
+      src="/images/assistant/assistant-button-dark.png"
+      className="hidden dark:block"
+      alt="Search bar and assistant button in dark mode."
+    />
   </Frame>
 
+Both options open the assistant in the right side panel.
+
+Ask any questions and the assistant will search your docs for an answer. If the assistant cannot find an answer in your documentation, it will respond that it cannot answer the question.
+
 ## Making content AI ingestible
 
 To help the assistant provide accurate answers, structure your documentation with both human readers and AI tools in mind. Well-organized, thorough content makes it easier for the assistant to understand your documentation and deliver relevant responses to users.
 
 ### Structure and organization
 
-- Write descriptive headings that indicate what setions are about.
+- Write descriptive headings for sections.
 - Create a logical information hierarchy with proper nesting (H1 \> H2 \> H3).
 - Break up long blocks of text into shorter paragraphs.
 - Use consistent formatting across your docs.
@@ -51,12 +64,45 @@ To help the assistant provide accurate answers, structure your documentation wit
 
 ### AI optimization
 
-- Add hidden pages with additional context  that users don't need, but the assistant can reference.
+- Add hidden pages with additional context that users don't need, but the assistant can reference.
 - Use semantic markup.
-- Include comprehensive metadata in pages' frontmatter.
+- Include comprehensive metadata in page frontmatter.
 
 ## Exporting queries
 
-How to and what to do with the information
+You can review and export queries from your dashboard. Some ways that analyzing queries can help you improve your documentation:
+
+- Identify content gaps for any queries that are frequent, but have insufficient responses or sources.
+- Conduct lightweight user research by looking for themes and patterns in queries.
+- See which pages are used as sources and prioritize them for accuracy and quality.
+
+You can explore queries from your [dashboard](https://dashboard.mintlify.com/products/assistant), but to get more powerful insights we recommend exporting a `CSV` file of your queries, responses, and sources to analyze with your preferred AI tool.
+
+1. Navigate to the [assistant page](https://dashboard.mintlify.com/products/assistant) in your dashboard.
+2. Select **Export to CSV**.
+3. Upload the queries into your AI tool and ask questions to learn about how your users are engaging with your docs. Some prompts to get you started:
+
+- Summarize the most common themes of the queries.
+- List any queries that had no sources cited.
+
+## Changing the model
+
+The assistant uses Claude Sonnet 4 by default. We have found that this model performs the best when searching and answering questions.
+
+If you want to select another model:
+
+1. Navigate to the [assistant page](https://dashboard.mintlify.com/products/assistant) in your dashboard.
+2. Select **Manage**.
+3. Choose your preferred model.
+4. Select **Save**.
+
+Available models:
 
-## Changing the model
+- Claude 4 Sonnet (default)
+- Claude 3.7 Sonnet
+- GPT 4.1
+- GPT-4o
+- o3-mini
+- Gemini 2.5 Pro (Preview)
+- Llama 4 Maverick
+- Grok 3