

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Atualizar a solução
<a name="update-the-solution"></a>

Se você já implantou a solução, siga este procedimento para atualizar a CloudFormation pilha da solução e obter os recursos e aprimoramentos mais recentes. O processo de atualização tem três partes:
+  [Etapa 1: Atualizar o painel de implantação](#update-deployment-dashboard) 
+  [Etapa 2: migrar as configurações do caso de uso](#migrate-use-case-configurations) 
+  [Etapa 3: atualizar casos de uso](#update-use-cases) 

**nota**  
Na versão 2.0.0, a integração com Anthropic e Hugging Face foi descontinuada em favor do Amazon Bedrock e do Amazon AI. SageMaker Você pode implantar modelos disponíveis por meio do Hugging Face. SageMaker JumpStart Consulte [Use Hugging Face with Amazon SageMaker AI](https://docs.aws.amazon.com/sagemaker/latest/dg/hugging-face.html) para obter mais detalhes.
Certifique-se de testar o processo de atualização em um ambiente que não seja de produção antes de executar essas etapas.

## Etapa 1: Atualizar o painel de implantação
<a name="update-deployment-dashboard"></a>

1. Entre no [CloudFormation console](https://console.aws.amazon.com/cloudformation/), selecione sua CloudFormation pilha existente e selecione **Atualizar**.

1. Selecione **Substituir modelo atual**.

1. Em Especificar modelo:

   1. Selecione **URL do Amazon S3**.

   1. Copie o link do [CloudFormation modelo](https://solutions-reference.s3.amazonaws.com/generative-ai-application-builder-on-aws/latest/generative-ai-application-builder-on-aws.template) mais recente.

   1. Cole o link na caixa de **URL do Amazon S3**.

   1. Verifique se o URL do modelo correto aparece na caixa de texto **URL do Amazon S3** e escolha **Avançar.** Escolha **Avançar** novamente.

1. Em **Parâmetros**, revise os parâmetros do modelo e modifique-os conforme necessário. Para obter detalhes sobre os parâmetros, consulte [Etapa 1: Iniciar a pilha do painel de implantação](step-1-launch-the-deployment-dashboard-stack.md).

1. Escolha **Avançar**.

1. Na página **Configurar opções de pilha**, selecione **Avançar**.

1. Na página **Revisar**, verifique e confirme as configurações. Marque a caixa de seleção para confirmar que o modelo cria recursos do IAM.

1. Escolha **Exibir conjunto de alterações** e verifique as alterações.

1. Selecione **Criar pilha** para implantar a pilha.

Você pode ver o status da pilha no CloudFormation console da AWS na coluna **Status**. Você deve receber o status UPDATE\$1COMPLETE em aproximadamente 10 minutos.

Se a versão existente da Solução for anterior à v2.0.0, a atualização criará uma pilha de interface do usuário da web (que substitui a `amplify-ui` implementação da tela de login por uma interface de usuário hospedada no Cognito) e uma nova CloudFront URL, que pode ser obtida na seção Saída do CloudFormation console quando o status da pilha for UPDATE\$1COMPLETE.

**nota**  
Os casos de uso existentes criados usando versões anteriores à v2.0.0 NÃO serão exibidos até que você conclua as etapas descritas abaixo.

## Etapa 2: migrar configurações de casos de uso (somente atualizações de versões anteriores à 2.0.0)
<a name="migrate-use-case-configurations"></a>

O esquema para armazenamento e o serviço da AWS para armazenar a configuração do caso de uso foram alterados na versão 2.0.0. Siga as etapas descritas no [Guia do usuário de migração do GAAB v2](https://github.com/aws-solutions/generative-ai-application-builder-on-aws/tree/main/docs/migration/migration.md) usando o script [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). Depois de executar o script, você pode acessar o painel de implantação para ver os casos de uso implantados.

**nota**  
Você deve seguir as etapas abaixo para concluir a migração dos casos de uso.

## Etapa 3: atualizar casos de uso
<a name="update-use-cases"></a>

Você pode editar os casos de uso implantados com os novos recursos disponíveis nas versões mais recentes do GAAB. Consulte [Usar a solução](https://docs.aws.amazon.com/solutions/latest/generative-ai-application-builder-on-aws/use-the-solution.html) para obter informações sobre como usar os recursos dessa solução.

Para atualizar os casos de uso para a versão mais recente, você deve concluir as etapas de `Editar`caso de uso no painel de implantação (embora você possa não fazer nenhuma alteração). Essa ação aciona uma atualização da CloudFormation pilha com a versão mais recente do modelo.

**nota**  
Casos de uso criados com versões 1.x ou 2.x da solução podem não funcionar com versões posteriores. Portanto, recomendamos clonar casos de uso existentes criados com versões anteriores à v3.0.0 por meio do painel de implantação. Em seguida, migre gradualmente e substitua por novos casos de uso criados usando a versão 3.0.0 ou posterior.