mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
locadex-agent[bot]
6131c9bdcb
Co-authored-by: locadex-agent[bot] <217277504+locadex-agent[bot]@users.noreply.github.com>
64 lines
3.7 KiB
Plaintext
64 lines
3.7 KiB
Plaintext
---
|
||
title: "AI 原生文档"
|
||
sidebarTitle: "AI 原生"
|
||
description: "了解 AI 如何提升阅读、创作与检索文档的体验"
|
||
keywords: ["AI", "assistant", "agent", "llms.txt", "MCP"]
|
||
---
|
||
|
||
当你在 Mintlify 上托管文档时，内置的 AI 功能可帮助用户更快找到答案，并让你的团队更高效地维护内容。你的内容为这些 AI 原生功能提供了上下文，从而全面提升阅读、创作与检索文档的体验。
|
||
|
||
<div id="what-makes-your-documentation-ai-native">
|
||
## 什么让你的文档具备 AI 原生特性
|
||
</div>
|
||
|
||
<div id="reading">
|
||
### 阅读
|
||
</div>
|
||
|
||
除了阅读单个页面，用户还可以在你的文档中与[AI 助手](/zh/ai/assistant)聊天，及时获得问题的答案和相关内容的链接。AI 助手会基于你的文档提供准确信息，帮助用户更好地了解你的产品。你也可以通过[API](api-reference/assistant/create-assistant-message)将 AI 助手嵌入自定义应用，扩展用户访问你文档的触达渠道。
|
||
|
||
<div id="writing">
|
||
### 写作
|
||
</div>
|
||
|
||
[agent](/zh/agent) 可帮助你撰写和维护文档。它会基于你的提示、拉取请求（PR；亦称“合并请求”/Merge Request）以及 Slack 讨论串，创建包含建议更改的拉取请求。将 agent 添加到你的 Slack 工作区，你的团队成员即可通过与 agent 对话协同维护文档。你也可以通过 [API](/zh/api-reference/agent/create-agent-job) 将 agent 嵌入自定义应用。
|
||
|
||
你可以配置 agent 监控已连接的代码仓库，并在识别到面向用户的变更时，[主动建议](/zh/agent/suggestions) 文档更新。
|
||
|
||
配置常用工具（如 [Cursor](/zh/guides/cursor)、[Claude Code](/zh/guides/claude-code) 和 [Windsurf](/zh/guides/windsurf)），以对齐 Mintlify 架构、你的风格指南和最佳实践。
|
||
|
||
<div id="discovering">
|
||
### 发现
|
||
</div>
|
||
|
||
你的网站会自动针对 AI 工具和搜索引擎进行优化，帮助用户更容易找到你的文档。所有页面都会以 Markdown 而非 HTML 的形式发送给 AI 代理，这有助于这些工具更快处理你的内容并使用更少的 token。通过在 URL 末尾追加 `.md`，每个页面也都可以以 Markdown 形式查看。
|
||
|
||
Mintlify 会为你的文档托管 `llms.txt` 和 `skill.md` 文件。这些行业标准文件帮助大语言模型在响应用户查询时高效返回相关信息，并为智能代理提供可用能力列表，从而让用户在使用你的产品时取得更好的效果。
|
||
|
||
你的文档站点还会托管一个 MCP 服务器，使用户能够将你的文档直接连接到他们的 AI 工具，在他们需要的地方获取关于你产品的最新信息。
|
||
|
||
全文搜索和语义理解帮助用户和 AI 工具快速找到相关信息。搜索能够理解用户意图，而不仅仅是匹配关键词。如果用户遇到 404 错误，你的网站会推荐相关页面，帮助他们找到所需内容。无需任何配置。
|
||
|
||
<div id="enable-ai-features">
|
||
## 启用 AI 功能
|
||
</div>
|
||
|
||
选择以下任意卡片以了解更多信息。
|
||
|
||
<CardGroup cols={2}>
|
||
<Card title="Assistant" icon="bot-message-square" href="/zh/ai/assistant">
|
||
配置 AI 助手以搜索外部网站，或在其无法回答问题时将用户引导至你的支持团队。
|
||
</Card>
|
||
|
||
<Card title="Agent" icon="pen-line" href="/zh/agent/quickstart">
|
||
在控制台中使用 Agent 创建文档更新。
|
||
</Card>
|
||
|
||
<Card title="Suggestions" icon="message-circle-plus" href="/zh/agent/suggestions">
|
||
监控 Git 仓库的变更，并接收推荐的文档更新建议。
|
||
</Card>
|
||
|
||
<Card title="Contextual menu" icon="sparkles" href="/zh/ai/contextual-menu">
|
||
为页面添加菜单，让用户可以向 AI 工具发起查询、连接到你的 MCP 服务器，并一键复制整页作为上下文。
|
||
</Card>
|
||
</CardGroup> |