用于AI的Amazon Devices Builder Tools入门

“用于AI驱动式开发的Amazon Devices Builder Tools”包括模型上下文协议 (MCP)（仅提供英文版）服务器和智能体技能。这些组件为您的AI编程智能体提供Amazon Devices专属的元数据、工具和工作流。此智能体会遵循推荐模式和最佳实践，涵盖项目设置、功能集成、性能分析、崩溃调试和测试等方面。

Amazon Devices Builder Tools为Vega OS提供全面支持，但对Fire OS仅提供有限支持。有关各操作系统当前支持的功能，请参阅Amazon Devices Builder Tools自述文件（仅提供英文版）。

观看此视频，了解Amazon Devices Builder Tools的概述。

Amazon Devices Builder Tools包括：

• MCP服务器 — 一个独立的npm程序包，为兼容的AI编码智能体提供亚马逊设备的元数据、工具和功能。
• 智能体技能 — 轻量级、模块化、基于markdown的指令集，可指导您的智能体完成Fire TV开发工作流。
• 指导文档 — 为您的AI助手提供亚马逊设备最佳实践基础的上下文文件。

Amazon Devices Builder Tools不收集、传输或存储您的任何机密信息。有关详细信息，请参阅隐私常见问题解答。

Amazon Devices Builder Tools是一个独立的npm程序包，不与Vega SDK捆绑在一起。使用此页面上的步骤单独安装它。

有关智能体技能、MCP工具、MCP提示、受支持的工作流与智能体，以及手动配置选项的完整列表，请参阅Amazon Devices Builder Tools自述文件（仅提供英文版）。

先决条件

• Node.js 18或更高版本。如果MCP服务器在Node v26上因SQLite3绑定错误而无法启动，则改用Node v24。请参阅解决用于AI的Amazon Devices Builder Tools问题。
• Vega SDK v0.22或更高版本（仅Vega应用开发工作流必须满足此要求）。Fire OS工作流无需Vega SDK。

安装和设置

要为您的AI智能体配置Amazon Devices Builder Tools，并向项目添加亚马逊设备专属上下文，请在终端（Bash或ZSH shell）中运行以下命令：

npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context

此命令为您的AI智能体安装和配置MCP、指导和技能。它会提示您选择智能体、选择安装目录，以及处理现有的上下文文件。在随后运行init-context时，该命令会自动检查更新并下载新功能。

命令成功完成后，您将看到类似于以下内容的输出：

✅ MCP配置已更新
✅ 已安装上下文文档
✅ Kiro的设置已完成

交互模式（默认）

在交互模式下运行时，系统会引导您完成以下操作：

1. 选择您的AI智能体（例如Cursor、Kiro或Other/Custom [其他/自定义]）。

   该工具会确认您的选择，并继续显示MCP设置提示符。

2. 输入y/n自动更新智能体的MCP设置文件。

   该工具会打印✅ MCP configuration updated，并继续显示上下文文档路径提示符。

3. 选择默认的上下文文档安装路径或输入自定义路径。

   该工具会确认路径，并继续显示操作提示符。

4. 选择操作：merge（向现有文件添加新内容）、update（覆盖现有文件）或save（写入新文件）。

   该工具会写入上下文文档，并打印如上所示的成功信息。

非交互模式

使用命令行选项跳过提示并自动执行设置过程：

npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest init-context --agent <agent-name> --force

可用选项：

引导模式与智能体模式

init-context采用以下两种模式之一安装指导内容：

• 引导模式（默认）— 将引导文档安装到您的工作区。您的AI智能体会在该工作区的每个会话中自动加载它。
• 智能体模式 (--install-agent) — 安装adbt-dev，这是一个专用的、可选加入的亚马逊设备智能体，提供相同的指导内容，且无需始终启用的引导文档。仅当您显式调用adbt-dev时，才会获得指导内容。

智能体模式支持Kiro、Claude Code、GitHub Copilot，以及读取AGENTS.md的主机，例如Cursor、Codex、OpenCode、Cline和Gemini CLI。读取AGENTS.md的主机共享同一个智能体文件。

移除亚马逊设备上下文

要移除某个主机的所有亚马逊设备上下文（包括智能体文件、引导文档、技能和MCP配置条目），请运行clean-context：

npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest clean-context

检查智能体设置状态

安装MCP服务器和上下文文档后，使用check-status命令验证您的设置：

npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status

要检查特定智能体，请运行以下命令：

npx -y @amazon-devices/amazon-devices-buildertools-mcp@latest check-status --agent <agent-name>

此命令检查：

• 上下文文档安装状态和版本
• 智能体安装状态（如果您使用--install-agent设置adbt-dev）
• MCP配置状态
• 检测传统配置

已安装的智能体会计入完全配置的设置，因此智能体模式主机不会被报告为缺少上下文文档。

输出示例：

─────────────────────────────────────────────────────────────────────────────────────────────────
智能体            │ 上下文文档         │ 智能体 (--install-agent) │ MCP配置
─────────────────────────────────────────────────────────────────────────────────────────────────
Kiro             │ ✅ v5.1                   │ ❌ 未安装         │ ✅ 已配置
─────────────────────────────────────────────────────────────────────────────────────────────────
📊 摘要：
   总配置：1
   ✅ 完全配置：1
   ⚠ 部分配置：0
   ❌ 未配置：0

该命令还会打印Detailed Information（详细信息）部分，列出每个主机解析后的上下文、智能体文件和MCP配置路径。读取AGENTS.md的主机会显示共享的智能体文件路径。

验证设置

安装后，首先运行check-status以确认您的配置是否正确（请参阅检查智能体设置状态）。然后确认您的智能体可以访问Amazon Devices Builder Tools。在您的AI智能体聊天中，输入：

List the tools provided by Amazon Devices Builder Tools and Agent Skills（列出Amazon Devices Builder Tools和智能体技能提供的工具）

您的智能体应提供一份可用工具的列表作为响应，其中包括analyze_perfetto_traces、get_app_hot_functions、list_documents、read_asset、read_document、search_documentation和symbolicate_acr。

然后尝试使用特定于亚马逊设备的提示：

Help me setup Vega SDK（帮我设置Vega SDK）

如果您的智能体使用特定于亚马逊设备的设置步骤（而不是通用的React Native指令）进行响应，则配置可以正常生效。如果您遇到任何问题，请参阅解决用于AI的Amazon Devices Builder Tools问题。

验证设置完成后，尝试显示诸如“在虚拟设备上构建并运行我的应用”或“帮助我调试应用中的首帧时间 (TTFF)”之类的提示。

隐私常见问题解答

问1： Amazon Devices Builder Tools是否会收集我的代码、查询内容及其他机密数据或将其发送给亚马逊？

答： 否。Amazon Devices Builder Tools不收集、传输或存储您的任何机密信息，包括：

• 您的代码示例或应用源代码。
• 您向AI助手提交的查询或提示。
• 您的项目文件或配置。
• 其他开发者数据或知识产权。

然而，您的AI智能体所发出的文档搜索查询将发送至亚马逊服务，用于查找与您请求相关的文档。

Amazon Devices Builder Tools和您的AI助手之间的所有交互都发生在您的本地计算机上。您的代码与查询内容将严格保密，仅由您选定的AI助手依其隐私政策进行处理。唯一的例外是文档搜索查询。

问2： AI助手可以访问哪些数据？

答： 您的AI助手会依其隐私政策和服务条款处理查询内容和代码。Amazon Devices Builder Tools为您的助手提供工具和特定于亚马逊设备的上下文。助手的数据处理实践由其提供者管理。请查看AI助手隐私政策，了解其数据处理流程。

问3： 亚马逊会收集有关我使用Amazon Devices Builder Tools的任何数据吗？

答： 亚马逊收集匿名遥测数据，以改进Amazon Devices Builder Tools。这种遥测包括功能使用模式、错误率和性能指标。您可以在设置中禁用遥测收集。

重要的隐私保护：

• 不收集任何机密数据： 您的查询、代码示例、项目文件或任何其他开发者创建的内容永远不会发送给亚马逊。
• 最终处理： MCP完全在您的本地计算机上运行。唯一的例外是文档搜索查询（参见问题1）。
• 仅限匿名数据： 遥测数据不包含个人身份信息。

亚马逊还提供一项可选的开发者调查，以了解Amazon Devices Builder Tools的实用性。该调研遵循自愿参加原则。

故障排除

如果您遇到任何问题，请参阅解决用于AI的Amazon Devices Builder Tools问题。

相关主题

• Amazon Devices Builder Tools自述文件（仅提供英文版）
• 构建您的应用
• 在Vega虚拟设备或Fire TV上运行应用
• 应用性能最佳实践
• 调试崩溃问题

Last updated: 2026年10月13日