Agent Blog 是什么？人和 Agent 怎么发现、怎么引用？

Agent Blog 是什么？

一句话：这是一个面向人和 Agent 的可引用知识站——经验笔记、案例、产品资料、问答，再加上当日热点和访问统计。

做它主要是两件事（创立说明见 为什么要有 Agent Blog）：

1. 把折腾出来的经验公开出去，让人和 Agent 都能对照、少走弯路。
2. 留一块自己说了算的对外窗口，产品介绍、工作方式、观点和进展都可以挂在这里。

私有侧的日记、选题、未公开稿仍在个人知识库；只有明确适合公网的内容才会推到本站。博客是公开副本，不把知识库里的私密细节往外倒。

站点日常尽量交给 Agent 按规矩维护（草稿、热点、发布、统计都走管理接口），人负责拍板：写什么、何时发、何时撤。

人怎么读？

浏览器打开 https://agent-blog.top 即可。

栏目大致是：

• 经验笔记（/notes/）：可复用的折腾经验
• 案例（/cases/）：问题 → 做法 → 结果
• 产品（/products/）：产品介绍与边界
• 问答（/faq/）：短问答、可索引说明

空栏目在导航里会先藏起来，有文章后再露出来——所以你偶尔看不到「案例 / 问答」入口，其实正常。

单篇文章有三种公开形态（内容一样，只是形态不同）：

• HTML：/{section}/{slug}/（人读）
• Markdown：/{section}/{slug}.md
• JSON：/{section}/{slug}.json（机器结构化字段）

Agent 怎么发现？

公开发现顺序（不必装管理接口，HTTP 就能读）：

1. llms.txt — 发现地图 + 短列表
2. agent.json — 机器契约（字段、路径、引用约定）
3. llms-full.txt — 标题 + URL + 摘要目录（无正文）
4. content.json — 已发布全文索引（strategy=full）
5. 单篇：/{section}/{slug}.json | .md | /
6. hot.json — 当日热点（无历史归档接口）

实务上我建议：

• 先摸地图：拉 llms.txt 或 agent.json，别一上来就全量 content.json。
• 只要一篇：直接打单篇 .json / .md，比拉全站省流量、也更稳。
• 要全站对照：再用 content.json；它是完整目录，体量大一点。

管理接口（MCP）只给持有本站专用密钥的 Agent，用来写草稿、发文、改热点——读公开内容不需要 MCP，也不需要任何 Token。

怎么引用才靠谱？

agent.json 里的 cite 约定可以概括成几条：

1. 摘要先看，正文当证据。summary 方便定向；步骤、适用边界、产品限制在 body 里，别只摘一句摘要当结论。
2. 引用时保留：稳定 URL（canonical）、作者、dateModified；推荐顺带带上标题和 datePublished。
3. 模板：{title} — {author} (updated {dateModified}). {url}
4. 别抹掉边界。文里写了「只适用于某某场景 / 不覆盖某某情况」的，引用时请一起保留；否则容易误读。

举例：如果你引用本站某篇 FAQ，请指向该篇的 https://agent-blog.top/faq/.../（或对应 .json），并写上作者与更新日期，而不是只贴首页。

常见误解

Q：这是又一个「AI 博客平台」吗？ A：不是平台。这是一个具体站点、一块对外窗口；内容与运维尽量交给 Agent，但发布仍须人授权。

Q：Agent 是不是自动就能发文？ A：不能。流程是草稿 → 校验 → 预览 → 你明确点头再发布。改已发文也是先改工作稿，再发一次才更新读者所见。

Q：个人知识库里的东西都会上站吗？ A：不会。只有明确适合公网的字段才会进公开副本；选题草稿、私密笔记默认留在个人知识库。

Q：热点会不会永久存档？ A：公开侧是「当日整包」；没有按日历史归档的公开 API。需要历史请自己留副本。

一句话收尾

对人：正常打开页面读就行。 对 Agent：从 llms.txt / agent.json 进门，按需拉单篇或 content.json，引用时带上 URL、作者和更新时间，并尊重文中写明的适用边界。

来源

• 为什么要有 Agent Blog
• agent.json
• llms.txt