mintlify · ethanpalm · Jul 9, 2025
diff --git a/guides/assistant.mdx b/guides/assistant.mdx
@@ -12,7 +12,7 @@

 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 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.
@@ -28,7 +28,7 @@

 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"
@@ -51,7 +51,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.

@@ -60,7 +60,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>

@@ -91,191 +91,3 @@
   - List any queries that had no sources cited.
   - Find patterns in unsuccessful interactions.
 </Card>
-
-## 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:
-
-<Columns cols={2}>
-  <Card
-    title="Claude 4 Sonnet"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        className="h-6 w-6"
-        width="400"
-        height="400"
-        viewBox="0 0 400 400"
-        fill="none"
-      >
-        <path
-          d="M124.011 241.251L173.175 213.666L174.001 211.27L173.175 209.937H170.779L162.562 209.431L134.472 208.672L110.109 207.66L86.5063 206.394L80.5676 205.129L75 197.79L75.5736 194.129L80.5676 190.771L87.721 191.396L103.529 192.475L127.251 194.112L144.459 195.124L169.952 197.773H174.001L174.575 196.136L173.191 195.124L172.112 194.112L147.564 177.477L120.991 159.897L107.072 149.774L99.5479 144.645L95.7518 139.837L94.1153 129.343L100.948 121.818L110.126 122.442L112.471 123.067L121.767 130.22L141.625 145.59L167.556 164.688L171.352 167.843L172.871 166.763L173.056 166.004L171.352 163.153L157.248 137.66L142.199 111.729L135.501 100.982L133.729 94.5371C133.105 91.8882 132.649 89.6612 132.649 86.9449L140.427 76.3835L144.729 75L155.105 76.3835L159.475 80.1795L165.92 94.9251L176.363 118.14L192.56 149.706L197.301 159.07L199.831 167.742L200.776 170.391H202.413V168.872L203.745 151.09L206.209 129.258L208.604 101.167L209.431 93.2548L213.345 83.7731L221.123 78.6442L227.197 81.5461L232.191 88.6995L231.499 93.3223L228.53 112.623L222.709 142.857L218.913 163.102H221.123L223.654 160.572L233.895 146.973L251.103 125.462L258.696 116.925L267.553 107.494L273.239 103.006H283.986L291.898 114.766L288.355 126.913L277.288 140.95L268.11 152.845L254.95 170.559L246.734 184.731L247.493 185.862L249.45 185.676L279.177 179.349L295.239 176.448L314.405 173.158L323.077 177.207L324.021 181.323L320.613 189.742L300.115 194.804L276.073 199.612L240.272 208.081L239.833 208.402L240.339 209.026L256.469 210.545L263.369 210.916H280.257L311.705 213.261L319.922 218.694L324.848 225.341L324.021 230.402L311.368 236.847L294.294 232.798L254.444 223.316L240.778 219.908H238.889V221.039L250.277 232.174L271.147 251.019L297.28 275.314L298.613 281.32L295.256 286.061L291.713 285.555L268.751 268.278L259.893 260.501L239.833 243.613H238.5V245.384L243.123 252.149L267.536 288.845L268.801 300.098L267.03 303.759L260.703 305.969L253.752 304.704L239.462 284.644L224.717 262.053L212.822 241.807L211.371 242.634L204.353 318.235L201.063 322.098L193.471 325L187.144 320.192L183.787 312.414L187.144 297.044L191.193 276.984L194.483 261.041L197.452 241.234L199.224 234.654L199.106 234.215L197.655 234.401L182.724 254.899L160.015 285.588L142.047 304.822L137.745 306.526L130.287 302.662L130.979 295.762L135.146 289.621L160.015 257.987L175.014 238.382L184.698 227.062L184.63 225.425H184.057L118.005 268.312L106.246 269.831L101.184 265.09L101.809 257.312L104.204 254.781L124.062 241.116L123.994 241.183L124.011 241.251Z"
-          fill="#D97757"
-        />
-      </svg>
-    }
-  />
-  <Card
-    title="Claude 3.7 Sonnet"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        className="h-6 w-6"
-        width="400"
-        height="400"
-        viewBox="0 0 400 400"
-        fill="none"
-      >
-        <path
-          d="M124.011 241.251L173.175 213.666L174.001 211.27L173.175 209.937H170.779L162.562 209.431L134.472 208.672L110.109 207.66L86.5063 206.394L80.5676 205.129L75 197.79L75.5736 194.129L80.5676 190.771L87.721 191.396L103.529 192.475L127.251 194.112L144.459 195.124L169.952 197.773H174.001L174.575 196.136L173.191 195.124L172.112 194.112L147.564 177.477L120.991 159.897L107.072 149.774L99.5479 144.645L95.7518 139.837L94.1153 129.343L100.948 121.818L110.126 122.442L112.471 123.067L121.767 130.22L141.625 145.59L167.556 164.688L171.352 167.843L172.871 166.763L173.056 166.004L171.352 163.153L157.248 137.66L142.199 111.729L135.501 100.982L133.729 94.5371C133.105 91.8882 132.649 89.6612 132.649 86.9449L140.427 76.3835L144.729 75L155.105 76.3835L159.475 80.1795L165.92 94.9251L176.363 118.14L192.56 149.706L197.301 159.07L199.831 167.742L200.776 170.391H202.413V168.872L203.745 151.09L206.209 129.258L208.604 101.167L209.431 93.2548L213.345 83.7731L221.123 78.6442L227.197 81.5461L232.191 88.6995L231.499 93.3223L228.53 112.623L222.709 142.857L218.913 163.102H221.123L223.654 160.572L233.895 146.973L251.103 125.462L258.696 116.925L267.553 107.494L273.239 103.006H283.986L291.898 114.766L288.355 126.913L277.288 140.95L268.11 152.845L254.95 170.559L246.734 184.731L247.493 185.862L249.45 185.676L279.177 179.349L295.239 176.448L314.405 173.158L323.077 177.207L324.021 181.323L320.613 189.742L300.115 194.804L276.073 199.612L240.272 208.081L239.833 208.402L240.339 209.026L256.469 210.545L263.369 210.916H280.257L311.705 213.261L319.922 218.694L324.848 225.341L324.021 230.402L311.368 236.847L294.294 232.798L254.444 223.316L240.778 219.908H238.889V221.039L250.277 232.174L271.147 251.019L297.28 275.314L298.613 281.32L295.256 286.061L291.713 285.555L268.751 268.278L259.893 260.501L239.833 243.613H238.5V245.384L243.123 252.149L267.536 288.845L268.801 300.098L267.03 303.759L260.703 305.969L253.752 304.704L239.462 284.644L224.717 262.053L212.822 241.807L211.371 242.634L204.353 318.235L201.063 322.098L193.471 325L187.144 320.192L183.787 312.414L187.144 297.044L191.193 276.984L194.483 261.041L197.452 241.234L199.224 234.654L199.106 234.215L197.655 234.401L182.724 254.899L160.015 285.588L142.047 304.822L137.745 306.526L130.287 302.662L130.979 295.762L135.146 289.621L160.015 257.987L175.014 238.382L184.698 227.062L184.63 225.425H184.057L118.005 268.312L106.246 269.831L101.184 265.09L101.809 257.312L104.204 254.781L124.062 241.116L123.994 241.183L124.011 241.251Z"
-          fill="#D97757"
-        />
-      </svg>
-    }
-  />
-  <Card
-    title="GPT 4.1"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 400 400"
-        width="24"
-        height="24"
-        className="h-6 w-6"
-      >
-        <path d="M294.93 130.971a79.712 79.712 0 00-6.85-65.48c-17.46-30.4-52.56-46.04-86.84-38.68A79.747 79.747 0 00141.11.001c-35.04-.08-66.13 22.48-76.91 55.82a79.754 79.754 0 00-53.31 38.67c-17.59 30.32-13.58 68.54 9.92 94.54a79.712 79.712 0 006.85 65.48c17.46 30.4 52.56 46.04 86.84 38.68a79.687 79.687 0 0060.13 26.8c35.06.09 66.16-22.49 76.94-55.86a79.754 79.754 0 0053.31-38.67c17.57-30.32 13.55-68.51-9.94-94.51zm-120.28 168.11a59.77 59.77 0 01-38.39-13.88c.49-.26 1.34-.73 1.89-1.07l63.72-36.8a10.36 10.36 0 005.24-9.07v-89.83l26.93 15.55c.29.14.48.42.52.74v74.39c-.04 33.08-26.83 59.9-59.91 59.97zm-128.84-55.03a59.71 59.71 0 01-7.15-40.18c.47.28 1.3.79 1.89 1.13l63.72 36.8c3.23 1.89 7.23 1.89 10.47 0l77.79-44.92v31.1c.02.32-.13.63-.38.83l-64.41 37.19c-28.69 16.52-65.33 6.7-81.92-21.95zm-16.77-139.09c7-12.16 18.05-21.46 31.21-26.29 0 .55-.03 1.52-.03 2.2v73.61c-.02 3.74 1.98 7.21 5.23 9.06l77.79 44.91-26.93 15.55c-.27.18-.61.21-.91.08l-64.42-37.22c-28.63-16.58-38.45-53.21-21.95-81.89zm221.26 51.49l-77.79-44.92 26.93-15.54c.27-.18.61-.21.91-.08l64.42 37.19c28.68 16.57 38.51 53.26 21.94 81.94a59.94 59.94 0 01-31.2 26.28v-75.81c.03-3.74-1.96-7.2-5.2-9.06zm26.8-40.34c-.47-.29-1.3-.79-1.89-1.13l-63.72-36.8a10.375 10.375 0 00-10.47 0l-77.79 44.92v-31.1c-.02-.32.13-.63.38-.83l64.41-37.16c28.69-16.55 65.37-6.7 81.91 22a59.95 59.95 0 017.15 40.1zm-168.51 55.43l-26.94-15.55a.943.943 0 01-.52-.74v-74.39c.02-33.12 26.89-59.96 60.01-59.94 14.01 0 27.57 4.92 38.34 13.88-.49.26-1.33.73-1.89 1.07l-63.72 36.8a10.344 10.344 0 00-5.24 9.06l-.04 89.79zm14.63-31.54l34.65-20.01 34.65 20v40.01l-34.65 20-34.65-20z"/>
-      </svg>
-    }
-  />
-  <Card
-    title="GPT-4o"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 400 400"
-        width="24"
-        height="24"
-        className="h-6 w-6"
-      >
-        <path d="M294.93 130.971a79.712 79.712 0 00-6.85-65.48c-17.46-30.4-52.56-46.04-86.84-38.68A79.747 79.747 0 00141.11.001c-35.04-.08-66.13 22.48-76.91 55.82a79.754 79.754 0 00-53.31 38.67c-17.59 30.32-13.58 68.54 9.92 94.54a79.712 79.712 0 006.85 65.48c17.46 30.4 52.56 46.04 86.84 38.68a79.687 79.687 0 0060.13 26.8c35.06.09 66.16-22.49 76.94-55.86a79.754 79.754 0 0053.31-38.67c17.57-30.32 13.55-68.51-9.94-94.51zm-120.28 168.11a59.77 59.77 0 01-38.39-13.88c.49-.26 1.34-.73 1.89-1.07l63.72-36.8a10.36 10.36 0 005.24-9.07v-89.83l26.93 15.55c.29.14.48.42.52.74v74.39c-.04 33.08-26.83 59.9-59.91 59.97zm-128.84-55.03a59.71 59.71 0 01-7.15-40.18c.47.28 1.3.79 1.89 1.13l63.72 36.8c3.23 1.89 7.23 1.89 10.47 0l77.79-44.92v31.1c.02.32-.13.63-.38.83l-64.41 37.19c-28.69 16.52-65.33 6.7-81.92-21.95zm-16.77-139.09c7-12.16 18.05-21.46 31.21-26.29 0 .55-.03 1.52-.03 2.2v73.61c-.02 3.74 1.98 7.21 5.23 9.06l77.79 44.91-26.93 15.55c-.27.18-.61.21-.91.08l-64.42-37.22c-28.63-16.58-38.45-53.21-21.95-81.89zm221.26 51.49l-77.79-44.92 26.93-15.54c.27-.18.61-.21.91-.08l64.42 37.19c28.68 16.57 38.51 53.26 21.94 81.94a59.94 59.94 0 01-31.2 26.28v-75.81c.03-3.74-1.96-7.2-5.2-9.06zm26.8-40.34c-.47-.29-1.3-.79-1.89-1.13l-63.72-36.8a10.375 10.375 0 00-10.47 0l-77.79 44.92v-31.1c-.02-.32.13-.63.38-.83l64.41-37.16c28.69-16.55 65.37-6.7 81.91 22a59.95 59.95 0 017.15 40.1zm-168.51 55.43l-26.94-15.55a.943.943 0 01-.52-.74v-74.39c.02-33.12 26.89-59.96 60.01-59.94 14.01 0 27.57 4.92 38.34 13.88-.49.26-1.33.73-1.89 1.07l-63.72 36.8a10.344 10.344 0 00-5.24 9.06l-.04 89.79zm14.63-31.54l34.65-20.01 34.65 20v40.01l-34.65 20-34.65-20z"/>
-      </svg>
-    }
-  />
-  <Card
-    title="o3-mini"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 400 400"
-        width="24"
-        height="24"
-        className="h-6 w-6"
-      >
-        <path d="M294.93 130.971a79.712 79.712 0 00-6.85-65.48c-17.46-30.4-52.56-46.04-86.84-38.68A79.747 79.747 0 00141.11.001c-35.04-.08-66.13 22.48-76.91 55.82a79.754 79.754 0 00-53.31 38.67c-17.59 30.32-13.58 68.54 9.92 94.54a79.712 79.712 0 006.85 65.48c17.46 30.4 52.56 46.04 86.84 38.68a79.687 79.687 0 0060.13 26.8c35.06.09 66.16-22.49 76.94-55.86a79.754 79.754 0 0053.31-38.67c17.57-30.32 13.55-68.51-9.94-94.51zm-120.28 168.11a59.77 59.77 0 01-38.39-13.88c.49-.26 1.34-.73 1.89-1.07l63.72-36.8a10.36 10.36 0 005.24-9.07v-89.83l26.93 15.55c.29.14.48.42.52.74v74.39c-.04 33.08-26.83 59.9-59.91 59.97zm-128.84-55.03a59.71 59.71 0 01-7.15-40.18c.47.28 1.3.79 1.89 1.13l63.72 36.8c3.23 1.89 7.23 1.89 10.47 0l77.79-44.92v31.1c.02.32-.13.63-.38.83l-64.41 37.19c-28.69 16.52-65.33 6.7-81.92-21.95zm-16.77-139.09c7-12.16 18.05-21.46 31.21-26.29 0 .55-.03 1.52-.03 2.2v73.61c-.02 3.74 1.98 7.21 5.23 9.06l77.79 44.91-26.93 15.55c-.27.18-.61.21-.91.08l-64.42-37.22c-28.63-16.58-38.45-53.21-21.95-81.89zm221.26 51.49l-77.79-44.92 26.93-15.54c.27-.18.61-.21.91-.08l64.42 37.19c28.68 16.57 38.51 53.26 21.94 81.94a59.94 59.94 0 01-31.2 26.28v-75.81c.03-3.74-1.96-7.2-5.2-9.06zm26.8-40.34c-.47-.29-1.3-.79-1.89-1.13l-63.72-36.8a10.375 10.375 0 00-10.47 0l-77.79 44.92v-31.1c-.02-.32.13-.63.38-.83l64.41-37.16c28.69-16.55 65.37-6.7 81.91 22a59.95 59.95 0 017.15 40.1zm-168.51 55.43l-26.94-15.55a.943.943 0 01-.52-.74v-74.39c.02-33.12 26.89-59.96 60.01-59.94 14.01 0 27.57 4.92 38.34 13.88-.49.26-1.33.73-1.89 1.07l-63.72 36.8a10.344 10.344 0 00-5.24 9.06l-.04 89.79zm14.63-31.54l34.65-20.01 34.65 20v40.01l-34.65 20-34.65-20z"/>
-      </svg>
-    }
-  />
-  <Card
-    title="Gemini 2.5 Pro (Preview)"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        viewBox="0 0 90 90"
-        width="24"
-        height="24"
-        className="h-6 w-6"
-      >
-        <defs>
-          <linearGradient id="gemini25pro-gradient" x1="60.0525" y1="33.3396" x2="34.8444" y2="52.867" gradientUnits="userSpaceOnUse">
-            <stop offset="0%" stopColor="#9168C0" />
-            <stop offset="34.3%" stopColor="#5684D1" />
-            <stop offset="67.2%" stopColor="#1BA1E3" />
-          </linearGradient>
-        </defs>
-        <path
-          d="M90 45.09C65.838 46.573 46.573 65.838 45.09 90h-.18C43.43 65.837 24.163 46.57 0 45.09v-.18C24.163 43.43 43.43 24.163 44.91 0h.18C46.573 24.162 65.838 43.427 90 44.91V45.09z"
-          fill="url(#gemini25pro-gradient)"
-        />
-      </svg>
-    }
-  />
-  <Card
-    title="Llama 4 Maverick"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        xmlnsXlink="http://www.w3.org/1999/xlink"
-        width="24"
-        height="16"
-        viewBox="0 0 287.56 191"
-        className="h-6 w-6"
-      >
-        <defs>
-          <linearGradient id="Grad_Logo1" x1="61" y1="117" x2="259" y2="127" gradientUnits="userSpaceOnUse">
-            <stop style={{ stopColor: "#0064e1" }} offset="0" />
-            <stop style={{ stopColor: "#0064e1" }} offset="0.4" />
-            <stop style={{ stopColor: "#0073ee" }} offset="0.83" />
-            <stop style={{ stopColor: "#0082fb" }} offset="1" />
-          </linearGradient>
-          <linearGradient id="Grad_Logo2" x1="45" y1="139" x2="45" y2="66" gradientUnits="userSpaceOnUse">
-            <stop style={{ stopColor: "#0082fb" }} offset="0" />
-            <stop style={{ stopColor: "#0064e0" }} offset="1" />
-          </linearGradient>
-        </defs>
-        <path
-          style={{ fill: "#0081fb" }}
-          d="m31.06,125.96c0,10.98 2.41,19.41 5.56,24.51 4.13,6.68 10.29,9.51 16.57,9.51 8.1,0 15.51-2.01 29.79-21.76 11.44-15.83 24.92-38.05 33.99-51.98l15.36-23.6c10.67-16.39 23.02-34.61 37.18-46.96 11.56-10.08 24.03-15.68 36.58-15.68 21.07,0 41.14,12.21 56.5,35.11 16.81,25.08 24.97,56.67 24.97,89.27 0,19.38-3.82,33.62-10.32,44.87-6.28,10.88-18.52,21.75-39.11,21.75l0-31.02c17.63,0 22.03-16.2 22.03-34.74 0-26.42-6.16-55.74-19.73-76.69-9.63-14.86-22.11-23.94-35.84-23.94-14.85,0-26.8,11.2-40.23,31.17-7.14,10.61-14.47,23.54-22.7,38.13l-9.06,16.05c-18.2,32.27-22.81,39.62-31.91,51.75-15.95,21.24-29.57,29.29-47.5,29.29-21.27,0-34.72-9.21-43.05-23.09-6.8-11.31-10.14-26.15-10.14-43.06z"
-        />
-        <path
-          style={{ fill: "url(#Grad_Logo1)" }}
-          d="m24.49,37.3c14.24-21.95 34.79-37.3 58.36-37.3 13.65,0 27.22,4.04 41.39,15.61 15.5,12.65 32.02,33.48 52.63,67.81l7.39,12.32c17.84,29.72 27.99,45.01 33.93,52.22 7.64,9.26 12.99,12.02 19.94,12.02 17.63,0 22.03-16.2 22.03-34.74l27.4-.86c0,19.38-3.82,33.62-10.32,44.87-6.28,10.88-18.52,21.75-39.11,21.75-12.8,0-24.14-2.78-36.68-14.61-9.64-9.08-20.91-25.21-29.58-39.71l-25.79-43.08c-12.94-21.62-24.81-37.74-31.68-45.04-7.39-7.85-16.89-17.33-32.05-17.33-12.27,0-22.69,8.61-31.41,21.78z"
-        />
-        <path
-          style={{ fill: "url(#Grad_Logo2)" }}
-          d="m82.35,31.23c-12.27,0-22.69,8.61-31.41,21.78-12.33,18.61-19.88,46.33-19.88,72.95 0,10.98 2.41,19.41 5.56,24.51l-26.48,17.44c-6.8-11.31-10.14-26.15-10.14-43.06 0-30.75 8.44-62.8 24.49-87.55 14.24-21.95 34.79-37.3 58.36-37.3z"
-        />
-      </svg>
-    }
-  />
-  <Card
-    title="Grok 3"
-    horizontal
-    icon={
-      <svg
-        xmlns="http://www.w3.org/2000/svg"
-        width="34"
-        height="33"
-        viewBox="0 0 34 33"
-        fill="none"
-        className="h-6 w-6"
-      >
-        <path
-          d="M13.2371 21.0407L24.3186 12.8506C24.8619 12.4491 25.6384 12.6057 25.8973 13.2294C27.2597 16.5185 26.651 20.4712 23.9403 23.1851C21.2297 25.8989 17.4581 26.4941 14.0108 25.1386L10.2449 26.8843C15.6463 30.5806 22.2053 29.6665 26.304 25.5601C29.5551 22.3051 30.562 17.8683 29.6205 13.8673L29.629 13.8758C28.2637 7.99809 29.9647 5.64871 33.449 0.844576C33.5314 0.730667 33.6139 0.616757 33.6964 0.5L29.1113 5.09055V5.07631L13.2343 21.0436"
-          fill="currentColor"
-          id="mark"
-        />
-        <path
-          d="M10.9503 23.0313C7.07343 19.3235 7.74185 13.5853 11.0498 10.2763C13.4959 7.82722 17.5036 6.82767 21.0021 8.2971L24.7595 6.55998C24.0826 6.07017 23.215 5.54334 22.2195 5.17313C17.7198 3.31926 12.3326 4.24192 8.67479 7.90126C5.15635 11.4239 4.0499 16.8403 5.94992 21.4622C7.36924 24.9165 5.04257 27.3598 2.69884 29.826C1.86829 30.7002 1.0349 31.5745 0.36364 32.5L10.9474 23.0341"
-          fill="currentColor"
-          id="mark"
-        />
-      </svg>
-    }
-  />
-</Columns>