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 usar um agente do Amazon Bedrock na aplicação Antes de usar um agente, você deve criar um alias para implantá-lo. Em seguida, você pode usar o agente em sua aplicação chamando a operaçã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). Nesta seção, você aprenderá a criar e gerenciar um alias e a chamar o agente em uma aplicação. **Topics** + [Implantar um agente](deploy-agent.md) + [Invocar um agente por meio de sua aplicação](agents-invoke-agent.md) # 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). ------ # Invocar um agente por meio de sua aplicação Use o agente em uma 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). Por padrão, a resposta de `InvokeAgent` inclui um fragmento que contém a resposta completa do agente, que pode levar algum tempo para ser concluída. Como alternativa, você pode configurar `InvokeAgent` para transmitir a resposta em vários fragmentos menores. Isso diminui a latência da resposta inicial do agente. **Respostas de streaming** Opcionalmente, é possível habilitar o streaming da resposta definindo `streamFinalResponse` como `true` nas configurações de streaming ([StreamingConfigurations](https://docs.aws.amazon.com/bedrock/latest/APIReference/API_agent-runtime_StreamingConfigurations.html)). O fluxo de resposta contém vários eventos com fragmentos em ordem para cada parte da resposta. Para transmitir respostas, o perfil de execução do agente deve incluir a permissão `bedrock:InvokeModelWithResponseStream` para o modelo de agente configurado. Para obter mais informações, consulte [Permissões baseadas em identidade para o perfil de serviço de agentes](agents-permissions.md#agents-permissions-identity). Se o agente estiver configurado com uma barreira de proteção, também será possível especificar `applyGuardrailInterval` em `StreamingConfigurations`, para controlar a frequência com que uma chamada `ApplyGuardrail` é feita em caracteres de resposta de saída (por exemplo, a cada cinquenta caracteres). Por padrão, o intervalo da barreira de proteção é definido como cinquenta caracteres. Se um intervalo maior for especificado, a resposta será gerada em fragmentos maiores com menos chamadas `ApplyGuardrail`. Os exemplos a seguir mostram a resposta gerada para a string de entrada *Hello, I am an Agent*. **Exemplo de resposta em fragmentos: intervalo definido para três caracteres** ``` 'Hel', 'lo, ', 'I am', ' an', ' Age', 'nt' ``` Cada fragmento tem pelo menos três caracteres, exceto o último fragmento. **Exemplo de resposta em fragmentos: intervalo definido para vinte caracteres** ``` 'Hello, I am an Agent' ``` ## Invocar um agente O exemplo Python a seguir mostra como chamar a operaçã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) e exibir a saída do agente, bem como qualquer informação de [rastreamento](trace-events.md) gerada pela chamada. **Como invocar um agente** 1. Crie um agente seguindo as instruções em [Criar e configurar o agente manualmente](agents-create.md). Anote o ID do agente. Se necessário, você pode obter o ID posteriormente. Para obter mais informações, consulte [Obter informações sobre um agente](agents-view.md). 1. Crie um alias para o agente seguindo as instruções em [Criar um alias para o agente](deploy-agent-proc.md). Anote o ID do alias. Se necessário, você pode obter o ID posteriormente. Para obter mais informações, consulte [Visualizar as informações sobre os aliases de agentes no Amazon Bedrock.](agents-alias-view.md). 1. Execute o código a seguir. Atualize o valor `agent_id` para o ID do agente e o valor `alias_id` para o ID do alias do agente. Para transmitir a resposta do agente, altere o valor de `streamFinalResponse` para `True`. Também é possível alterar o intervalo da barreira de proteção alterando o valor de `applyGuardrailInterval`. ``` import boto3 import logging from botocore.exceptions import ClientError logging.basicConfig(level=logging.INFO) logger = logging.getLogger(__name__) def invoke_agent(client, agent_id, alias_id, prompt, session_id): response = client.invoke_agent( agentId=agent_id, agentAliasId=alias_id, enableTrace=True, sessionId = session_id, inputText=prompt, streamingConfigurations = { "applyGuardrailInterval" : 20, "streamFinalResponse" : False } ) completion = "" for event in response.get("completion"): #Collect agent output. if 'chunk' in event: chunk = event["chunk"] completion += chunk["bytes"].decode() # Log trace output. if 'trace' in event: trace_event = event.get("trace") trace = trace_event['trace'] for key, value in trace.items(): logging.info("%s: %s",key,value) print(f"Agent response: {completion}") if __name__ == "__main__": client=boto3.client( service_name="bedrock-agent-runtime" ) agent_id = "AGENT_ID" alias_id = "ALIAS_ID" session_id = "MY_SESSION_ID" prompt = "Prompt to send to agent" try: invoke_agent(client, agent_id, alias_id, prompt, session_id) except ClientError as e: print(f"Client error: {str(e)}") logger.error("Client error: %s", {str(e)}) ```