

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

# Criar um alias para o agente
<a name="deploy-agent-proc"></a>

O procedimento a seguir mostra como criar um alias e uma versão para o agente. Depois de criar um alias, você pode usar o agente em sua aplicação fazendo uma solicitação [https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_InvokeAgent.html) com um [endpoint de runtime do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-rt). 

**Para criar um alias**
+ Crie um alias e uma versão para o agente. Escolha a guia correspondente ao método de sua preferência e siga as etapas:

------
#### [ Console ]

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

  1. Faça login no Console de gerenciamento da AWS com uma identidade do IAM que tenha permissões para usar o console do Amazon Bedrock. Em seguida, abra o console do Amazon Bedrock em [https://console.aws.amazon.com/bedrock/](https://console.aws.amazon.com/bedrock).

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

  1. Na seção **Aliases**, escolha **Criar**.

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

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

  1. 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](quotas.md).
     + 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 [Aumentar a capacidade de invocação do modelo com throughput provisionado no Amazon Bedrock](prov-throughput.md).

  1. Selecione **Criar alias**.

------
#### [ API ]

  Para criar um alias para um agente, envie uma solicitação [CreateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_CreateAgentAlias.html) com um [endpoint de tempo de compilação do recurso Agentes para Amazon Bedrock](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#bra-bt).

  Os seguintes campos são obrigatórios:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/deploy-agent-proc.html)

  Os seguintes campos são opcionais:  
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/bedrock/latest/userguide/deploy-agent-proc.html)

  ```
      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](bedrock-agent_example_bedrock-agent_Hello_section.md).

------