에이전트 수동 생성 및 구성 - Amazon Bedrock

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

에이전트 수동 생성 및 구성

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

  • 에이전트의 목적을 정의하고 프롬프트 및 응답을 생성하는 데 사용하는 파운데이션 모델(FM)을 나타내는 에이전트의 구성입니다.

  • 다음 중 하나 이상:

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

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

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

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

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

에이전트를 생성하는 방법을 알아보려면 선택한 방법에 해당하는 탭을 선택하고 다음 단계를 따릅니다.

Console
에이전트를 생성하려면

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

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

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

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

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

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

에이전트를 구성하려면

  1. 아직 에이전트 빌더에 있지 않은 경우 다음을 수행합니다.

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

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

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

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

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

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

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

      • 기존 서비스 역할 사용 - 이전에 설정한 사용자 지정 역할을 사용합니다.

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

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

      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. 추가 설정 을 확장하면 다음 구성을 수정할 수 있습니다.

      • 코드 해석기 - (선택 사항) 에이전트가 코드 작성, 실행, 테스트 및 문제 해결과 관련된 작업을 처리할 수 있도록 할지 여부를 선택합니다. 세부 정보는 코드 해석으로 코드 생성, 실행 및 테스트을 참조하세요.

      • 사용자 입력 - (선택 사항) 정보가 충분하지 않은 경우 에이전트가 사용자에게 추가 정보를 요청하도록 허용할지 여부를 선택합니다. 세부 정보는 사용자에게 정보를 요청하도록 에이전트 구성을 참조하세요.

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

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

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

      참고

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

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

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

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

  3. 작업 그룹 섹션에서 추가를 선택하여 에이전트에 작업 그룹을 추가할 수 있습니다. 작업 그룹 설정에 대한 자세한 내용은 섹션을 참조하세요작업 그룹을 사용하여 에이전트가 수행할 작업을 정의합니다.. 에이전트에 작업 그룹을 추가하는 방법은 섹션을 참조하세요Amazon Bedrock에서 에이전트에 작업 그룹 추가.

  4. 지식 기반 섹션에서 지식 그룹을 에이전트와 연결하려면 추가를 선택할 수 있습니다. 지식 기반 설정에 대한 자세한 내용은 섹션을 참조하세요지식 베이스로 데이터 검색 및 AI 응답 생성. 지식 기반을 에이전트와 연결하는 방법을 알아보려면 섹션을 참조하세요지식 기반을 사용하여 에이전트에 대한 응답 생성 강화.

  5. 가드레일 세부 정보 섹션에서 편집을 선택하여 에이전트와 가드레일을 연결하여 유해한 콘텐츠를 차단하고 필터링할 수 있습니다. 가드레일 선택 의 드롭다운 메뉴에서 사용할 가드레일을 선택한 다음 Guardrail 버전 에서 사용할 버전을 선택합니다. 보기를 선택하여 Guardrail 설정을 볼 수 있습니다. 자세한 내용은 Amazon Bedrock 가드레일을 사용하는 모델의 유해 콘텐츠 차단 단원을 참조하십시오.

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

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

    • 에이전트 빌더 에 유지하려면 저장을 선택합니다. 그런 다음 에이전트를 준비하여 테스트 창에서 업데이트된 구성으로 테스트할 수 있습니다. 에이전트를 테스트하는 방법은 섹션을 참조하세요에이전트 동작 테스트 및 문제 해결.

    • 에이전트 세부 정보 페이지로 돌아가려면 저장 및 종료를 선택합니다.

API

에이전트를 생성하려면 CreateAgent Agents for Amazon Bedrock 빌드 시간 엔드포인트 를 사용한 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조).

코드 예제 참조

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

필드 사용 사례
agentResourceRoleArn 에이전트에서 API 작업을 호출할 수 있는 권한이 있는 서비스 역할ARN의 를 지정하려면
foundationModel 에이전트가 로 오케스트레이션할 파운데이션 모델(FM)을 지정하려면
지침 에이전트에게 수행할 작업을 알려주는 지침을 제공합니다. 오케스트레이션 프롬프트 템플릿의 $instructions$ 자리 표시자에 사용됩니다.

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

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

응답은 CreateAgent 새로 생성된 에이전트에 대한 세부 정보가 포함된 객체입니다. 에이전트를 생성하지 못하면 CreateAgent 응답의 객체는 문제 해결을 recommendedActions 위해 의 목록failureReasons과 의 목록을 반환합니다.