애플리케이션에 Amazon Bedrock 에이전트 배포 및 통합 - Amazon Bedrock

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

애플리케이션에 Amazon Bedrock 에이전트 배포 및 통합

Amazon Bedrock 에이전트를 처음 생성할 때 작업 초안 버전(DRAFT)과 작업 초안 버전을 가리키는 테스트 별칭(TSTALIASID)이 있습니다. 에이전트를 변경하면 변경 사항이 작업 초안에 적용됩니다. 에이전트의 동작에 만족할 때까지 작업 초안을 반복합니다. 그런 다음 에이전트의 별칭을 생성하여 배포 및 애플리케이션 통합을 위해 에이전트를 설정할 수 있습니다.

에이전트를 배포하려면 별칭을 생성해야 합니다. 별칭을 생성하는 동안 Amazon Bedrock은 에이전트 버전을 자동으로 생성합니다. 별칭은 이러한 새로 생성된 버전을 가리킵니다. 또는 별칭을 이전에 생성한 버전의 에이전트로 가리킬 수 있습니다. 그런 다음 애플리케이션을 구성하여 해당 별칭을 API 호출합니다.

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

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

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

에이전트를 배포하려면

  1. 에이전트의 별칭 및 버전을 생성합니다. 선택한 메서드에 해당하는 탭을 선택하고 다음 단계를 따릅니다.

    Console
    별칭(및 선택적으로 새 버전)을 생성하려면

    1. Amazon Bedrock 권한이 있는 역할을 AWS Management Console 사용하여 에 로그인하고 에서 Amazon Bedrock 콘솔을 엽니다https://console.aws.amazon.com/bedrock/. IAM

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

    3. 별칭 섹션에서 생성 을 선택합니다.

    4. 고유한 별칭 이름을 입력하고 선택적 설명 을 제공합니다.

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

      • 새 버전을 생성하려면 새 버전 생성을 선택하고 이 별칭 에 연결합니다.

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

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

      • 에이전트가 계정에 설정된 속도로 모델 추론을 실행하도록 하려면 온디맨드(ODT)를 선택합니다. 자세한 내용은 Amazon Bedrock의 할당량 단원을 참조하십시오.

      • 이전에 모델에 대해 구매한 프로비저닝된 처리량을 사용하여 에이전트가 증가된 속도로 모델 추론을 실행하도록 하려면 프로비저닝된 처리량(PT)을 선택한 다음 프로비저닝된 모델을 선택합니다. 자세한 내용은 Amazon Bedrock의 프로비저닝된 처리량으로 모델 호출 용량 증가 단원을 참조하십시오.

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

    API

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

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

    필드 사용 사례
    agentId 별칭을 생성할 에이전트의 ID를 지정합니다.
    agentName 별칭의 이름을 지정합니다.

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

    필드 사용 사례
    설명 별칭에 대한 설명을 제공합니다.
    routingConfiguration 별칭을 에 연결할 버전(새 버전을 생성하려면 비워둠) 및 별칭과 연결할 프로비저닝된 처리량을 지정합니다.
    clientToken API 요청이 한 번만 완료되도록 하는 식별자입니다.
    tags 태그를 별칭과 연결합니다.

    코드 예제 참조

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