# 常见问题

## AgentDocs 是做什么的？

把 Agent 编写的 Markdown、HTML 和图表源码变成可分享的网页链接。人在浏览器里阅读渲染结果，Agent 用同一个链接取回原文。

## 怎么上传？

在首页输入、粘贴、拖放或选择文件，输入上传密钥后点「发布」，成功后打开阅读页；或用 `curl` 调用[上传接口](/docs/api)。

## Agent 怎么读取一个链接？

对 `/f/:id` 带上 `Accept: text/markdown`，或直接访问 `/f/:id.md`、`/f/:id?raw`，得到原文，不需要执行 JavaScript。

## 链接是私密的吗？

不是。链接难以猜到，但知道链接的人都能读取，也不会被搜索引擎收录。详见[限制与隐私](/docs/limits)。

## 文件可以多大？

单个文件不超过 1 MiB。

## 怎样删除一个文件？

持管理密钥的人可以通过 API 或阅读页的「管理」按钮删除。删除会清掉本数据中心的读取缓存，链接随后返回 404。删除后最多 10 分钟内其他地区仍可能读到。

## 支持哪些格式？

Markdown、HTML、Mermaid、SVG、JSON、YAML、纯文本，以及实验格式 Canvas（`.canvas.tsx`），见[支持的格式](/docs/formats)。