UD5工具箱
使用教程
第一步：了解意图模型结构
在开始使用工具之前，建议先了解Alexa Skill意图模型的基本结构。一个完整的意图模型JSON包含以下核心字段：最外层包含intents（意图数组）、invocationName（唤醒词，即用户说"Alexa, open [唤醒词]"中的那个词）和可选的types（自定义Slot类型数组）。每个intent对象包含name（意图名称，必须以大写字母开头）、samples（示例语句数组）和可选的slots（槽位数组）。每个slot包含name、type和可选的samples。了解这些基本结构有助于您更好地编写和验证模型。
第二步：加载示例或编写模型
如果您是初次使用，建议先点击"加载示例"按钮加载内置的示例模板。浏览示例的结构和内容，理解各个字段的填写规范。如果您已有编写好的模型代码，可以直接在编辑器中输入或粘贴。也可以将本地的JSON文件直接拖拽到编辑器区域来加载。编辑器支持基本的文本编辑操作，您可以直接在其中修改和调整模型内容。
第三步：格式化代码
在进行验证之前，建议先点击"格式化"按钮将代码整理为标准的缩进格式。格式化后的代码结构清晰，便于您在验证前进行人工审查。检查每个字段的拼写是否正确、层级嵌套是否合理、数组是否使用了正确的方括号和花括号。格式化功能会自动修正缩进和换行，但不会改变JSON的语义内容。
第四步：执行验证
点击"验证"按钮执行JSON语法和结构检查。工具会自动检测以下常见问题：JSON语法错误（如缺少逗号、多余的逗号、未闭合的括号等）、必要字段缺失（如intent缺少name或samples字段）、字段类型错误（如samples不是数组类型）、字段命名规范问题（如意图名称未以大写字母开头）。验证结果会在编辑器下方或弹出窗口中显示，包含具体的错误位置和修复建议。根据提示逐一定位并修复所有发现的问题。
第五步：迭代修改和验证
根据验证结果修复问题后，再次点击"验证"按钮检查是否还有残留错误。通常需要经过多轮的"修改-验证"循环才能使模型通过所有检查。如果遇到不理解的错误提示，可以参考Alexa官方文档中关于Interaction Model Schema的说明。修复所有错误后，再次使用格式化功能确保代码格式规范，然后可以使用压缩功能将代码压缩为单行格式以便部署。
第六步：复制并部署
当验证通过且代码格式符合要求后，点击"复制"按钮将完整的意图模型JSON复制到剪贴板。然后打开Amazon Alexa Developer Console，找到您的Skill项目，进入Interaction Model编辑页面，将剪贴板中的内容粘贴到JSON编辑器中。保存模型后，Alexa会编译您的意图模型。如果编译成功，您就可以在测试页面中用真机或模拟器来测试您的Skill了。建议在整个开发过程中反复使用本工具进行验证，确保每次提交到Developer Console的模型都是正确无误的。