아마존 베드락 에이전트 배포하기 - Amazon Bedrock

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

아마존 베드락 에이전트 배포하기

Amazon Bedrock 에이전트를 처음 생성하면 작업 중인 초안 버전 (DRAFT) 과 작업 초안 버전을 가리키는 테스트 별칭 (TSTALIASID) 이 생깁니다. 에이전트를 변경하면 작업 초안에도 변경 내용이 적용됩니다. 상담원의 행동이 만족스러울 때까지 작업 초안을 반복해서 작성합니다. 그런 다음 에이전트의 별칭을 만들어 에이전트를 애플리케이션에 배포 및 통합하도록 설정할 수 있습니다.

에이전트를 배포하려면 별칭을 만들어야 합니다. 별칭 생성 중에 Amazon Bedrock은 에이전트 버전을 자동으로 생성합니다. 별칭은 이러한 새로 생성된 버전을 가리킵니다. 또는 이전에 생성한 에이전트 버전을 가리키도록 별칭을 지정할 수도 있습니다. 그런 다음 해당 별칭에 대한 API 호출을 수행하도록 애플리케이션을 구성합니다.

버전이란 리소스를 생성 당시의 상태로 보존하는 스냅샷입니다. 필요에 따라 작업 초안을 계속 수정하고 에이전트의 새 별칭 (따라서 버전) 을 만들 수 있습니다. Amazon Bedrock에서는 기본적으로 새 버전을 가리키는 별칭을 생성하여 에이전트의 새 버전을 생성합니다. Amazon Bedrock은 1부터 시작하여 번호순으로 버전을 생성합니다.

버전은 에이전트를 만들 때 에이전트의 스냅샷 역할을 하므로 변경할 수 없습니다. 프로덕션 환경에서 에이전트를 업데이트하려면 새 버전을 만들고 해당 버전을 가리키는 별칭을 호출하도록 애플리케이션을 설정해야 합니다.

별칭을 사용하면 애플리케이션에서 버전을 추적하지 않아도 에이전트의 여러 버전 간에 효율적으로 전환할 수 있습니다. 예를 들어 변경 사항을 빠르게 되돌릴 필요가 있는 경우 이전 버전의 에이전트를 가리키도록 별칭을 변경할 수 있습니다.

에이전트를 배포하려면
  1. 에이전트의 별칭과 버전을 만드세요. 선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

    Console
    별칭 (및 선택적으로 새 버전) 을 만들려면
    1. Amazon Bedrock 권한으로 IAM 역할을 AWS Management Console 사용하여 로그인하고 https://console.aws.amazon.com/bedrock/ 에서 Amazon Bedrock 콘솔을 엽니다.

    2. 왼쪽 탐색 창에서 에이전트를 선택합니다. 그런 다음 에이전트 섹션에서 에이전트를 선택합니다.

    3. 별칭 섹션에서 [Create] 를 선택합니다.

    4. 고유한 별칭 이름을 입력하고 설명 (선택 사항) 을 제공하십시오.

    5. 버전 연결에서 다음 옵션 중 하나를 선택합니다.

      • 새 버전을 만들려면 새 버전 만들기를 선택하고 이 별칭에 연결합니다.

      • 기존 버전을 사용하려면 기존 버전 사용을 선택하여 이 별칭을 연결합니다. 드롭다운 메뉴에서 별칭을 연결할 버전을 선택합니다.

    6. 처리량 선택에서 다음 옵션 중 하나를 선택합니다.

      • 상담원이 계정에 설정된 요율로 모델 추론을 실행하도록 하려면 온디맨드 (ODT) 를 선택합니다. 자세한 정보는 Amazon Bedrock의 할당량을 참조하세요.

      • 이전에 모델용으로 구매한 프로비저닝된 처리량을 사용하여 에이전트가 증가된 속도로 모델 추론을 실행하도록 하려면 PT (프로비저닝된 처리량) 를 선택한 다음 프로비저닝된 모델을 선택하세요. 자세한 정보는 Amazon Bedrock의 프로비저닝된 처리량을 참조하세요.

    7. 별칭 생성을 선택합니다.

    API

    에이전트의 별칭을 생성하려면 Amazon Bedrock용 에이전트 빌드 타임 엔드포인트를 사용하여 CreateAgentAlias요청 (요청 및 응답 형식과 필드 세부 정보는 링크 참조) 을 보내십시오.

    필수 필드는 다음과 같습니다.

    필드 사용 사례
    agentId 별칭을 생성할 에이전트의 ID를 지정하기 위해서입니다.
    agentName 별칭의 이름을 지정하려면

    다음 필드는 선택 사항입니다.

    필드 사용 사례
    설명 별칭에 대한 설명을 제공합니다.
    라우팅 컨피그레이션 별칭과 연결할 버전 (새 버전을 만들려면 공란으로 비워 두기) 및 별칭과 연결할 프로비저닝된 처리량을 지정합니다.
    clientToken API 요청이 한 번만 완료되도록 하기 위한 식별자입니다.
    tags 태그를 별칭과 연결하는 것.

    코드 예제를 참조하십시오.

  2. Amazon Bedrock용 에이전트 런타임 엔드포인트로 InvokeAgent요청을 보내도록 애플리케이션을 설정 (요청 및 응답 형식과 필드 세부 정보는 링크 참조) 하여 에이전트를 배포합니다. agentAliasId필드에 사용하려는 에이전트의 버전을 가리키는 별칭의 ID를 지정합니다.

에이전트의 버전과 별칭을 관리하는 방법을 알아보려면 다음 항목 중에서 선택하십시오.