mirror of
https://github.com/mintlify/docs.git
synced 2026-09-14 13:35:46 +08:00
mintlify[bot]
3bebd828f6
* docs: sync es/fr/zh translations with recent English updates * docs: tighten translated SEO metadata and fix register consistency --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
70 lines
4.2 KiB
Plaintext
70 lines
4.2 KiB
Plaintext
---
|
||
title: "AI 原生文档"
|
||
sidebarTitle: "AI 原生"
|
||
description: "了解 AI 原生功能如何通过助手、agent 和 MCP 服务器提升文档的阅读、创作和发现体验。"
|
||
keywords: ["AI","assistant","agent","llms.txt","MCP","llms-full.txt"]
|
||
---
|
||
|
||
当你在 Mintlify 上托管文档时，内置的 AI 功能可帮助用户更快找到答案，并让你的团队更高效地维护内容。你的内容为这些 AI 原生功能提供了上下文，从而全面提升阅读、创作与检索文档的体验。
|
||
|
||
<div id="what-makes-your-documentation-ai-native">
|
||
## 什么让你的文档具备 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 功能
|
||
</div>
|
||
|
||
选择以下任意卡片以了解更多信息。
|
||
|
||
<CardGroup>
|
||
<Card title="Assistant" icon="bot-message-square" href="/zh/assistant/configure">
|
||
配置 AI 助手以搜索外部网站，或在其无法回答问题时将用户引导至你的支持团队。
|
||
</Card>
|
||
|
||
<Card title="Automations" icon="message-circle-plus" href="/zh/automations/index">
|
||
按计划或在发生 push 事件时自动获取文档更新。
|
||
</Card>
|
||
|
||
<Card title="Contextual menu" icon="sparkles" href="/zh/ai/contextual-menu">
|
||
为页面添加菜单，让用户可以向 AI 工具发起查询、连接到你的 MCP 服务器，并一键复制整页作为上下文。
|
||
</Card>
|
||
</CardGroup> |