跳转到内容

Aptos 开发的 AI 工具

Aptos 为 AI 驱动的开发工作流提供一流支持。无论您使用的是 AI 编程助手还是 AI 聊天工具, 都可以让它深入了解 Aptos 区块链、Move 语言、SDK 和 API。

模型上下文协议 (MCP) 让 AI 编程工具能够直接调用 Aptos API、 查询链上数据并生成正确的 Aptos 代码,无需复制粘贴文档。

Aptos Agent Skills 提供预构建 AI 技能, 为编程助手提供深度 Aptos 专业知识——涵盖 Move 智能合约、TypeScript SDK 和全栈 dApp 脚手架。

Terminal window
npx skills add aptos-labs/aptos-agent-skills

此命令使用通过 npx 调用的 Skills CLI。如果当前环境中没有 npx skills,请确认已安装 Node.js 与 npm,并参考 Skills CLI 文档完成安装与排查。

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 链接。

为方便编程智能体一站式发现 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-mcpMCP Server Card (SEP-2127)
/.well-known/agent-skills/index.json基于 Agent Skills Discoveryaptos-agent-skills 索引,包含每个技能的 SHA-256 摘要。
/.well-known/oauth-protected-resource面向 https://aptos.devOAuth 2.0 受保护资源元数据(RFC 9728),列出资源标识符、Aptos 测试网水龙头 使用的 Firebase + Google 授权服务器以及支持的 scopes。
/.well-known/openid-configurationOpenID Connect Discovery 1.0 文档,描述 Aptos 测试网水龙头 登录所使用的 issuer、授权与令牌端点、JWKS URI 与支持的授权类型。
/.well-known/oauth-authorization-server面向偏好纯 OAuth 2.0 端点名称的客户端的 OAuth 2.0 授权服务器元数据(RFC 8414) 副本,与上面的 OIDC 发现文档内容一致。
/auth.mdauth.md 智能体认证说明。写明 aptos.dev 为公开文档(不提供智能体注册),测试网水龙头使用人类 Google OIDC 登录。
/robots.txt包含 Content Signalsai-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-AID 记录无法从本仓库发布。aptos.dev 托管在 Google Cloud DNS 上(ns-cloud-c1.googledomains.comns-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 端点。

发布后可用以下命令确认:

Terminal window
dig +short HTTPS _index._agents.aptos.dev

任何拥有 .md 镜像的文档 URL(例如 /zh/build/sdks/zh/build/sdks.md)都会响应 Accept: text/markdown 并返回 Content-Type: text/markdown

Terminal window
curl -H "Accept: text/markdown" https://aptos.dev/zh/build/sdks

浏览器的默认 Accept: text/html 依旧得到 HTML 响应。

在实现 WebMCP 提案 的浏览器(如 Chrome 早期预览)中,每个文档页面会通过 navigator.modelContext 暴露以下工具:aptos-docs.searchaptos-docs.open-docaptos-docs.fetch-doc-markdownaptos-docs.list-llms-feeds