本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

自定义

什么是 AWS 自定义转换？

AWS Transform custom 使用代理人工智能对软件、代码、库和框架进行大规模现代化改造，以减少技术债务。它可以处理各种场景，包括语言版本升级、API 和服务迁移、框架升级和迁移、代码重构以及组织特定的转换。

通过持续学习，该代理可以根据每一次执行和开发人员反馈进行改进，无需专业的自动化专业知识即可提供高质量、可重复的转换。

关键功能

AWS Transform custom 提供以下功能：

转型模式

AWS Transform 自定义支持多种转换模式，以满足您的现代化需求。根据所需变更的范围和性质，每种模式都有不同的复杂性特征。

操作方法 AWS 改造自定义作品

AWS 自定义转换通常用于转换多个代码库或模块的大型项目。团队通常遵循四个阶段的工作流程：

定义转换 -向代理提供自然语言提示、文档和代码示例，代理会生成初始转换定义。这个定义可以通过聊天或直接编辑来反复完善。使用 AWS-managed 转换时可以跳过此阶段。

试点或 Proof-of-Concept -在示例代码库上测试转换，并根据结果进行完善。此验证阶段有助于估算全面转型的成本和工作量。在此阶段，持续学习可以提高质量。

扩展执行 -使用 CLI 设置自动批量执行，开发人员审查和验证结果。使用 Web 应用程序监控进度并跟踪多个存储库之间的转换。

监控和审查 -持续学习可自动提高转型质量。查看从之前的运行中提取的经验教训，确保它们符合质量标准，并将所有无用的内容存档。

了解主要 概念

本节解释了使用自定义 AWS 转换的关键概念。

转换定义

转换定义包含执行特定代码转换所需的指令和知识。它表示为一项技能，包括：

AWS 当需要执行、检查或修改时，Transform CLI 会自动将转换定义下载到当前目录。

转换注册表

转换注册表是您 AWS 账户的集中存储库，用于存储和管理转换定义。注册表中的转换可以是：

草稿与已发布的转换

AWS 自定义转换支持注册表中的两种转换状态：

草稿转换正在进行中或未经测试的转换定义。它们被保存为特定版本，可以由引用该特定版本的用户检索、更新和执行。在转型准备好与团队共享之前，草稿可用于迭代开发、测试和完善。草稿还与特定的对话相关联。如果重新启动 CLI，则可以使用atx --conversation-id {id}恢复之前的 CLI。

已发布的转换可在您账户的转换注册表中找到，供具有所需 IAM 权限的其他用户执行。可以使用atx custom def list发现已发布的转换。

典型的工作流程是：

您也可以直接发布转换，无需将其另存为草稿。

参考文献与课程

AWS 自定义转换使用两种类型的知识来提高转换质量：

参考是用户提供的文档，存储在转换定义的references/文件夹中。参考文献仅支持文本文件（所有文件总共最大 10MB），通常包含文档、API 规范、迁移指南和代码示例。在转换执行期间根据需要加载引用。在交互模式下创建或更新转换定义时，可以添加引用。

课程会自动从之前的转换运行中提取。持续学习系统根据执行轨迹、开发人员反馈以及在转换过程中遇到的代码修复生成它们。它将相关课程分为几类，这样您就可以一起复习它们。与您预先提供的参考文献不同，当您在不同的代码库中进行转换时，经验会随着时间的推移而累积，系统会自动应用这些参考资料来改善未来的运行。您可以通过互动方式查看和管理课程。atx custom def learnings

生成和验证命令

生成或验证命令是一个可选参数，用于指定在转换过程中如何验证您的代码。此命令在转换期间的不同时刻执行，以确保代码的完整性。

提供验证结果并在验证失败时返回问题的命令对于通过持续学习提高转型质量非常重要。如果不需要生成或验证，请省略您的输入。

有关示例和详细指南，请参阅 “工作流程” 部分中的生成和验证命令。

持续学习

持续学习是一种自动捕获每次转型执行的反馈并随着时间的推移提高转型质量的系统。该系统通过以下方式收集信息：

持续学习系统处理这些信息以创建课程，将其添加到转型定义中，以改善未来的转型。转换完成后，系统会自动运行学习过程，无需您额外输入。

管理课程

系统会自动生成课程，但您可以控制将来的课程应用于哪些课程。该atx custom def learnings命令会打开一个交互式终端会话，用于审查和整理转型所积累的经验教训。

在此会话中，您可以：

如需分步指导，请参阅 持续学习。

Client-Side 技能

Client-side 技能是在转换执行期间扩展代理的额外能力。与定义要执行的转换定义不同，客户端技能提供了补充工具、脚本和指令，代理可以在任何转换过程中将其与内置功能一起使用。

Client-side 技能是从项目级和用户级目录中发现的。当他们强制执行特定于存储库的标准时，将技能放在项目级别；当技能应用于您的所有项目时，将其设置在用户级别。 Project-level 技能仅在提供代码存储库路径时可用。有关详细配置和用法，请参阅Client-Side 技能。

自定义转换命令简介

以下是一些可用于自定义转换的命令。完整的命令列表在AWS 转换自定义转换命令参考中。