Implantar e integrar um agente do Amazon Bedrock na aplicação - Amazon Bedrock

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

Implantar e integrar um agente do Amazon Bedrock na aplicação

Ao criar um agente do Amazon Bedrock pela primeira vez, você tem uma versão de rascunho de trabalho (DRAFT) e um alias de teste (TSTALIASID) que aponta para a versão do rascunho de trabalho. Ao fazer alterações no agente, as alterações se aplicam ao rascunho de trabalho. Você itera o rascunho de trabalho até que esteja adequado ao comportamento do agente. É possível configurar o agente para implantação e integração na aplicação criando aliases para o agente.

Para implantar o agente, crie um alias. Durante a criação do alias, o Amazon Bedrock cria automaticamente uma versão do agente. O alias aponta para essa versão recém-criada. É possível também apontar o alias para uma versão do agente criada anteriormente. Em seguida, você configura seu aplicativo para fazer API chamadas para esse alias.

A versão é um snapshot que preserva o recurso na forma como está no momento em que foi criado. É possível continuar modificando o rascunho de trabalho e criar aliases (e, consequentemente, versões) do agente, conforme necessário. No Amazon Bedrock, você cria uma versão do agente criando um alias que aponta para a nova versão por padrão. O Amazon Bedrock cria versões em ordem numérica, começando em 1.

As versões são imutáveis porque atuam como um snapshot do agente no momento em que foi criado. Para fazer atualizações em um agente em produção, crie uma versão e configure a aplicação para fazer chamadas para o alias que aponta para essa versão.

Os aliases permitem que você alterne com eficiência entre diferentes versões do agente sem exigir que a aplicação acompanhe a versão. Por exemplo, é possível alterar um alias para apontar para uma versão anterior do agente se houver alterações que você precise reverter rapidamente.

Como implantar o agente

  1. Crie um alias e uma versão para o agente. Escolha a guia do seu método preferido e siga as etapas:

    Console
    Como criar um alias (e, opcionalmente, uma versão)

    1. Faça login no AWS Management Console usando uma IAMfunção com as permissões do Amazon Bedrock e abra o console do Amazon Bedrock em. https://console.aws.amazon.com/bedrock/

    2. No painel de navegação à esquerda, selecione Agentes. Escolha um agente na seção Agentes.

    3. Na seção Aliases, escolha Criar.

    4. Insira um Nome de alias exclusivo e forneça uma Descrição opcional.

    5. Em Associar uma versão, escolha uma das seguintes opções:

      • Para criar uma versão, escolha Criar uma versão e associá-la a esse alias.

      • Para usar uma versão existente, escolha Usar uma versão existente para associar esse alias. No menu suspenso, escolha a versão à qual você deseja associar o alias.

    6. Em Selecionar throughput, selecione uma das seguintes opções:

    7. Selecione Criar alias.

    API

    Para criar um alias para um agente, envie uma CreateAgentAliassolicitação com um endpoint de tempo de construção do Agents for Amazon Bedrock.

    Os campos a seguir são obrigatórios:

    Campo Caso de uso
    agentId Para especificar o ID do agente para o qual criar um alias.
    agentName Para especificar um nome para o alias.

    Os seguintes campos são opcionais:

    Campo Caso de uso
    description Para fornecer uma descrição do alias.
    routingConfiguration Para especificar uma versão à qual associar o alias (deixe em branco para criar uma versão) e um throughput provisionado a ser associado ao alias.
    clientToken Para garantir que a API solicitação seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.
    tags Para associar tags ao alias.

    Consulte exemplos de código

  2. Implante seu agente configurando seu aplicativo para criar um InvokeAgentsolicitação com um endpoint de tempo de execução do Agents for Amazon Bedrock. No campo agentAliasId, especifique o ID do alias que aponta para a versão do agente que você deseja usar.

    O fluxo de InvokeAgent resposta contém vários eventos com partes para cada parte da resposta em ordem. Opcionalmente, você pode ativar o streaming definindo o streamFinalResponse para true nas configurações de streaming.

    • Se seu agente estiver configurado com um Guardrail, você também poderá especificar o applyGuardrailInterval noStreamingConfigurations, para controlar a frequência com que uma ApplyGuardrail chamada é feita em caracteres de resposta de saída (por exemplo, a cada 50 caracteres)

    • Atualmente, o streaming de respostas só é suportado com o prompt de orquestração.

    • Atualmente, as citações não são compatíveis com streaming.

    • Certifique-se de que a função de execução do agente inclua a bedrock:InvokeModelWithResponseStream permissão para o modelo de agente configurado.