View a markdown version of this page

Implantação de um caso de uso autônomo do Bedrock Agent - Criador de aplicações de IA generativa na AWS

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á.

Implantação de um caso de uso autônomo do Bedrock Agent

Siga as step-by-step instruções nesta seção para configurar e implantar a solução em sua conta.

Tempo de implantação: aproximadamente 10 a 30 minutos

  1. Faça login no AWS Management Console e selecione o botão para iniciar o CloudFront modelo.

    BedrockAgent.modelo

    Launch solution

  2. Por padrão, esse modelo é iniciado na região Leste dos EUA (Norte da Virgínia). Para iniciar a solução em outra região da AWS, use o seletor de Região na barra de navegação do console.

    nota

    Essa solução usa o Amazon Bedrock, que atualmente não está disponível em todas as regiões da AWS. Se você estiver usando esses recursos, deverá iniciar essa solução em uma região da AWS onde esses serviços estejam disponíveis. Para obter a disponibilidade mais atual por região, consulte a Lista de serviços regionais da AWS.

  3. Na página Criar pilha, verifique se o URL de modelo correto é apresentado na caixa de texto URL do Amazon S3 e escolha Avançar.

  4. Na página Especificar detalhes da pilha, atribua um nome para a sua pilha de soluções. Para obter informações sobre limitações de nomenclatura de caracteres, consulte {https---docs-aws-amazon-com- https---docs-aws-amazon-com -IAM-Latest- UserGuide -reference-iam-limits-html} [cotas do IAM e do AWS STS] no Guia do usuário do AWS Identity and Access Management.

  5. Em Parâmetros, revise os parâmetros do modelo dessa solução e modifique-os conforme requerido. Esta solução usa os seguintes valores padrão.

    Parâmetro Entrada padrão Description

    UseCaseUUID

    <_Requires input_>

    36 caracteres UUIDv4 para identificar esse caso de uso implantado em um aplicativo.

    UseCaseConfigRecordKey

    <Requires input>

    Chave correspondente ao registro que contém as configurações exigidas pela função Lambda do provedor de bate-papo em tempo de execução.

    O registro na tabela deve ter um atributo-chave correspondente a esse valor e um atributo de configuração contendo a configuração desejada.

    Esse registro será preenchido pela plataforma de implantação se estiver em uso. Para implantações autônomas desse caso de uso, é necessária uma entrada criada manualmente na tabela UseCaseConfigTableNamedefinida em.

    UseCaseConfigTableName

    <Requires input>`

    A pilha lerá a configuração do caso de uso da tabela fornecida aqui e usará a chave de registro definida em UseCaseConfigRecordKey.

    DefaultUserEmail

    placeholder@example.com

    E-mail do usuário padrão para esse caso de uso. A solução cria um usuário do Amazon Cognito para esse e-mail acessar o caso de uso.

    ExistingRestApiId

    (Entrada opcional)

    ID da API REST da API Gateway existente a ser usada. Se não for fornecida, uma nova API REST do API Gateway será criada. Normalmente fornecido durante a implantação a partir do painel de implantação.

    Observação: usar o APIs Existing pode ajudar a reduzir a duplicação de recursos e simplificar o gerenciamento de APIs quando você precisa implantar vários casos de uso autônomos. Ao fornecer o existente APIs para um caso de uso independente, você é responsável por garantir que a API seja configurada com as rotas necessárias com os modelos esperados. Uma rota /details pré-configurada necessária (busca detalhes do caso de uso durante o bate-papo) e, opcionalmente, uma rota /feedback (se FeedbackEnabledestiver definida como para permitir a coleta de feedback Yes para respostas de bate-papo do LLM) deve ser configurada. Além disso ExistingApiRootResourceId,, ExistingCognitoUserPoolIde também ExistingCognitoGroupPolicyTableNamedeve ser fornecido.

    ExistingApiRootResourceId

    (Entrada opcional)

    ID de recurso raiz da API Gateway REST existente a ser usado. O ID do recurso raiz da API REST pode ser obtido no console da AWS selecionando o recurso raiz (/) na seção “Recursos” da API. O ID do recurso será então exibido no painel de detalhes do recurso. Como alternativa, você pode executar uma chamada de descrição da API em sua API REST para encontrar o ID do recurso raiz.

    FeedbackEnabled

    No

    Se definido como Não, a pilha de casos de uso implantada não terá acesso ao recurso de feedback.

    CognitoDomainPrefix

    (Entrada opcional)

    Insira um valor se quiser fornecer um domínio para o cliente do grupo de usuários do Amazon Cognito. Se você não fornecer um valor, a solução gerará um.

    ExistingCognitoUserPoolId

    (Entrada opcional)

    UserPoolIdde um grupo de usuários existente do Amazon Cognito com o qual você deseja autenticar esse caso de uso. OBSERVAÇÃO: você normalmente fornece essa ID ao implantar a partir do painel de implantação, mas pode omiti-la ao implantar essa pilha de casos de uso de forma independente.

    ExistingCognitoUserPoolClient

    (Entrada opcional)

    Forneça um cliente de grupo de usuários (cliente de aplicativo) para usar um existente. Se você não fornecer um cliente de grupo de usuários, a solução cria um. Você só pode fornecer esse parâmetro se tiver fornecido um ExistingCognitoUserPoolId.

    ExistingCognitoGroupPolicyTableName

    (Entrada opcional)

    Nome da tabela do DynamoDB contendo políticas de grupos de usuários. Isso é usado pelo autorizador personalizado na API do caso de uso. OBSERVAÇÃO: Normalmente, você fornece esse nome ao implantar a partir do painel de implantação, mas pode omiti-lo ao implantar essa pilha de casos de uso de forma independente.

    VpcEnabled

    No

    Se os recursos das pilhas serão implantados em uma VPC.

    CreateNewVpc

    No

    Selecione Yes se quiser que a solução crie uma nova VPC para você e a use para esse caso de uso. NOTA: Esse parâmetro só é relevante se VpcEnabledforYes.

    IPAMPoolId

    (Entrada opcional)

    Se você quiser atribuir o intervalo CIDR usando IPAM, forneça o ID do pool IPAM a ser usado. NOTA: Esse parâmetro só é relevante se VpcEnabledfor Yes e CreateNewVpcforNo.

    ExistingVpcId

    (Entrada opcional)

    ID da VPC de uma VPC existente a ser usada para o caso de uso. NOTA: Esse parâmetro só é relevante se VpcEnabledfor Yes e CreateNewVpcforNo.

    ExistingPrivateSubnetIds

    (Entrada opcional)

    Lista separada por vírgula IDs de sub-redes privadas existentes a serem usadas para implantar a função Lambda. NOTA: Esse parâmetro só é relevante se VpcEnabledfor Yes e CreateNewVpcforNo.

    ExistingSecurityGroupIds

    (Entrada opcional)

    Lista separada por vírgulas de grupos de segurança da VPC existente a ser usada para configurar funções Lambda. NOTA: Esse parâmetro só é relevante se VpcEnabledfor Yes e CreateNewVpcforNo.

    VpcAzs

    (Entrada opcional)

    Lista separada por vírgula AZs de onde as sub-redes do são criadas VPCs

    Nota: Só é relevante se VpcEnabledé Yes e CreateNewVpcéNo.

    BedrockAgentId

    <Requires input>

    O ID do Amazon Bedrock Agent a ser usado.

    BedrockAgentAliasId

    <Requires input>

    O ID de alias do Amazon Bedrock Agent a ser usado.

    Implantar UI

    Yes

    Selecione a opção para implantar a interface de usuário de bate-papo de front-end para essa implantação. A seleção No resulta na criação da infraestrutura para hospedar o APIs, na autenticação do e no APIs processamento de back-end sem a interface do usuário do chat.

  6. Escolha Avançar.

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

  8. Na página Revisar, verifique e confirme as configurações. Marque a caixa de seleção confirmando que o modelo criará recursos do IAM.

  9. Selecione Create stack (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 CREATE_COMPLETE em aproximadamente 10 a 30 minutos.