View a markdown version of this page

Comece a usar instâncias usando o console - Base da Amazônia AgentCore
Etapa 1: criar um provedor de capacidadeEtapa 2: criar um tempo de execução do agente que use o provedor de capacidadeEtapa 3: invocar e monitorarEtapa 4: limparPróximas etapas

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

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

Etapa 1: criar um provedor de capacidade

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

  2. Na guia Provedores de capacidade, escolha Criar provedor de capacidade.

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

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

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

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

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

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

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

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

  2. Insira um nome para o agente ou a ferramenta.

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

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

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

  6. (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).

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

  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.

  2. 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, 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.

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

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.

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

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

Próximas etapas