文档中心

火山方舟

读取文档

通过 URL

已知文档页面 URL 时，AI Agent 应先尝试读取 <DOC_URL>.md 获取 Markdown 镜像。镜像不可用时，再读取页面 HTML。Markdown 镜像主要包含页面正文；HTML 数据还包含导航、脚本和样式，需要额外提取正文。

比较两种 URL

URL 类型	响应内容	优点	局限
Markdown 镜像	Markdown 文本	主要包含标题和正文，适合直接加入 Agent 上下文。	需要已知目标文档页面，并且站点提供 <DOC_URL>.md。
HTML 页面	text/html	支持网页读取的 Agent 可以直接访问，无需改写地址。	原始 HTML 同时包含导航、脚本、样式和页面元数据，会占用额外上下文并影响正文提取。

读取 Markdown 镜像

在文档页面 URL 后追加 .md。例如：

Markdown 镜像适合以下场景：

读取 HTML 页面

支持网页访问和正文提取的 Agent 可以直接读取页面 URL。文档页面的 HTML 响应包含完整正文，也包含站点导航、交互脚本、样式和页面元数据。

读取 HTML 页面时，Agent 应执行以下处理：

不同网页读取工具的正文提取能力不同。工具直接返回原始 HTML 时，不要把完整响应注入模型上下文。

配置直接读取规则

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

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

这个页面对您有帮助吗？

有用

无用