Crie um alias para seu agente - 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á.

Crie um alias para seu agente

O procedimento a seguir mostra como criar um alias e uma versão para seu agente. Depois de criar um alias, você pode usar o agente em seu aplicativo fazendo uma InvokeAgentsolicitação com um endpoint de tempo de execução do Agents for Amazon Bedrock.

Para criar um alias

  • 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 com uma identidade do IAM que tenha permissões para usar o console Amazon Bedrock. Em seguida, abra o console 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:

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

      • Para permitir que o agente execute a inferência do modelo em uma taxa maior usando um throughput provisionado que você comprou anteriormente para o modelo, selecione Throughput provisionado (PT) e escolha um modelo provisionado. Para obter mais informações, consulte Throughput provisionado.

    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 solicitação de API seja concluída apenas uma vez. Para obter mais informações, consulte Ensuring idempotency.
    tags Para associar tags ao alias. 
        def create_agent_alias(self, name, agent_id):
        """
        Creates an alias of an agent that can be used to deploy the agent.

        :param name: The name of the alias.
        :param agent_id: The unique identifier of the agent.
        :return: Details about the alias that was created.
        """
        try:
            response = self.client.create_agent_alias(
                agentAliasName=name, agentId=agent_id
            )
            agent_alias = response["agentAlias"]
        except ClientError as e:
            logger.error(f"Couldn't create agent alias. {e}")
            raise
        else:
            return agent_alias

    Para obter mais informações, consulte Olá, agentes do Amazon Bedrock.