diff --git a/ai/assistant.mdx b/ai/assistant.mdx index 27ec978a2..27b592571 100644 --- a/ai/assistant.mdx +++ b/ai/assistant.mdx @@ -101,6 +101,21 @@ You can add up to three starter questions. Click **Ask AI** for recommended ques The search suggestions panel in the dashboard with contextual starter questions enabled. +### Bot protection + +In the Bot Protection section, enable invisible captcha to protect your assistant from automated abuse. The captcha uses [hCaptcha](https://www.hcaptcha.com/privacy), which is privacy-friendly and invisible to nearly all visitors. + +To enable bot protection: + +1. Go to the [Assistant settings](https://dashboard.mintlify.com/products/assistant/settings) page in your dashboard. +2. In the **Bot Protection** section, toggle **Invisible Captcha** on. + +Changes take up to 10 minutes to propagate. + + + If you use custom [Content Security Policy headers](/deploy/csp-configuration), make sure `hcaptcha.com` and `*.hcaptcha.com` are included in your allowlist. + + ## Customize assistant behavior Add a `.mintlify/Assistant.md` file at the root of your documentation project to give the assistant custom instructions that shape how it responds (`Assistant.md` is also an accepted filename). The assistant uses these instructions as system-level context for every response.