跳转到内容

Aptos 开发的 AI 工具

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

AskAptos 聊天机器人已内置于文档站点中——在导航栏右上角查找即可。它可以回答关于 Aptos 概念的问题,帮助您规划实现方案,并指引您到正确的文档页面。

模型上下文协议 (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面向 Google 登录的 Aptos 测试网水龙头OAuth 2.0 受保护资源元数据(RFC 9728),列出资源标识符、授权服务器以及支持的 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 发现文档内容一致。
/robots.txt包含 Content Signalsai-train=yes, search=yes, ai-input=yes),表明 Aptos 文档允许 AI 使用。

OAuth / OIDC 发现文档仅适用于 Aptos 测试网水龙头aptos.dev 的其余部分都是公开的、无需鉴权的文档。需要为测试网账户充值的智能体可以调用 /.well-known/oauth-protected-resource 获取水龙头的资源标识符以及它在 Authorization: Bearer … 头中接受的 OIDC issuer(Firebase + Google)。

任何拥有 .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