아마존 베드록에서 에이전트 생성 - Amazon Bedrock

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

아마존 베드록에서 에이전트 생성

Amazon Bedrock으로 에이전트를 생성하려면 다음 구성 요소를 설정합니다.

  • 에이전트의 구성: 에이전트의 용도를 정의하고 에이전트가 프롬프트와 응답을 생성하는 데 사용하는 기초 모델 (FM) 을 나타냅니다.

  • 다음 중 하나 이상:

    • 에이전트가 수행하도록 설계된 작업을 정의하는 작업 그룹.

    • 검색 및 쿼리를 허용하여 에이전트의 생성 기능을 보강하기 위한 데이터 소스의 지식 베이스입니다.

이름만 있는 에이전트는 최소한으로 만들 수 있습니다. 테스트하거나 배포할 수 있도록 에이전트를 준비하려면 최소한 다음 구성 요소를 구성해야 합니다.

구성 설명
에이전트 리소스 역할 에이전트에서 API 작업을 호출할 권한이 있는 서비스 역할의 ARN
파운데이션 모델 (FM) 에이전트가 오케스트레이션을 수행하기 위해 호출할 수 있는 FM
지침 에이전트가 수행해야 하는 작업과 에이전트가 사용자와 상호 작용하는 방식을 설명하는 자연어

또한 에이전트를 위한 작업 그룹 또는 지식 베이스를 하나 이상 구성해야 합니다. 작업 그룹이나 지식 기반이 없는 에이전트를 준비하면 FM, 지침 및 기본 프롬프트 템플릿에 기반한 응답만 반환합니다.

에이전트를 만드는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

Console
에이전트를 생성하려면

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

  2. 왼쪽 탐색 창에서 에이전트를 선택합니다.

  3. 에이전트 섹션에서 에이전트 생성을 선택합니다.

  4. (선택 사항) 에이전트에 대해 자동으로 생성된 이름을 변경하고 이에 대한 설명 (선택 사항) 을 제공하십시오.

  5. 생성을 선택합니다. 에이전트가 생성되고 새로 만든 에이전트의 에이전트 빌더로 이동하여 에이전트를 구성할 수 있습니다.

  6. 다음 절차를 계속 수행하여 에이전트를 구성하거나 나중에 에이전트 빌더로 돌아갈 수 있습니다.

에이전트를 구성하려면

  1. 아직 에이전트 빌더에 접속하지 않았다면 다음과 같이 하세요.

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

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

    3. 에이전트 빌더에서 편집을 선택합니다.

  2. 에이전트 세부 정보 섹션에서 다음과 같은 구성을 설정할 수 있습니다.

    1. 에이전트 이름 또는 에이전트 설명을 편집합니다.

    2. 에이전트 리소스 역할의 경우 다음 옵션 중 하나를 선택합니다.

      • 새 서비스 역할 생성 및 사용 — Amazon Bedrock에서 사용자 대신 서비스 역할을 생성하고 필요한 권한을 설정하도록 합니다.

      • 기존 서비스 역할 사용 — 이전에 설정한 사용자 지정 역할을 사용하십시오.

    3. 모델 선택에서는 상담원이 오케스트레이션 중에 호출할 FM을 선택합니다.

    4. 상담원을 위한 지침에 상담원에게 수행해야 할 작업과 사용자와 상호 작용하는 방법을 알려주는 세부 정보를 입력합니다. 지침은 오케스트레이션 프롬프트 템플릿의 $structions$ 자리 표시자를 대체합니다. 다음은 지침의 예시입니다.

      You are an office assistant in an insurance agency. You are friendly and polite. You help with managing insurance claims and coordinating pending paperwork.

    5. 추가 설정을 확장하면 다음 구성을 수정할 수 있습니다.

      사용자 입력 - 정보가 충분하지 않은 경우 상담원이 사용자에게 추가 정보를 요청하도록 허용할지 여부를 선택합니다.

      • Enabled를 선택하면 에이전트는 작업 그룹의 API를 호출해야 하지만 API 요청을 완료하는 데 필요한 정보가 충분하지 않은 경우 사용자에게 추가 정보를 요청하는 Observation을 반환합니다.

      • Disabled (사용 안 함) 를 선택하면 에이전트는 사용자에게 추가 세부 정보를 요청하지 않고 대신 사용자에게 작업을 완료하는 데 필요한 정보가 충분하지 않다고 알립니다.

      • KMS 키 선택 — (선택 사항) 기본적으로 AWS는 AWS 관리 키로 에이전트 리소스를 암호화합니다. 자체 고객 관리 키로 에이전트를 암호화하려면 KMS 키 선택 섹션에서 암호화 설정 사용자 지정 (고급) 을 선택합니다. 새 키를 생성하려면 AWS KMS 키 생성을 선택한 다음 이 창을 새로 고칩니다. 기존 키를 사용하려면 AWS KMS 키 선택에서 키를 선택합니다.

      • 유휴 세션 제한 시간 — 기본적으로 Amazon Bedrock 상담원과의 세션에서 사용자가 30분 동안 응답하지 않으면 상담원은 더 이상 대화 기록을 보관하지 않습니다. 대화 기록은 상호작용을 재개하고 대화에서 컨텍스트로 응답을 보강하는 데 사용됩니다. 이 기본 시간을 변경하려면 세션 제한 시간 필드에 숫자를 입력하고 시간 단위를 선택하십시오.

    6. IAM 권한 섹션의 경우 에이전트 리소스 역할에서 서비스 역할을 선택합니다. Amazon Bedrock에서 사용자 대신 서비스 역할을 생성하도록 하려면 [Create] 를 선택하고 새 서비스 역할을 사용하십시오. 이전에 생성한 사용자 지정 역할을 사용하려면 기존 서비스 역할 사용을 선택합니다.

      참고

      Amazon Bedrock이 사용자를 위해 생성하는 서비스 역할에는 미리 보기 중인 기능에 대한 권한은 포함되지 않습니다. 이러한 기능을 사용하려면 서비스 역할에 올바른 권한을 추가하십시오.

    7. (선택 사항) 기본적으로 에이전트 리소스를 a로 AWS AWS 관리형 키암호화합니다. 자체 고객 관리 키로 에이전트를 암호화하려면 KMS 키 선택 섹션에서 암호화 설정 사용자 지정 (고급) 을 선택합니다. 새 키를 생성하려면 키 생성을 선택한 다음 이 창을 AWS KMS 새로 고치십시오. 기존 키를 사용하려면 키 선택에서 키를 선택합니다. AWS KMS

    8. (선택 사항) 태그를 이 에이전트와 연결하려면 태그 — 선택 섹션에서 새 태그 추가를 선택하고 키-값 쌍을 제공합니다.

    9. 에이전트 구성 설정을 완료했으면 다음을 선택합니다.

  3. 작업 그룹 섹션에서 추가를 선택하여 에이전트에 작업 그룹을 추가할 수 있습니다. 작업 그룹 설정에 대한 자세한 내용은 을 참조하십시오Amazon Bedrock 에이전트를 위한 작업 그룹 생성. 상담원에 작업 그룹을 추가하는 방법을 알아보려면 을 참조하십시오Amazon Bedrock에서 에이전트에 액션 그룹 추가.

  4. 지식 기반 섹션에서 추가를 선택하여 지식 그룹을 상담원과 연결할 수 있습니다. 지식창고 설정에 대한 자세한 내용은 을 참조하십시오아마존 베드록용 지식 베이스. 지식베이스를 상담원과 연결하는 방법을 알아보려면 을 참조하십시오지식베이스를 Amazon Bedrock 에이전트와 연결하세요.

  5. 가드레일 세부 정보 섹션에서 편집을 선택하여 가드레일을 상담원과 연결하여 유해한 콘텐츠를 차단하고 필터링할 수 있습니다. 가드레일 선택 아래의 드롭다운 메뉴에서 사용하려는 가드레일을 선택한 다음 가드레일 버전에서 사용할 버전을 선택합니다. 보기를 선택하여 가드레일 설정을 볼 수 있습니다. 자세한 정보는 아마존 베드락용 가드레일을 참조하세요.

  6. 고급 프롬프트 섹션에서 편집을 선택하여 오케스트레이션의 각 단계에서 에이전트가 FM에 보내는 프롬프트를 사용자 지정할 수 있습니다. 사용자 지정에 사용할 수 있는 프롬프트 템플릿에 대한 자세한 내용은 을 참조하십시오. Amazon Bedrock의 고급 프롬프트 고급 프롬프트를 구성하는 방법에 대한 자세한 내용은 을 참조하십시오프롬프트 템플릿 구성.

  7. 에이전트 구성을 마치면 다음 옵션 중 하나를 선택합니다.

    • 에이전트 빌더를 계속 사용하려면 [Save] 를 선택합니다. 그런 다음 테스트 창에서 업데이트된 구성으로 에이전트를 테스트할 수 있도록 에이전트를 준비할 수 있습니다. 에이전트를 테스트하는 방법을 알아보려면 을 참조하십시오아마존 베드락 에이전트 테스트.

    • 상담원 세부 정보 페이지로 돌아가려면 저장 후 종료를 선택합니다.

API

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

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

에이전트를 준비하고 테스트 또는 배포하여 테스트 또는 배포하려면 최소한 다음 필드를 포함해야 합니다. 원하는 경우 이러한 구성을 건너뛰고 나중에 UpdateAgent요청을 전송하여 구성할 수 있습니다.

필드 사용 사례
agentResourceRoleArn 에이전트에서 API 작업을 호출할 권한이 있는 서비스 역할의 ARN을 지정하려면
파운데이션/모델 상담원이 오케스트레이션할 기초 모델 (FM) 을 지정하려면
지시 상담원에게 취해야 할 일을 지시하는 지침을 제공하기 위함입니다. 오케스트레이션 프롬프트 템플릿의 $structions$ 자리 표시자에 사용됩니다.

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

필드 사용 사례
설명 에이전트가 수행하는 작업을 설명합니다.
유휴 세션 (TTL) InSeconds 에이전트가 세션을 종료하고 저장된 정보를 모두 삭제하는 기간입니다.
customerEncryptionKeyArn 에이전트 리소스를 암호화하기 위한 KMS 키의 ARN
tags 태그를 에이전트와 연결하는 방법.
promptOverrideConfiguration 오케스트레이션의 각 단계에서 FM으로 전송되는 프롬프트를 사용자 지정합니다.
가드레일 구성 에이전트에 가드레일을 추가하려면 가드레일의 ID 또는 ARN과 사용할 버전을 지정합니다.
clientToken API 요청이 한 번만 완료되도록 하기 위한 식별자입니다.

응답은 새로 만든 에이전트에 대한 세부 정보가 포함된 CreateAgent객체를 반환합니다. 에이전트를 만들지 못한 경우 응답의 CreateAgent개체는 문제 recommendedActions 해결에 필요한 failureReasons 목록과 목록을 반환합니다.