# AI 原生文档 (/zh/ai-native)

<!-- agent-signals: reading_time_min: 2 · est_tokens: 1460 · updated: 2026-07-30 -->
Related: [快速入门](/zh/quickstart.md), [产品更新](/zh/changelog.md), [什么是 Mintlify？](/zh/what-is-mintlify.md), [迁移到 Mintlify](/zh/migration.md), [Mintlify CLI 命令参考](/zh/cli/commands.md), [全局设置](/zh/organize/settings.md)

当你在 Mintlify 上托管文档时，内置的 AI 功能可帮助用户更快找到答案，并让你的团队更高效地维护内容。你的内容为这些 AI 原生功能提供了上下文，从而全面提升阅读、创作与检索文档的体验。

<div id="what-makes-your-documentation-ai-native">
  ## 什么让你的文档具备 AI 原生特性 [#什么让你的文档具备-ai-原生特性]
</div>

<div id="reading">
  ### 阅读 [#阅读]
</div>

除了阅读单个页面，用户还可以在你的文档中与[AI 助手](/zh/assistant/index)聊天，及时获得问题的答案和相关内容的链接。AI 助手会基于你的文档提供准确信息，帮助用户更好地了解你的产品。你也可以通过[API](/zh/api/assistant/create-assistant-message-v2)将 AI 助手嵌入自定义应用，扩展用户访问你文档的触达渠道。

<div id="writing">
  ### 写作 [#写作]
</div>

[agent](/zh/agent) 可帮助你撰写和维护文档。它会基于你的提示、拉取请求 (PR；亦称“合并请求”/Merge Request) 以及 Slack 讨论串，创建包含建议更改的拉取请求。将 agent 添加到你的 Slack 工作区，你的团队成员即可通过与 agent 对话协同维护文档。你也可以通过 [API](/zh/api/agent/v2/create-agent-job) 将 agent 嵌入自定义应用。

创建 [automations](/zh/automations/index)，让 agent 按预设计划或在推送到存储库时运行。每个自动化都为 agent 定义提示词以及触发运行的条件。

配置常用工具 (如 [Cursor](/zh/guides/cursor)、[Claude Code](/zh/guides/claude-code) 和 [Devin Desktop](/zh/guides/devin-desktop)) ，以对齐 Mintlify 架构、你的风格指南和最佳实践。

<div id="discovering">
  ### 发现 [#发现]
</div>

你的网站会自动针对 AI 工具和搜索引擎进行优化，帮助用户更容易找到你的文档。所有页面都会以 Markdown 而非 HTML 的形式发送给 AI 代理，这有助于这些工具更快处理你的内容并使用更少的 token。通过在 URL 末尾追加 `.md`，每个页面也都可以以 Markdown 形式查看。使用 [visibility](/zh/components/visibility) 组件为不同受众定制内容。

Mintlify 会为你的文档托管 `llms.txt` 和 `skill.md` 文件。这些行业标准文件帮助大语言模型在响应用户查询时高效返回相关信息，并为智能代理提供可用能力列表。因此，用户在使用你的产品时能取得更好的效果。

<Tip>
  教用户如何安装你的 `skill.md` 文件，让他们在使用 AI 工具操作你的产品时获得更好的结果。使用 [`Prompt` 组件](/zh/components/prompt)将安装提示直接嵌入到你的文档中：

  ```mdx
  <Prompt description="Install the skill for your product." actions={["copy", "cursor"]}>
  npx skills add https://your-docs-domain.com
  </Prompt>
  ```
</Tip>

你的文档站点还会托管一个 MCP 服务器，使用户能够将你的文档直接连接到他们的 AI 工具，在他们需要的地方获取关于你产品的最新信息。

全文搜索和语义理解帮助用户和 AI 工具快速找到相关信息。搜索能够理解用户意图，而不仅仅是匹配关键词。如果用户遇到 404 错误，你的网站会推荐相关页面，帮助他们找到所需内容。无需任何配置。

<div id="enable-ai-features">
  ## 启用 AI 功能 [#启用-ai-功能]
</div>

选择以下任意卡片以了解更多信息。

<CardGroup>
  <Card title="Assistant" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15 11.75V13.75&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M20 13.226V12.7144C20 9.90275 20 8.49693 19.1213 7.62346C18.2426 6.75 16.8284 6.75 14 6.75H10C7.17157 6.75 5.75736 6.75 4.87868 7.62346C4 8.49693 4 9.90275 4 12.7144V14.951C4 15.6439 4 15.9903 4.05764 16.2784C4.29436 17.4614 5.22466 18.3861 6.41473 18.6215C6.70453 18.6788 7.05302 18.6788 7.75 18.6788H7.82843C7.98779 18.6788 8.06748 18.6788 8.13435 18.6878C8.58001 18.7478 8.93051 19.0963 8.99093 19.5393C9 19.6058 9 19.685 9 19.8434C9 20.1851 9 20.3559 9.02036 20.4547C9.16244 21.1439 9.96003 21.4723 10.5508 21.0848C10.6354 21.0293 10.7569 20.9085 11 20.6669L11.9781 19.6946C12.4077 19.2676 12.6224 19.0541 12.8818 18.9155C12.9998 18.8526 13.1238 18.8015 13.252 18.7631C13.534 18.6788 13.8425 18.6788 14.4597 18.6788C16.8278 18.6788 18.0119 18.6788 18.8171 18.0695C19.0319 17.907 19.2236 17.7164 19.3871 17.5029C20 16.7025 20 15.5437 20 13.226Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M9 11.75V13.75&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7 2.75H8C8.92997 2.75 9.39496 2.75 9.77646 2.85222C10.8117 3.12962 11.6204 3.93827 11.8978 4.97354C12 5.35504 12 5.82003 12 6.75&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M2 12.75H4&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M20 12.75H22&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/assistant/configure">
    配置 AI 助手以搜索外部网站，或在其无法回答问题时将用户引导至你的支持团队。
  </Card>

  <Card title="Automations" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M21.5 12C21.5 17.2467 17.2467 21.5 12 21.5C10.3719 21.5 8.8394 21.0904 7.5 20.3687C5.63177 19.362 4.37462 20.2979 3.26592 20.4658C3.09774 20.4913 2.93024 20.4302 2.80997 20.31C2.62741 20.1274 2.59266 19.8451 2.6935 19.6074C3.12865 18.5818 3.5282 16.6382 2.98341 15C2.6698 14.057 2.5 13.0483 2.5 12C2.5 6.75329 6.75329 2.5 12 2.5C17.2467 2.5 21.5 6.75329 21.5 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M15.5 12H8.5M12 8.5V15.5&#x22; stroke=&#x22;currentColor&#x22; stroke-linecap=&#x22;round&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/automations/index">
    按计划或在发生 push 事件时自动获取文档更新。
  </Card>

  <Card title="Contextual menu" icon="<svg xmlns=&#x22;http://www.w3.org/2000/svg&#x22; viewBox=&#x22;0 0 24 24&#x22; fill=&#x22;none&#x22;><path d=&#x22;M15 2L15.5387 4.39157C15.9957 6.42015 17.5798 8.00431 19.6084 8.46127L22 9L19.6084 9.53873C17.5798 9.99569 15.9957 11.5798 15.5387 13.6084L15 16L14.4613 13.6084C14.0043 11.5798 12.4202 9.99569 10.3916 9.53873L8 9L10.3916 8.46127C12.4201 8.00431 14.0043 6.42015 14.4613 4.39158L15 2Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/><path d=&#x22;M7 12L7.38481 13.7083C7.71121 15.1572 8.84275 16.2888 10.2917 16.6152L12 17L10.2917 17.3848C8.84275 17.7112 7.71121 18.8427 7.38481 20.2917L7 22L6.61519 20.2917C6.28879 18.8427 5.15725 17.7112 3.70827 17.3848L2 17L3.70827 16.6152C5.15725 16.2888 6.28879 15.1573 6.61519 13.7083L7 12Z&#x22; stroke=&#x22;currentColor&#x22; stroke-linejoin=&#x22;round&#x22; stroke-width=&#x22;1.5&#x22;/></svg>" href="/zh/ai/contextual-menu">
    为页面添加菜单，让用户可以向 AI 工具发起查询、连接到你的 MCP 服务器，并一键复制整页作为上下文。
  </Card>
</CardGroup>