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

# 更新此解决方案
<a name="update-the-solution"></a>

如果您之前部署过该解决方案，请按照以下步骤更新解决方案 CloudFormation 堆栈以获取最新的功能和增强功能。升级过程分为三个部分：
+  [步骤 1：更新部署控制面板](#update-deployment-dashboard) 
+  [步骤 2：迁移用例配置](#migrate-use-case-configurations) 
+  [第 3 步：更新用例](#update-use-cases) 

**注意**  
在 v2.0.0 中，不推荐与 Anthropic 和 Hugging Face 集成，转而使用亚马逊 Bedrock 和亚马逊 AI。 SageMaker 你可以通过以下方式部署 Hugging Fac SageMaker JumpStart e 提供的模型。有关更多详细信息，请参阅[将 Hugging Face 与 A SageMaker mazon AI 配](https://docs.aws.amazon.com/sagemaker/latest/dg/hugging-face.html)合使用。
在运行这些步骤之前，请确保在非生产环境中测试更新过程。

## 步骤 1：更新部署控制面板
<a name="update-deployment-dashboard"></a>

1. 登录[CloudFormation 控制台](https://console.aws.amazon.com/cloudformation/)，选择您的现有 CloudFormation 堆栈，然后选择**更新**。

1. 选择**替换当前模板**。

1. 在指定模板下：

   1. 选择 **Amazon S3 URL**。

   1. 复制最新的[CloudFormation 模板](https://solutions-reference.s3.amazonaws.com/generative-ai-application-builder-on-aws/latest/generative-ai-application-builder-on-aws.template)链接。

   1. 将链接粘贴到 **Amazon S3 URL** 框中。

   1. 验证 **Amazon S3 URL** 文本框中显示了正确的模板 URL，然后选择**下一步**。再次选择**下一步**。

1. 在**参数**下，检查模板的参数，并根据需要进行修改。有关参数的详细信息，请参阅[步骤 1：启动部署控制面板堆栈](step-1-launch-the-deployment-dashboard-stack.md)。

1. 选择 **Next**(下一步)。

1. 在**配置堆栈选项**页面上，请选择**下一步**。

1. 在**审核**页面上，审核并确认设置。选中用于确认模板将创建 IAM 资源的框。

1. 选择**查看更改集**并验证更改。

1. 选择**更新堆栈**以部署堆栈。

您可以在 AWS CloudFormation 控制台的 “状态” 列中查看堆栈的**状态**。您将在大约 10 分钟后收到 “更新完成” 状态。

如果现有解决方案版本低于 v2.0.0，则更新将创建一个 Web UI 堆栈（使用 Cognito 托管用户界面取代登录屏幕的`amplify-ui`实现）和一个新 CloudFront URL，堆栈状态为 UPDATE\$1COMPLETE 后，即可从 CloudFormation 控制台的 “输出” 部分获取该堆栈。

**注意**  
在您完成以下步骤之前，不会显示使用 v2.0.0 之前的版本创建的现有用例。

## 步骤 2：迁移用例配置（仅限 2.0.0 以下版本的更新）
<a name="migrate-use-case-configurations"></a>

在 2.0.0 版本中，存储架构和用于存储用例的 AWS 服务配置已更改。使用 [gaab\$1v2\$1migration.py](https://github.com/aws-solutions/generative-ai-application-builder-on-aws/blob/main/source/scripts/v2_migration/gaab_v2_migration.py) 脚本按照 [GAAB v2 迁移用户指南](https://github.com/aws-solutions/generative-ai-application-builder-on-aws/tree/main/docs/migration/migration.md)中描述的步骤进行操作。运行脚本后，您可以访问部署仪表板以查看已部署的用例。

**注意**  
您必须按照以下步骤完成用例的迁移。

## 第 3 步：更新用例
<a name="update-use-cases"></a>

您可以使用最新版本的 GAAB 中提供的新功能来编辑已部署的用例。有关如何[使用此解决方案](https://docs.aws.amazon.com/solutions/latest/generative-ai-application-builder-on-aws/use-the-solution.html)中的功能的信息，请参阅使用解决方案。

要将用例更新到最新版本，您必须完成部署控制面板中的 “编辑” 用例步骤（尽管您可能不会进行任何更改）。此操作会触发使用最新模板版本的 CloudFormation 堆栈更新。

**注意**  
使用 1.x 或 2.x 版本的解决方案创建的用例可能不适用于更高版本。因此，我们建议通过 Deployment 控制面板克隆使用 v3.0.0 之前的版本创建的现有用例。然后，逐步迁移并替换为使用 v3.0.0 或更高版本创建的新用例。