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

1. 问题

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

2. 原则

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

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

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

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

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

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

表 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. Instructions for Visiting Agents: Design Principles for a Site-Level Agent Guide. Engineering note, not peer reviewed. 2026-11-13. Data version: site build of 2026-11-13 (172 pages).