

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

# Comece a usar instâncias usando o console
<a name="runtime-instances-get-started-console"></a>

Este tutorial explica como hospedar um agente no tipo de ** computação ** Instances usando o AWS Management Console. Primeiro, você cria um provedor de [ capacidade ](runtime-instances-how-it-works.md#runtime-instances-capacity-provider) que define a infraestrutura do EC2, depois cria um tempo de execução do agente que a usa e, finalmente, invoca e monitora o agente.

Para ver os pré-requisitos, consulte [ Começar a usar instâncias. ](runtime-instances-getting-started.md)

## Etapa 1: criar um provedor de capacidade
<a name="runtime-instances-console-create-cp"></a>

1. Abra o AgentCore console Amazon Bedrock e escolha ** Runtime**.

1. Na ** guia Provedores de ** capacidade, escolha ** Criar provedor de capacidade**.

1. Em Detalhes ** do provedor de capacidade**, insira um ** Nome**. Os caracteres válidos são letras, dígitos e sublinhados; o nome deve começar com uma letra e pode ter até 48 caracteres.

1. **Em Sistema ** operacional, escolha o sistema operacional para suas instâncias do EC2 (por exemplo, ** Linux (x86 de 64 bits))**. Isso determina quais softwares e aplicativos são compatíveis com seu ambiente.

1. Para os tipos de instância ** permitidos**, escolha até 30 tipos de instância do EC2 que atendam aos seus requisitos de carga de trabalho. Filtre por fabricante de vCPU, memória e CPU para encontrar uma combinação.

1. Em ** Segurança**, escolha a ** VPC ** que controla o acesso à rede para suas instâncias. Opcionalmente, configure sub-redes e o modo de rede de contêineres em ** Detalhes adicionais. **

1. (Opcional) Em Configuração ** de armazenamento**, escolha ** Adicionar volume ** para anexar um volume do Amazon EBS para armazenamento persistente. Configure o tipo, tamanho, taxa de transferência, IOPS e criptografia do volume. Isso salva a configuração do volume; AgentCore cria cada volume na primeira inicialização da sessão.

1. Em Acesso ao ** serviço**, escolha o perfil da instância anexado à instância do EC2 (usado pelo AgentCore para coletar registros do sistema; ele não concede permissões ao código do seu agente) e a função de ** infraestrutura ** (usada pelo AgentCore para gerenciar instâncias do EC2 em seu nome). Você pode usar funções existentes ou permitir que o console crie novas.

1. Escolha **Criar provedor de capacidade**. O provedor de capacidade começa em um `CREATING` estado e se torna `ACTIVE` depois que sua configuração é validada.

**nota**  
Depois que um provedor de capacidade é criado, somente sua descrição pode ser editada. Para alterar outras configurações, como tipos de instância, rede ou armazenamento, duplique o provedor de capacidade e faça suas atualizações no fluxo duplicado.

## Etapa 2: criar um tempo de execução do agente que use o provedor de capacidade
<a name="runtime-instances-console-create-runtime"></a>

1. Na ** página ** Tempo de execução, escolha ** Criar tempo de execução ** (ou, na página de detalhes do provedor de capacidade, escolha ** Host agent/tool**).

1. Insira um ** nome ** para o agente ou a ferramenta.

1. Em Tipo ** de computação**, escolha ** Instâncias**.

1. Para Provedor de ** capacidade**, escolha um provedor de capacidade existente ou escolha ** Criação rápida ** para criar um com padrões pré-configurados em linha.

1. Em ** Agent/tool fonte**, escolha seu tipo de fonte e forneça o artefato:
   +  **Fonte do S3 ** — Comece com um modelo, faça upload de um `.zip` arquivo ou escolha um objeto existente em um bucket do S3.
   +  **Contêiner ECR ** — Forneça um URI de imagem de contêiner do Amazon ECR.

1. (Opcional) Configure a autenticação de ** entrada**, configurações ** avançadas ** (segurança, variáveis de ambiente) e ** permissões ** (função de execução do IAM e criptografia KMS).

1. Escolha ** Criar tempo de execução**. AgentCore cria a versão 1 e um `DEFAULT` endpoint que aponta para ela.

**nota**  
Você não pode alterar o tipo de computação depois de criar o tempo de execução.

## Etapa 3: invocar e monitorar
<a name="runtime-instances-console-invoke"></a>

1. Na página de detalhes do tempo de execução, escolha ** Testar ** e fornecer uma carga útil ou use o ** trecho de código de invocação ** Exibir para chamar o agente a partir do seu próprio aplicativo.

1. A primeira invocação para uma nova sessão provisiona uma instância do EC2 em sua conta e inicia o agente, portanto, normalmente leva mais tempo do que as invocações posteriores. As invocações subsequentes para a mesma sessão são muito mais rápidas. AgentCore provisiona a instância como uma instância gerenciada do [ Amazon EC2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html), que está oculta das visualizações do console do EC2 e `DescribeInstances` por padrão. Para obter mais informações sobre a visibilidade da instância gerenciada, consulte a configuração de visibilidade de recursos [ gerenciados](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/amazon-ec2-managed-instances.html#managed-resource-visibility-settings).

1. Use as ** métricas ** de observabilidade, ** os registros e o rastreamento ** na página de detalhes do tempo de execução para monitorar sessões, invocações, taxa de erro e consumo de recursos.

## Etapa 4: limpar
<a name="runtime-instances-console-cleanup"></a>

Para evitar cobranças contínuas pelas instâncias do Amazon EC2 e pelos volumes do Amazon EBS provisionados em sua conta, limpe os recursos que você criou para este tutorial quando terminar:

1. Exclua a sessão para AgentCore desprovisionar a instância do EC2 e seus volumes persistentes. Interromper o tempo de execução de um único agente em uma sessão não encerra a instância. Para obter mais informações sobre as operações da API, consulte [ Comece a usar instâncias usando a AWS CLI ou o SDK](runtime-instances-get-started-cli.md).

1. Desassocie o tempo de execução do provedor de capacidade excluindo o tempo de execução, seus endpoints ou suas versões.

1. Exclua o provedor de capacidade quando nenhum tempo de execução fizer referência a ele.

## Próximas etapas
<a name="runtime-instances-console-next-steps"></a>
+  [Instâncias](runtime-instances-how-it-works.md) 
+  [Compare os tipos de computação ](runtime-instances-how-it-works.md#runtime-instances-compute-comparison) 
+  [Modelo de segurança e permissões para instâncias de tempo de execução ](runtime-instances-security.md) 