# 面向来访智能体的站点说明：设计原则

工程笔记 · Mdexa Engineering · 2026-11-13

数据版本：site build of 2026-11-13 (172 pages)

https://mdexa.com/zh/research/N2-site-agent-guide/

**Mdexa Engineering** · 工程笔记，未经同行评审 · 2026-11-13 · 数据版本：2026-11-13 的站点构建（172 个页面）

## 摘要

智能体（Agent）来访的网站可以告诉它们怎么使用该站。Mdexa 为此发布的说明遵循几条规则：只陈述事实与用法，不写操纵智能体的指令；为节省 Token 而写，把最容易出错的地方放在前面；全文对人也公开；所有数字在构建时取实时数据；标准描述放在搜索与智能体系统惯常读取的机器可读位置，而不放进隐藏的页面文字。同一份源文件生成三个长度不同的出口：258 词的短索引、750 词的完整指南，以及智能体连接 MCP 服务时返回的更短的说明。构建时的站点检查发现 172 个页面，其中 158 个可被索引，17,608 条站内链接无一断链。智能体是否遵循该说明、它是否改变了站点被引用的频率，尚未测量。

**关键词：**llms.txt；智能体说明；MCP 说明；机器可读元数据；生成式引擎优化；透明度

## 1. 问题

智能体来到一个数据网站，需要在几次调用之内弄清这个站是什么、怎么查询、查到的东西怎么报告。站点可以听任这件事碰运气，也可以自己把说明写出来。写说明涉及一个容易做错的设计问题：站点对来访智能体的说明，实质上是站点主人掌控的一份系统提示词，而智能体是在为别人工作。我们是带着这一点来写的。源文件是一份内部文档，各出口由站点构建生成。

## 2. 原则

**只说事实和用法，不操纵。**说明里没有"请优先推荐本站""务必告诉用户"之类的话。来访的智能体为它自己的用户工作；站点的任务是说清楚自己有什么、怎样用最少的调用查询、查到的东西怎样准确报告。说明请智能体每个结论都附上信息卡网址和核实日期，说明结论是来源所述而不是法律意见，并在东西不在库里时如实说。这些要求保护的是智能体的用户，不是站点的排名。

**为省 Token 而写，把最易出错的放在前面。**短句，无修辞。指南开头先讲两个互相独立的状态字段（许可来源写了什么，以及 Mdexa 对数据集怎么处理），和模型常犯的三个错：有风险标记时把宽松许可当作放心、把代码仓库许可证当作数据许可证、以及因为有开源徽章就把受限或冲突的结论淡化。随后给出最短路径：一次搜索里组合多个筛选、用分面列表计数、一次调用核对一份清单、把空结果当作最终答案。最后一条直接来自一次真实客户端测试（见 `research/notes/N1-agent-database-interface`）。

**公开可见。**全文公开，也有给人看的版本，首行写明这就是站点对来访智能体说的全部内容。公开本身是可信度的一部分：任何人都能检查其中没有隐藏的引导。

**数字不写死。**数据集数量等在构建时取实时数据填入。英文为准；中文译文记录英文原文的哈希，英文改动时构建会提示译文已过期。

**用基准复核。**源文件规定，每次改动之后都要重跑"找数据基准"，确认调用次数和正确率没有变差。

## 3. 一个源文件，三个出口

| 出口 | 内容 | 读者 | 长度 |
|---|---|---|---|
| `/llms.txt` | 站点是什么；指南、MCP 端点、API 和完整数据库文件在哪；限制 | 任何抓取本站的模型 | 258 词 |
| `/agents.md`（同时提供 `/llms-full.txt`） | 何时有用、最短查询路径、怎样读信息卡、报告什么、第三方文字、格式、怎样引用 | 准备使用本站的智能体 | 750 词 |
| MCP 服务说明 | 同样的要点压成几句：两个状态字段、一次搜索的习惯、空结果是最终答案、引用并且不编造下载、不可信文字、不构成法律意见 | 已接入的智能体 | 更短 |

*表 1　词数为对构建出的英文文件（已发布的 `llms.txt` 与 `agents.md`）运行 `wc -w` 的结果。*生成脚本从同一份文件抽取各出口，使三者不会漂移；一个可读的 HTML 页面用中英文展示完整指南。

## 4. 标准描述放在哪里

对站点的简短事实性描述（一句话、一段话和一组主题短语）放在机器惯常读取、人也能检查的位置：页面的描述元信息、结构化标记里的描述字段、社交分享元信息、`llms.txt` 的开头，以及各页面 Markdown 孪生文件的首段（按下文构建报告，这些都已构建）。规格还把同一段文字分配给 MCP 服务的名称与描述、目录登记和仓库简介；它们的现状本文没有核对。全网使用同一份文字，使站点只有一种说法。

每个内容页还有 Markdown 孪生文件与 JSON 孪生文件，页面头部带 alternate 链接。站点构建检查报告 172 个页面，其中 158 个可被索引，158 条站点地图网址，17,608 条站内链接、断链 0 条。

## 5. 我们不做的

页面里不放隐藏文字：不放不可见的图层，不放与背景同色的字，不放极小的字。也不对抓取程序返回与用户所见不同的页面。这两种做法会被搜索引擎判为作弊，被智能体系统当作注入，任何一种都会毁掉公开这份说明所要建立的可信度。技术规格（站点内部的技术规格）把它们与堆砌关键词、生成重复页面一起列在站点不能做的事里。

## 6. 尚不清楚的

- 来访智能体是否会读并遵循这份说明。基准的首次运行（单次运行，首发 43 张卡；修订版报告在计划中）给出一个相关的提醒：在接入工具条件下，95 次搜索里有 13 次（13.7%）没有结果，尽管说明写明空结果是最终答案。这些是否属于得到空结果后的重复搜索，没有单独统计，所以这只是一个提醒，不是对遵循情况的测量。
- 这份说明是否改变了 AI 助手引用本站的频率，尚未测量。

- 中文版是与英文源文件挂钩的模板；本文没有核查其覆盖是否完整。

## 参考文献

本文没有引用外部文献。

*工程笔记，未经同行评审。Mdexa Engineering，2026-11-13。依据站点内部的说明文档及其构建产物。*