|
| 1 | +--- |
| 2 | +title: "AI-native" |
| 3 | +description: "Learn how AI enhances reading, writing, and discovering your documentation" |
| 4 | +--- |
| 5 | + |
| 6 | +When you host your documentation on Mintlify, built-in AI features help your users find answers and your team maintain content more efficiently. Your content provides the context for these AI-native features to improve the experiences of reading, writing, and discovering your documentation. |
| 7 | + |
| 8 | +## What makes your documentation AI-native |
| 9 | + |
| 10 | +### Reading |
| 11 | + |
| 12 | +In addition to reading individual pages, users can chat with the [assistant](/ai/assistant) in your documentation for immediate answers to their questions and links to relevant content. The assistant helps guide users through your product with accurate information from your documentation. Embed the assistant into custom apps with the [API](api-reference/assistant/create-assistant-message) to extend where users can access your documentation. |
| 13 | + |
| 14 | +### Writing |
| 15 | + |
| 16 | +The [agent](/ai/agent) helps you write and maintain documentation. It creates pull requests with proposed changes based on your prompts, pull requests, and Slack threads. Add the agent to your Slack workspace so that anyone on your team can help maintain your documentation by chatting with the agent. Or embed the agent into custom apps via the [API](/api-reference/agent/create-agent-job). |
| 17 | + |
| 18 | +Configure popular tools like [Cursor](/guides/cursor), [Claude Code](/guides/claude-code), and [Windsurf](/guides/windsurf) to reference the Mintlify schema, your style guide, and best practices. |
| 19 | + |
| 20 | +### Discovering |
| 21 | + |
| 22 | +Your site is automatically optimized for AI tools and search engines to help users discover your documentation. All pages are sent as Markdown to AI agents instead of HTML, which helps these tools process your content faster and use fewer tokens. Every page is also available to view as Markdown by appending `.md` to the URL. |
| 23 | + |
| 24 | +Mintlify hosts `llms.txt` and `llms-full.txt` files for your documentation. These industry-standard files help LLMs index your documentation and respond efficiently with relevant information to user queries. |
| 25 | + |
| 26 | +Your documentation site also hosts an MCP server that lets users connect your documentation directly to their AI tools for up to date information about your product directly where they want it. |
| 27 | + |
| 28 | +Full-text search and semantic understanding help users and AI tools find relevant information quickly. Search understands user intent rather than just matching keywords. And if a user encounters a 404 error, your site suggests related pages to help them find what they're looking for. No configuration required. |
| 29 | + |
| 30 | +## Enable AI features |
| 31 | + |
| 32 | +Select any of the following cards for more information. |
| 33 | + |
| 34 | +<CardGroup cols={2}> |
| 35 | + <Card title="Assistant" icon="bot-message-square" href="/ai/assistant"> |
| 36 | + Configure the assistant to search external sites or direct people to your support team if it can't answer their questions. |
| 37 | + </Card> |
| 38 | + <Card title="Agent" icon="pen-line" href="/ai/agent"> |
| 39 | + Add the agent to your Slack workspace or embed it into custom apps to have it help write and update your documentation. |
| 40 | + </Card> |
| 41 | + <Card title="Contextual menu" icon="sparkles" href="/ai/contextual-menu"> |
| 42 | + Add a menu to pages that lets users query AI tools, connect to your MCP server, and copy pages as context with one click. |
| 43 | + </Card> |
| 44 | + <Card title="MCP integration" icon="plug" href="/ai/model-context-protocol"> |
| 45 | + Your site has a hosted MCP server that lets users connect your documentation directly to their AI tools. Make your users aware of your MCP server and how to connect to it. |
| 46 | + </Card> |
| 47 | +</CardGroup> |
0 commit comments