Aptos 开发的 AI 工具
Aptos 为 AI 驱动的开发工作流提供一流支持。无论您使用的是 AI 编程助手还是 AI 聊天工具, 都可以让它深入了解 Aptos 区块链、Move 语言、SDK 和 API。
Aptos MCP 服务器
Section titled “Aptos MCP 服务器”模型上下文协议 (MCP) 让 AI 编程工具能够直接调用 Aptos API、 查询链上数据并生成正确的 Aptos 代码,无需复制粘贴文档。
Aptos Agent Skills
Section titled “Aptos Agent Skills”Aptos Agent Skills 提供预构建 AI 技能, 为编程助手提供深度 Aptos 专业知识——涵盖 Move 智能合约、TypeScript SDK 和全栈 dApp 脚手架。
npx skills add aptos-labs/aptos-agent-skills此命令使用通过 npx 调用的 Skills CLI。如果当前环境中没有 npx skills,请确认已安装 Node.js 与 npm,并参考 Skills CLI 文档完成安装与排查。
LLMs.txt 文档源
Section titled “LLMs.txt 文档源”LLMs.txt 标准提供机器可读的文档源,AI 工具可以摄取这些内容以理解完整的 Aptos 文档。我们发布三种文档源以适应不同的上下文窗口大小:
| 文档源 | URL | 最适合 |
|---|---|---|
| llms.txt | /llms.txt | 包含页面标题、描述和逐页 .md 链接的结构化索引 |
| llms-small.txt | /llms-small.txt | 适合较小上下文窗口的压缩文档 |
| llms-full.txt | /llms-full.txt | 完整文档——所有页面串联在一起 |
部分客户端会解析 /.well-known/llms.txt;生产环境会通过重定向提供与 /llms.txt 相同的索引(https://aptos.dev/.well-known/llms.txt)。
llms.txt 路由还会列出机器可读的 API 链接——/aptos-spec.json(全节点 REST API 的 OpenAPI 3 JSON)以及 /zh/rest-api(HTML 参考文档)——并在同一处汇总 MCP、Agent Skills、浏览器、GitHub、标准与 Indexer GraphQL 等 .md 链接。
面向智能体的发现端点
Section titled “面向智能体的发现端点”为方便编程智能体一站式发现 Aptos 的机器可读资源,文档站点发布了一组标准化的发现文档。每个页面的响应也会带上 Link 响应头与对应的 <link rel="…"> 标签,指向相同的 URL。
| 端点 | 作用 |
|---|---|
/.well-known/api-catalog | 符合 RFC 9727 的 linkset,指向 REST API 规范、文档、Indexer GraphQL 以及 LLMs.txt 文档源。 |
/.well-known/mcp/server-card.json | 描述 @aptos-labs/aptos-mcp 的 MCP Server Card (SEP-2127)。 |
/.well-known/agent-skills/index.json | 基于 Agent Skills Discovery 的 aptos-agent-skills 索引,包含每个技能的 SHA-256 摘要。 |
/.well-known/oauth-protected-resource | 面向 https://aptos.dev 的 OAuth 2.0 受保护资源元数据(RFC 9728),列出资源标识符、Aptos 测试网水龙头 使用的 Firebase + Google 授权服务器以及支持的 scopes。 |
/.well-known/openid-configuration | OpenID Connect Discovery 1.0 文档,描述 Aptos 测试网水龙头 登录所使用的 issuer、授权与令牌端点、JWKS URI 与支持的授权类型。 |
/.well-known/oauth-authorization-server | 面向偏好纯 OAuth 2.0 端点名称的客户端的 OAuth 2.0 授权服务器元数据(RFC 8414) 副本,与上面的 OIDC 发现文档内容一致。 |
/auth.md | auth.md 智能体认证说明。写明 aptos.dev 为公开文档(不提供智能体注册),测试网水龙头使用人类 Google OIDC 登录。 |
/robots.txt | 包含 Content Signals(ai-train=yes, search=yes, ai-input=yes),表明 Aptos 文档允许 AI 使用。 |
源站级 RFC 9728 文档将资源标识符设为 https://aptos.dev,以便要求 resource 与本主机一致的客户端能够接受该文档。本主机上的文档无需鉴权。列出的授权服务器(Firebase + Google)签发 Aptos 测试网水龙头 在 Authorization: Bearer … 头中接受的令牌;水龙头 API 本身位于 https://faucet.testnet.aptoslabs.com。/auth.md 是对应的说明文档:本站没有智能体注册端点。
DNS for AI Discovery(DNS-AID)
Section titled “DNS for AI Discovery(DNS-AID)”DNS-AID 记录无法从本仓库发布。aptos.dev 托管在 Google Cloud DNS 上(ns-cloud-c1.googledomains.com 至 ns-cloud-c4.googledomains.com)。要通过基于 DNS 的智能体发现,运维需要在组织索引处添加 ServiceMode HTTPS 记录,并保持 DNSSEC 可验证(该区域已有 DNSKEY 记录;还需要在 .dev 父域发布 DS 记录):
_index._agents.aptos.dev. 3600 IN HTTPS 1 aptos.dev. alpn="h2,h3" port=443该记录将智能体指向 https://aptos.dev,此处已托管 MCP Server Card、API catalog 以及其他 well-known 文档。在 Aptos 通过 HTTPS 提供这些协议之前,不要发布 _a2a._agents 或 _mcp._agents——MCP 服务器是 stdio(npx @aptos-labs/aptos-mcp),不是远程 MCP 端点。
发布后可用以下命令确认:
dig +short HTTPS _index._agents.aptos.devMarkdown 内容协商
Section titled “Markdown 内容协商”任何拥有 .md 镜像的文档 URL(例如 /zh/build/sdks → /zh/build/sdks.md)都会响应 Accept: text/markdown 并返回 Content-Type: text/markdown:
curl -H "Accept: text/markdown" https://aptos.dev/zh/build/sdks浏览器的默认 Accept: text/html 依旧得到 HTML 响应。
WebMCP
Section titled “WebMCP”在实现 WebMCP 提案 的浏览器(如 Chrome 早期预览)中,每个文档页面会通过 navigator.modelContext 暴露以下工具:aptos-docs.search、aptos-docs.open-doc、aptos-docs.fetch-doc-markdown 与 aptos-docs.list-llms-feeds。