本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

如果您先前已部署解決方案，請依照此程序更新解決方案的 CloudFormation 堆疊，以取得最新的功能和增強功能。升級程序分為三個部分：
+  [步驟 1：更新部署儀表板](#update-deployment-dashboard) 
+  [步驟 2：遷移使用案例組態](#migrate-use-case-configurations) 
+  [步驟 3：更新使用案例](#update-use-cases) 

**注意**  
在 2.0.0 版中，為了支援 Amazon Bedrock 和 Amazon SageMaker AI，已棄用與 Anthropic 和 Hugging Face 的整合。您可以透過 SageMaker JumpStart 部署 Hugging Face 提供的模型。如需詳細資訊，請參閱[搭配使用 Hugging Face 與 Amazon SageMaker 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 **是否正確，然後選擇**下一步**。再次選擇 **Next (下一步)**。

1. 在**參數**下，檢閱範本的參數並視需要修改。如需參數的詳細資訊，請參閱[步驟 1：啟動部署儀表板堆疊](step-1-launch-the-deployment-dashboard-stack.md)。

1. 選擇**下一步**。

1. 在 **Configure stack options** (設定堆疊選項) 頁面，選擇 **Next** (下一步)。

1. 在**檢視** 頁面上，檢視和確認的設定。勾選確認範本將建立 IAM 資源的方塊。

1. 選擇**檢視變更集**並驗證變更。

1. 選擇**更新堆疊**以部署堆疊。

您可以在狀態欄的 AWS CloudFormation 主控台中檢視堆疊**的狀態**。您應該會在大約 10 分鐘內收到 UPDATE\$1COMPLETE 狀態。

如果現有的解決方案版本在 v2.0.0 之前，更新會建立 Web UI 堆疊 （以 Cognito 託管 UI 取代登入畫面的`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 指令碼，遵循 GAAB v2 Migration 使用者指南](https://github.com/aws-solutions/generative-ai-application-builder-on-aws/tree/main/docs/migration/migration.md)中所述的步驟。 [https://github.com/aws-solutions/generative-ai-application-builder-on-aws/blob/main/source/scripts/v2_migration/gaab_v2_migration.py](https://github.com/aws-solutions/generative-ai-application-builder-on-aws/blob/main/source/scripts/v2_migration/gaab_v2_migration.py)執行指令碼後，您可以存取部署儀表板來檢視已部署的使用案例。

**注意**  
您必須依照下列步驟完成遷移使用案例。

## 步驟 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)中的功能的資訊，請參閱使用解決方案。

若要將使用案例更新至最新版本，您必須在部署儀表板中完成 `Edit`use case 步驟 （雖然您可能不會進行任何變更）。此動作會觸發具有最新範本版本的 CloudFormation 堆疊更新。

**注意**  
使用 1.x 或 2.x 版解決方案建立的使用案例可能無法搭配更新版本使用。因此，我們建議您透過部署儀表板複製使用 v3.0.0 之前版本建立的現有使用案例。然後，逐步遷移並使用 v3.0.0 或更新版本建立的新使用案例取代 。