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 um agente
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.
**Aliases e versões**
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. Configure a aplicação para fazer chamadas de API 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.
## Pausar um agente implantado
Talvez seja necessário pausar temporariamente a execução de um agente. Por exemplo, durante manutenções, atualizações ou ao resolver problemas de desempenho. Para pausar um agente, use o alias do agente com a operação [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.html). Para pausar um agente, defina o campo `aliasInvocationState` como `REJECT_INVOCATIONS`. Para iniciar a execução do agente novamente, defina `aliasInvocationState` como `ACCEPT_INVOCATIONS`. Não é necessário fazer nenhuma modificação na política do IAM para pausar o agente.
Para verificar se um agente está pausado no momento, chame [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.html) e marque o campo `aliasInvocationState`. Também é possível verificar se há um alias no campo `aliasInvocationState` na resposta a [ListAgentAliases](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentAliases.html).
**Topics**
+ [Pausar um agente implantado](#agent-pause)
+ [Criar um alias para o agente](deploy-agent-proc.md)
+ [Visualizar informações sobre versões de agente no Amazon Bedrock](agents-version-view.md)
+ [Excluir uma versão de um agente no Amazon Bedrock](agents-version-delete.md)
+ [Visualizar as informações sobre os aliases de agentes no Amazon Bedrock.](agents-alias-view.md)
+ [Editar um alias de agente no Amazon Bedrock](agents-alias-edit.md)
+ [Excluir um alias de agente no Amazon Bedrock](agents-alias-delete.md)
# Criar um alias para o agente
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).
------
# Visualizar informações sobre versões de agente no Amazon Bedrock
Depois de criar uma versão do agente, é possível visualizar informações sobre ela ou excluí-la. Só é possível criar uma versão de agente criando um alias.
Para saber como visualizar informações sobre as versões de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como visualizar informações sobre uma versão de agente**
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. Escolha a versão a ser visualizada na seção **Versões**.
1. Para visualizar detalhes sobre o modelo, os grupos de ação ou as bases de conhecimento anexadas à versão do agente, escolha o nome das informações que deseja visualizar. Não é possível modificar nenhuma parte de uma versão. Para fazer modificações no agente, use o rascunho de trabalho e crie uma versão.
------
#### [ API ]
Para obter ter sobre a versão um agente, envie uma solicitação [GetAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentVersion.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). Especifique o `agentId` e o `agentVersion`.
Para listar as informações sobre as versões de um agente, envie uma solicitação [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.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) e especifique o `agentId`. É possível especificar os seguintes parâmetros opcionais:
****
| Campo | Descrição breve |
| --- | --- |
| maxResults | O número máximo de resultados a serem apresentados em uma resposta. |
| nextToken | Se houver mais resultados do que o número especificado no campo maxResults, a resposta exibirá um valor de nextToken. Para ver o próximo lote de resultados, envie o valor de nextToken em outra solicitação. |
------
# Excluir uma versão de um agente no Amazon Bedrock
Para saber como excluir uma versão de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como excluir uma versão de um agente**
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. Para escolher a versão a ser excluída, na seção **Versões**, escolha o botão de opção ao lado da versão a ser excluída.
1. Escolha **Excluir**.
1. É exibida uma caixa de diálogo avisando sobre as consequências da exclusão. Para confirmar que deseja excluir a versão, insira **delete** no campo de entrada e escolha **Excluir**.
1. Um banner é exibido para informar que a versão está sendo excluída. Quando a exclusão for concluída, um banner de sucesso será exibido.
------
#### [ API ]
Para excluir uma versão de um agente, envie uma solicitação [DeleteAgentVersion](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentVersion.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). Por padrão, o parâmetro `skipResourceInUseCheck` é `false` e a exclusão será interrompida se o recurso estiver em uso. Se você definir `skipResourceInUseCheck` como `true`, o recurso será excluído mesmo que esteja em uso.
------
# Visualizar as informações sobre os aliases de agentes no Amazon Bedrock.
Para saber como visualizar informações sobre os aliases de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como visualizar os detalhes de um alias**
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. Escolha o alias a ser visualizado na seção **Aliases**.
1. É possível visualizar o nome e a descrição do alias e as tags associadas ao alias.
------
#### [ API ]
Para obter informações sobre o alias de um agente, envie uma solicitação [GetAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_GetAgentAlias.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). Especifique o `agentId` e o `agentAliasId`.
Para listar as informações sobre os aliases de um agente, envie uma solicitação [ListAgentVersions](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListAgentVersions.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) e especifique o `agentId`. É possível especificar os seguintes parâmetros opcionais:
****
| Campo | Descrição breve |
| --- | --- |
| maxResults | O número máximo de resultados a serem apresentados em uma resposta. |
| nextToken | Se houver mais resultados do que o número especificado no campo maxResults, a resposta exibirá um valor de nextToken. Para ver o próximo lote de resultados, envie o valor de nextToken em outra solicitação. |
Para visualizar as tags de um alias, envie uma solicitação [ListTagsForResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_ListTagsForResource.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) e inclua o nome do recurso da Amazon (ARN) do alias.
------
# Editar um alias de agente no Amazon Bedrock
Para saber como editar um alias de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como editar um alias**
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 o botão de opção ao lado do alias que você deseja editar. Escolha **Editar**.
1. Edite quaisquer campos existentes conforme necessário. Consulte mais informações sobre esses campos em [Implantar e usar um agente do Amazon Bedrock na aplicação](agents-deploy.md).
1. Selecione **Salvar**.
**Como adicionar ou remover tags associadas a um alias**
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. Escolha o alias para o qual você deseja gerenciar tags na seção **Aliases**.
1. Na seção **Tags**, escolha **Gerenciar tags**.
1. Para adicionar uma tag, escolha **Adicionar nova tag**. Insira uma **Chave** e, opcionalmente, um **Valor**. Para remover uma tag, selecione **Remover**. Para obter mais informações, consulte [Marcação de recursos do Amazon Bedrock](tagging.md).
1. Ao concluir a edição das tags, escolha **Enviar**.
------
#### [ API ]
Para editar o alias de um agente, envie uma solicitação [UpdateAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UpdateAgentAlias.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). Como todos os campos serão substituídos, inclua os campos que deseja atualizar e aqueles que deseja manter iguais.
Para adicionar tags a um alias, envie uma solicitação [TagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_TagResource.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) e inclua o nome do recurso da Amazon (ARN) do alias. O corpo da solicitação contém um campo `tags`, que é um objeto que contém um par de chave-valor que você especifica para cada tag.
Para remover tags de um alias, envie uma solicitação [UntagResource](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_UntagResource.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) e inclua o nome do recurso da Amazon (ARN) do alias. O parâmetro de solicitação `tagKeys` é uma lista que contém as chaves das tags que você deseja remover.
------
# Excluir um alias de agente no Amazon Bedrock
Para saber como excluir um alias de um agente, escolha a guia correspondente ao método de sua preferência e siga as etapas:
------
#### [ Console ]
**Como excluir um alias**
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. Para escolher o alias a ser excluído, na seção **Aliases**, escolha o botão de opção ao lado do alias que você deseja excluir.
1. Escolha **Excluir**.
1. É exibida uma caixa de diálogo avisando sobre as consequências da exclusão. Para confirmar que deseja excluir o alias, insira **delete** no campo de entrada e escolha **Excluir**.
1. Um banner é exibido informando que o alias está sendo excluído. Quando a exclusão for concluída, um banner de sucesso será exibido.
------
#### [ API ]
Para excluir um alias de um agente, envie uma solicitação [DeleteAgentAlias](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent_DeleteAgentAlias.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). Por padrão, o parâmetro `skipResourceInUseCheck` é `false` e a exclusão será interrompida se o recurso estiver em uso. Se você definir `skipResourceInUseCheck` como `true`, o recurso será excluído mesmo que esteja em uso.
```
def delete_agent_alias(self, agent_id, agent_alias_id):
"""
Deletes an alias of an Amazon Bedrock agent.
:param agent_id: The unique identifier of the agent that the alias belongs to.
:param agent_alias_id: The unique identifier of the alias to delete.
:return: The response from Amazon Bedrock Agents if successful, otherwise raises an exception.
"""
try:
response = self.client.delete_agent_alias(
agentId=agent_id, agentAliasId=agent_alias_id
)
except ClientError as e:
logger.error(f"Couldn't delete agent alias. {e}")
raise
else:
return response
```
Para obter mais informações, consulte [Olá, agentes do Amazon Bedrock](bedrock-agent_example_bedrock-agent_Hello_section.md).
------