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á.
# Crie um aplicativo de resumo de texto com IA com o Amazon Bedrock
Neste tutorial, você criará um aplicativo no App Studio que usa o Amazon Bedrock para fornecer resumos concisos da entrada de texto dos usuários finais. O aplicativo contém uma interface de usuário simples, na qual os usuários podem inserir qualquer texto que desejarem resumido. Podem ser notas de reuniões, conteúdo do artigo, resultados de pesquisas ou qualquer outra informação textual. Depois que os usuários inserem o texto, eles podem pressionar um botão para enviar o texto para o Amazon Bedrock, que o processará usando o modelo Claude 3 Sonnet e retornará uma versão resumida.
**Contents**
+ [Pré-requisitos](#tutorial-conversational-bedrock-prerequisites)
+ [Etapa 1: criar e configurar uma função do IAM e um conector do App Studio](#tutorial-conversational-bedrock-steps-create-role-connector)
+ [Etapa 2: criar um aplicativo](#tutorial-conversational-bedrock-steps-create-application)
+ [Etapa 3: criar e configurar uma automação](#tutorial-conversational-bedrock-steps-create-automation)
+ [Etapa 4: criar páginas e componentes](#tutorial-conversational-bedrock-steps-user-interface)
+ [Renomear a página padrão](#tutorial-conversational-bedrock-steps-user-interface-create-page)
+ [Adicionar componentes à página](#tutorial-conversational-bedrock-steps-user-interface-add-components)
+ [Configurar os componentes da página](#tutorial-conversational-bedrock-steps-user-interface-configure-components)
+ [Etapa 5: publicar o aplicativo no ambiente **de teste**](#tutorial-conversational-bedrock-steps-publish)
+ [Limpar (opcional)](#tutorial-conversational-bedrock-steps-cleanup)
## Pré-requisitos
Antes de começar, analise e preencha os seguintes pré-requisitos:
+ Acesso ao AWS App Studio. Observe que você deve ter a função de administrador para criar um conector neste tutorial.
+ Opcional: revise [AWS Conceitos do App Studio](concepts.md) e [Tutorial: Comece a criar a partir de um aplicativo vazio](getting-started-tutorial-empty.md) se familiarize com conceitos importantes do App Studio.
## Etapa 1: criar e configurar uma função do IAM e um conector do App Studio
Para fornecer acesso ao App Studio aos modelos do Amazon Bedrock, você deve:
1. Ative os modelos do Amazon Bedrock que você deseja usar em seu aplicativo. Neste tutorial, você usará o **Claude 3 Sonnet**, portanto, certifique-se de habilitar esse modelo.
1. Crie uma função do IAM com as permissões apropriadas para o Amazon Bedrock.
1. Crie um conector do App Studio com a função IAM que será usada no seu aplicativo.
Acesse [Conecte-se ao Amazon Bedrock](connectors-bedrock.md) para obter instruções detalhadas e retorne a este tutorial depois de seguir as etapas e criar o conector.
## Etapa 2: criar um aplicativo
Use o procedimento a seguir para criar um aplicativo vazio no App Studio que você incorporará ao aplicativo de resumo de texto.
1. Faça login no App Studio.
1. Navegue até o hub do construtor e escolha **\$1 Criar aplicativo**.
1. Escolha **Começar do zero**.
1. No campo **Nome do aplicativo**, forneça um nome para seu aplicativo, como**Text Summarizer**.
1. Se você precisar selecionar fontes de dados ou um conector, escolha **Ignorar** para os fins deste tutorial.
1. Escolha **Próximo** para continuar.
1. (Opcional): assista ao tutorial em vídeo para ter uma visão geral rápida da criação de aplicativos no App Studio.
1. Escolha **Editar aplicativo**, que o levará ao estúdio de aplicativos.
## Etapa 3: criar e configurar uma automação
Você define a lógica e o comportamento de um aplicativo do App Studio nas *automações.* As automações consistem em etapas individuais conhecidas como *ações*, *parâmetros* usados para transmitir dados de outros recursos para a ação e uma *saída* que pode ser usada por outras automações ou componentes. Nesta etapa, você criará uma automação que gerencia a interação com o Amazon Bedrock com o seguinte:
+ Entradas: um parâmetro para passar a entrada de texto do usuário para a automação.
+ Ações: Uma ação **GenAI Prompt** que envia a entrada de texto para o Amazon Bedrock e retorna o resumo do texto de saída.
+ Saídas: uma saída de automação que consiste no resumo processado do Amazon Bedrock, que pode ser usado em seu aplicativo.
**Para criar e configurar uma automação que envia uma solicitação ao Amazon Bedrock e processa e retorna um resumo**
1. Escolha a guia **Automações** na parte superior da tela.
1. Escolha **\$1 Adicionar automação**.
1. No painel direito, escolha **Propriedades**.
1. Atualize o nome da automação escolhendo o ícone de lápis. Digite **InvokeBedrock** e pressione **Enter**.
1. Adicione um parâmetro à automação que será usado para passar a entrada do prompt de texto do usuário para a automação a ser usada na solicitação para o Amazon Bedrock executando as seguintes etapas:
1. Na tela, na caixa de parâmetros, escolha **\$1 Adicionar**.
1. Em **Nome**, insira **input**.
1. Em **Descrição**, insira qualquer descrição, como**Text to be sent to Amazon Bedrock**.
1. Em **Tipo**, selecione **Cadeia de caracteres**.
1. Escolha **Adicionar** para criar o parâmetro.
1. Adicione uma ação **GenAI Prompt** executando as seguintes etapas:
1. No painel direito, escolha **Ações**.
1. Escolha **GenAI Prompt** para adicionar uma ação.
1. Configure a ação executando as seguintes etapas:
1. Escolha a ação na tela para abrir o menu **Propriedades** à direita.
1. Renomeie a ação para **PromptBedrock** escolhendo o ícone de lápis, inserindo o nome e pressionando enter.
1. Em **Conector**, selecione o conector que foi criado em[Etapa 1: criar e configurar uma função do IAM e um conector do App Studio](#tutorial-conversational-bedrock-steps-create-role-connector).
1. Em **Modelo**, escolha o modelo Amazon Bedrock que você deseja usar para processar a solicitação. Neste tutorial, você escolherá **Claude 3.5 Sonnet**.
1. Em **Solicitação do usuário**, insira`{{params.input}}`. Isso representa o `input` parâmetro que você criou anteriormente e conterá a entrada de texto dos usuários do seu aplicativo.
1. No **prompt do sistema**, insira as instruções do prompt do sistema que você deseja enviar para o Amazon Bedrock. Para este tutorial, insira o seguinte:
```
You are a highly efficient text summarizer. Provide a concise summary of the prompted text, capturing the key points and main ideas.
```
1. Escolha **Configurações de solicitação** para expandi-la e atualize os seguintes campos:
+ Em **Temperatura**, insira`0`. A temperatura determina a aleatoriedade ou criatividade da saída em uma escala de 0 a 10. Quanto maior o número, mais criativa é a resposta.
+ Em **Max Tokens**, insira `4096` para limitar a duração da resposta.
1. A saída dessa automação será o texto resumido, no entanto, por padrão, as automações não criam saídas. Configure a automação para criar uma saída de automação executando as seguintes etapas:
1. Na navegação à esquerda, escolha a **InvokeBedrock**automação.
1. No menu **Propriedades** à direita, em **Saída**, escolha **\$1 Adicionar**.
1. Em **Saída**, insira**\$1\$1results.PromptBedrock.text\$1\$1**. Essa expressão retorna o conteúdo da `processResults` ação.
## Etapa 4: criar páginas e componentes
No App Studio, cada página representa uma tela da interface de usuário (UI) do seu aplicativo com a qual seus usuários interagirão. Nessas páginas, você pode adicionar vários componentes, como tabelas, formulários, botões e muito mais, para criar o layout e a funcionalidade desejados.
### Renomear a página padrão
O aplicativo de resumo de texto deste tutorial conterá apenas uma página. Os aplicativos recém-criados vêm com uma página padrão, então você renomeará essa em vez de adicionar uma.
**Para renomear a página padrão**
1. No menu de navegação da barra superior, escolha **Páginas**.
1. No painel do lado esquerdo, escolha **Página1** e escolha o painel **Propriedades** no painel do lado direito.
1. Escolha o ícone do lápis**TextSummarizationTool**, insira e pressione **Enter**.
1. Em **Rótulo de navegação**, insira**TextSummarizationTool**.
### Adicionar componentes à página
Para este tutorial, o aplicativo de resumo de texto tem uma página que contém os seguintes componentes:
+ Um componente **de entrada de texto** que os usuários finais usam para inserir uma solicitação a ser resumida.
+ Um componente **Button** usado para enviar a solicitação para o Amazon Bedrock.
+ Um componente **da área de texto** que exibe o resumo do Amazon Bedrock.
Adicione um componente **de entrada de texto** à página que os usuários usarão para inserir uma solicitação de texto a ser resumida.
**Para adicionar um componente de entrada de texto**
1. No painel **Componentes** à direita, localize o componente **de entrada de texto** e arraste-o para a tela.
1. Escolha a entrada de texto na tela para selecioná-la.
1. No painel **Propriedades** do lado direito, atualize as seguintes configurações:
1. Escolha o ícone de lápis para o qual renomear a entrada de texto. **inputPrompt**
1. Em **Rótulo**, insira**Prompt**.
1. Em **Espaço reservado**, insira**Enter text to be summarized**.
Agora, adicione um componente **Button** que os usuários escolherão para enviar a solicitação para o Amazon Bedrock.
**Para adicionar um componente de botão**
1. No painel **Componentes** à direita, localize o componente **Botão** e arraste-o para a tela.
1. Escolha o botão na tela para selecioná-lo.
1. No painel **Propriedades** do lado direito, atualize as seguintes configurações:
1. Escolha o ícone de lápis para o qual renomear **sendButton** o botão.
1. Em **Rótulo do botão**, insira**Send**.
Agora, adicione um componente de **área de texto** que exibirá o resumo retornado pelo Amazon Bedrock.
**Para adicionar um componente de área de texto**
1. No painel **Componentes** à direita, localize o componente **Área de texto** e arraste-o para a tela.
1. Escolha a área de texto na tela para selecioná-la.
1. No painel **Propriedades** do lado direito, atualize as seguintes configurações:
1. Escolha o ícone de lápis para o qual renomear **textSummary** o botão.
1. Em **Rótulo**, insira**Summary**.
### Configurar os componentes da página
Agora que o aplicativo contém uma página com componentes, a próxima etapa é configurar os componentes para realizar o comportamento adequado. Para configurar um componente, como um botão, para realizar ações ao interagir com ele, você deve adicionar um *gatilho* a ele. Para o aplicativo deste tutorial, você adicionará dois gatilhos ao `sendButton` botão para fazer o seguinte:
+ O primeiro gatilho envia o texto no `textPrompt` componente para o Amazon Bedrock para ser analisado.
+ O segundo gatilho exibe o resumo retornado do Amazon Bedrock no `textSummary` componente.
**Para adicionar um gatilho que envia a solicitação para o Amazon Bedrock**
1. Escolha o botão na tela para selecioná-lo.
1. **No painel **Propriedades** do lado direito, na seção **Acionadores**, escolha \$1 Adicionar.**
1. Escolha **Invoke Automation**.
1. Escolha o **InvokeAutomation1** gatilho que foi criado para configurá-lo.
1. Em **Nome da ação**, insira**invokeBedrockAutomation**.
1. Em **Invoke Automation**, selecione a **InvokeBedrock**automação que foi criada anteriormente.
1. Na caixa de parâmetros, no parâmetro **de entrada** criado anteriormente, insira**\$1\$1ui.inputPrompt.value\$1\$1**, que passa o conteúdo no componente de entrada de `inputPrompt` texto.
1. Escolha a seta para a esquerda na parte superior do painel para retornar ao menu de propriedades do componente.
Agora que você configurou um gatilho que invoca a automação para enviar uma solicitação ao Amazon Bedrock quando o botão é clicado. A próxima etapa é configurar um segundo gatilho que exibe os resultados no componente. `textSummary`
**Para adicionar um gatilho que exibe os resultados do Amazon Bedrock no componente da área de texto**
1. **No painel **Propriedades** do lado direito do botão, na seção **Acionadores**, escolha \$1 Adicionar.**
1. Escolha **Executar ação do componente**.
1. Escolha o gatilho **Runcomponentaction1** que foi criado para configurá-lo.
1. Em **Nome da ação**, insira**setTextSummary**.
1. Em **Componente**, selecione o componente **TextSummary**.
1. Em **Ação**, selecione **Definir valor**.
1. Em **Definir valor como**, insira**\$1\$1results.invokeBedrockAutomation\$1\$1**.
## Etapa 5: publicar o aplicativo no ambiente **de teste**
Normalmente, enquanto você está criando um aplicativo, é uma boa prática visualizá-lo para ver sua aparência e fazer os testes iniciais de sua funcionalidade. No entanto, como os aplicativos não interagem com serviços externos no ambiente de pré-visualização, você publicará o aplicativo no ambiente de teste para poder testar o envio de solicitações e o recebimento de respostas do Amazon Bedrock.
**Para publicar seu aplicativo no ambiente de teste**
1. No canto superior direito do criador de aplicativos, escolha **Publicar**.
1. Adicione uma descrição da versão para o ambiente de teste.
1. Revise e marque a caixa de seleção referente ao SLA.
1. Escolha **Iniciar**. A publicação pode levar até 15 minutos.
1. (Opcional) Quando estiver pronto, você pode dar acesso a outras pessoas escolhendo **Compartilhar** e seguindo as instruções. Para obter mais informações sobre o compartilhamento de aplicativos do App Studio, consulte[Compartilhamento de aplicativos publicados](application-share.md).
Depois de testar seu aplicativo, escolha **Publicar** novamente para promover o aplicativo para o ambiente de produção. Observe que os aplicativos no ambiente de produção não estão disponíveis para os usuários finais até que sejam compartilhados. Para obter mais informações sobre os diferentes ambientes de aplicativos, consulte[Ambientes de aplicativos](applications-publish.md#application-environments).
## Limpar (opcional)
Agora você concluiu com sucesso o tutorial e criou um aplicativo de resumo de texto no App Studio com o Amazon Bedrock. Você pode continuar usando seu aplicativo ou limpar os recursos que foram criados neste tutorial. A lista a seguir contém uma lista de recursos a serem limpos:
+ O conector Amazon Bedrock criado no App Studio. Para obter mais informações, consulte [Visualizando, editando e excluindo conectores](viewing-deleting-connectors.md).
+ O aplicativo de resumo de texto no App Studio. Para obter mais informações, consulte [Como excluir uma aplicação](applications-delete.md).
+ A função do IAM criada no console do IAM. Para obter mais informações, consulte [Excluir funções ou perfis de instância](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html) no *Guia AWS Identity and Access Management do usuário*.
+ Se você solicitou acesso ao modelo para usar o Claude 3 Sonnet e quiser reverter o acesso, consulte [Gerenciar o acesso aos modelos da Amazon Bedrock Foundation no](https://docs.aws.amazon.com/bedrock/latest/userguide/model-access.html) Guia do usuário do *Amazon* Bedrock.