View a markdown version of this page

콘솔을 사용하여 인스턴스 시작하기 - Amazon Bedrock AgentCore
1단계: 용량 공급자 생성2단계: 용량 공급자를 사용하는 에이전트 런타임 생성3단계: 간접 호출 및 모니터링4단계: 정리다음 단계

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

콘솔을 사용하여 인스턴스 시작하기

이 자습서에서는 AWS Management Console을 사용하여 인스턴스 컴퓨팅 유형에서 에이전트를 호스팅하는 방법을 안내합니다. 먼저 EC2 인프라를 정의하는 용량 공급자를 생성한 다음 이를 사용하는 에이전트 런타임을 생성하고 마지막으로 에이전트를 호출하고 모니터링합니다.

사전 조건은 인스턴스 시작하기를 참조하세요.

1단계: 용량 공급자 생성

  1. Amazon Bedrock AgentCore 콘솔을 열고 런타임을 선택합니다.

  2. 용량 공급자 탭에서 용량 공급자 생성을 선택합니다.

  3. 용량 공급자 세부 정보에서 이름을 입력합니다. 유효한 문자는 문자, 숫자 및 밑줄입니다. 이름은 문자로 시작해야 하며 최대 48자까지 가능합니다.

  4. 운영 체제에서 EC2 인스턴스의 운영 체제를 선택합니다(예: Linux(64비트 x86)). 이는 환경과 호환되는 소프트웨어 및 애플리케이션을 결정합니다.

  5. 허용된 인스턴스 유형에서 워크로드 요구 사항에 맞는 EC2 인스턴스 유형을 최대 30개까지 선택합니다. vCPU, 메모리 및 CPU 제조업체를 기준으로 필터링하여 일치하는 항목을 찾습니다.

  6. 보안에서 인스턴스에 대한 네트워크 액세스를 제어하는 VPC를 선택합니다. 필요에 따라 추가 세부 정보에서 서브넷과 컨테이너 네트워크 모드를 구성합니다.

  7. (선택 사항) 스토리지 구성에서 볼륨 추가를 선택하여 영구 스토리지용 Amazon EBS 볼륨을 연결합니다. 볼륨 유형, 크기, 처리량, IOPS 및 암호화를 구성합니다. 이렇게 하면 볼륨 구성이 저장됩니다. AgentCore는 세션이 처음 시작될 때 각 볼륨을 생성합니다.

  8. 서비스 액세스에서 EC2 인스턴스에 연결된 인스턴스 프로파일( AgentCore에서 시스템 로그를 수집하는 데 사용, 에이전트 코드에 권한을 부여하지 않음)과 인프라 역할( AgentCore에서 사용자를 대신하여 EC2 인스턴스를 관리하는 데 사용)을 선택합니다. 기존 역할을 사용하거나 콘솔에서 새 역할을 생성하도록 할 수 있습니다.

  9. 용량 공급자 생성을 선택합니다. 용량 공급자는 CREATING 상태에서 시작되며 구성이 검증된 ACTIVE 후 상태가 됩니다.

참고

용량 공급자가 생성된 후에는 해당 설명만 편집할 수 있습니다. 인스턴스 유형, 네트워킹 또는 스토리지와 같은 다른 구성을 변경하려면 용량 공급자를 복제하고 중복 흐름에서 업데이트합니다.

2단계: 용량 공급자를 사용하는 에이전트 런타임 생성

  1. 런타임 페이지에서 런타임 생성을 선택합니다(또는 용량 공급자의 세부 정보 페이지에서 호스트 에이전트/도구를 선택합니다).

  2. 에이전트 또는 도구의 이름을 입력합니다.

  3. 컴퓨팅 유형에서 인스턴스를 선택합니다.

  4. 용량 공급자에서 기존 용량 공급자를 선택하거나 빠른 생성을 선택하여 미리 구성된 기본값을 인라인으로 사용하여 생성합니다.

  5. 에이전트/도구 소스에서 소스 유형을 선택하고 아티팩트를 제공합니다.

    • S3 소스 - 템플릿에서 시작하거나, .zip 파일을 업로드하거나, S3 버킷에서 기존 객체를 선택합니다.

    • ECR 컨테이너 - Amazon ECR 컨테이너 이미지 URI를 제공합니다.

  6. (선택 사항) 인바운드 인증, 고급 구성(보안, 환경 변수) 및 권한(IAM 실행 역할 및 KMS 암호화)을 구성합니다.

  7. 런타임 생성을 선택합니다. AgentCore는 버전 1과 이를 가리키는 DEFAULT 엔드포인트를 생성합니다.

참고

런타임을 생성한 후에는 컴퓨팅 유형을 변경할 수 없습니다.

3단계: 간접 호출 및 모니터링

  1. 런타임의 세부 정보 페이지에서 테스트를 선택하고 페이로드를 제공하거나 호출 코드 조각 보기를 사용하여 자체 애플리케이션에서 에이전트를 호출합니다.

  2. 새 세션의 첫 번째 호출은 계정에 EC2 인스턴스를 프로비저닝하고 에이전트를 시작하므로 일반적으로 이후 호출보다 오래 걸립니다. 동일한 세션에 대한 후속 호출이 훨씬 빠릅니다. AgentCore는 인스턴스를 EC2 콘솔 보기에서 기본적으로 숨겨지는 Amazon EC2 관리형 인스턴스로 프로비저닝합니다. EC2 DescribeInstances 관리형 인스턴스 가시성에 대한 자세한 내용은 관리형 리소스 가시성 설정을 참조하세요.

  3. 런타임의 세부 정보 페이지에서 관찰성 지표와 로그 및 추적을 사용하여 세션, 호출, 오류율 및 리소스 소비를 모니터링합니다.

4단계: 정리

계정에 프로비저닝된 Amazon EC2 인스턴스 및 Amazon EBS 볼륨에 대한 요금이 계속 부과되지 않도록 하려면 완료 시이 자습서를 위해 생성한 리소스를 정리합니다.

  1. AgentCore가 EC2 인스턴스와 영구 볼륨의 프로비저닝을 해제하도록 세션을 삭제합니다. 세션에서 단일 에이전트 런타임을 중지해도 인스턴스는 종료되지 않습니다. API 작업에 대한 자세한 내용은 AWS CLI 또는 SDK를 사용하여 인스턴스 시작하기를 참조하세요.

  2. 런타임, 엔드포인트 또는 해당 버전을 삭제하여 용량 공급자에서 런타임의 연결을 해제합니다.

  3. 런타임이 이를 참조하지 않으면 용량 공급자를 삭제합니다.

다음 단계