Implemente um agente Amazon Bedrock - 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á.

Implemente um agente Amazon Bedrock

Ao criar pela primeira vez um agente do Amazon Bedrock, você tem uma versão de rascunho de trabalho (DRAFT) e um alias de teste (TSTALIASID) que aponta para a versão de rascunho de trabalho. Quando você faz alterações em seu agente, as alterações se aplicam ao rascunho de trabalho. Você repete seu rascunho de trabalho até ficar satisfeito com o comportamento do seu agente. Em seguida, você pode configurar seu agente para implantação e integração em seu aplicativo criando aliases de seu agente.

Para implantar seu agente, você deve criar um alias. Durante a criação do alias, o Amazon Bedrock cria automaticamente uma versão do seu agente. O alias aponta para essa versão recém-criada. Como alternativa, você pode apontar o alias para uma versão criada anteriormente do seu agente. Em seguida, você configura seu aplicativo para fazer chamadas de API para esse alias.

Uma versão é um instantâneo que preserva o recurso como ele existe no momento em que foi criado. Você pode continuar modificando o rascunho de trabalho e criando novos aliases (e, consequentemente, versões) do seu agente conforme necessário. No Amazon Bedrock, você cria uma nova versão do seu 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 instantâneo do seu agente no momento em que você o criou. Para fazer atualizações em um agente em produção, você deve criar uma nova versão e configurar seu aplicativo para fazer chamadas para o alias que aponta para essa versão.

Com aliases, você pode alternar eficientemente entre diferentes versões do seu agente sem exigir que o aplicativo acompanhe a versão. Por exemplo, você pode alterar um alias para apontar para uma versão anterior do seu agente se houver alterações que você precise reverter rapidamente.

Para implantar seu agente

  1. Crie um alias e uma versão do seu agente. Selecione a guia correspondente ao seu método de escolha e siga as etapas.

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

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

    2. Selecione Agentes no painel de navegação esquerdo. Em seguida, 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 nova versão, escolha Criar uma nova 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 taxa de transferência, selecione uma das seguintes opções:

      • Para permitir que seu agente execute a inferência do modelo com as taxas definidas para sua conta, selecione Sob demanda (ODT). Para ter mais informações, consulte Cotas do Amazon Bedrock.

      • Para permitir que seu agente execute a inferência do modelo em uma taxa maior usando uma taxa de transferência provisionada que você comprou anteriormente para o modelo, selecione Taxa de transferência provisionada (PT) e, em seguida, selecione um modelo provisionado. Para ter mais informações, consulte Taxa de transferência provisionada para Amazon Bedrock.

    7. Selecione Criar alias.

    API

    Para criar um alias para um agente, envie uma CreateAgentAliassolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) 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 a ID do agente para o qual criar um alias.
    agentName Para especificar um nome para o alias.

    Os campos a seguir são opcionais:

    Campo Caso de uso
    description Para fornecer uma descrição do alias.
    Configuração de roteamento Para especificar uma versão à qual associar o alias (deixe em branco para criar uma nova versão) e uma taxa de transferência provisionada para associar ao alias.
    clientToken Identificador para garantir que a solicitação da API seja concluída apenas uma vez.
    tags Para associar tags ao alias.

    Veja exemplos de código

  2. Implante seu agente configurando seu aplicativo para fazer uma InvokeAgentsolicitação (consulte o link para ver os formatos de solicitação e resposta e detalhes do campo) com um endpoint de tempo de execução do Agents for Amazon Bedrock. No agentAliasId campo, especifique a ID do alias que aponta para a versão do agente que você deseja usar.

Para saber como gerenciar versões e aliases de agentes, selecione um dos tópicos a seguir.

Tópicos