文档中心

火山方舟

读取文档

选择读取方式

AI Agent 读取文档时，应优先使用文档 MCP 或 llms.txt 定位页面，再读取命中的正文。目标页面已知或结构化入口不可用时，依次读取 Markdown 镜像和 HTML 页面。

选择读取方式

优先级	方式	适用场景	说明
1	文档 MCP	Agent 支持 MCP，需要检索文档、API、代码示例或模型信息	文档 MCP 提供结构化工具和按需读取能力，减少 Agent 自行维护 URL 和解析页面的成本。
2	llms.txt 系列文件	Agent 可以访问公网，但未接入 MCP；需要发现页面或获取批量语料	llms.txt 用于发现文档；llms-full.txt 和章节全文文件用于构建知识库或离线检索。
3	Markdown 镜像	已知目标页面地址，只需要页面正文	在文档页面 URL 后追加 .md，获取 text/markdown 内容，避免 HTML 页面中的导航和样式代码。
4	HTML 页面	Agent 只能使用网页读取工具，或目标页面没有可用的 Markdown 镜像	网页解析工具虽能提取正文，但原始 HTML 包含导航、脚本、样式等大量无关内容，会占用上下文窗口。

使用文档检索 Skill

推荐为 AI Agent 安装 ark-docs-reader，由 Skill 根据目标站点选择读取方式：

安装前，请准备 Node.js 22.20.0 或更高版本以及 npm。Node.js 安装包自带 npx。执行以下命令安装 ark-docs-reader：

安装完成后，可以要求 Agent 读取当前站点的最新官方文档。例如：

配置 Agent 读取规则

将以下规则加入 Agent 的系统提示词。

最近更新时间：2026.11.03 15:22:10

这个页面对您有帮助吗？

有用

无用