아마존 베드락 에이전트 테스트 - Amazon Bedrock

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

아마존 베드락 에이전트 테스트

에이전트를 생성하고 나면 작업 초안이 작성됩니다. 규격 초안은 에이전트를 반복적으로 빌드하는 데 사용할 수 있는 에이전트 버전입니다. 상담원을 변경할 때마다 작업 초안이 업데이트됩니다. 상담원의 구성이 만족스러우면 상담원의 스냅샷인 버전과 버전을 가리키는 별칭을 만들 수 있습니다. 그런 다음 별칭을 호출하여 에이전트를 애플리케이션에 배포할 수 있습니다. 자세한 정보는 아마존 베드락 에이전트 배포하기을 참조하세요.

다음 목록은 에이전트를 테스트하는 방법을 설명합니다.

  • Amazon Bedrock 콘솔에서 측면에 있는 테스트 창을 열고 에이전트가 응답할 입력을 보냅니다. 작업 초안 또는 생성한 버전을 선택할 수 있습니다.

  • API에서 작업 초안은 DRAFT 버전입니다. 테스트 별칭이나 정적 버전을 가리키는 다른 InvokeAgent별칭과 함께 사용하여 에이전트에 입력을 보냅니다. TSTALIASID

에이전트의 행동 문제를 해결하는 데 도움이 되도록 Amazon Bedrock용 에이전트는 에이전트와의 세션 중에 추적을 볼 수 있는 기능을 제공합니다. 추적은 에이전트의 step-by-step 추론 프로세스를 보여줍니다. 추적에 대한 자세한 내용은 을 참조하십시오Amazon Bedrock의 트레이스 이벤트.

다음은 에이전트를 테스트하는 단계입니다. 선택한 방법에 해당하는 탭을 선택하고 단계를 따르세요.

Console
상담원을 테스트하려면

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

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

  3. 상담원 섹션의 상담원 목록에서 테스트하려는 상담원의 링크를 선택합니다.

  4. 테스트 창이 오른쪽 창에 나타납니다.

    참고

    테스트 창이 닫혀 있는 경우 상담원 세부 정보 페이지 또는 페이지 상단에서 테스트를 선택하여 다시 열 수 있습니다.

  5. 에이전트를 생성한 후에는 다음 방법 중 하나로 준비하여 작업 초안 변경 사항과 함께 패키징해야 합니다.

    • 테스트 창에서 준비를 선택합니다.

    • 작업 초안 페이지에서 페이지 상단의 준비를 선택합니다.

    참고

    작업 초안을 업데이트할 때마다 에이전트가 최신 변경 사항으로 에이전트를 패키징할 수 있도록 준비해야 합니다. 가장 좋은 방법은 항상 작업 초안 페이지의 에이전트 개요 섹션에서 에이전트의 마지막 준비 시간을 확인하여 에이전트를 최신 구성으로 테스트하고 있는지 확인하는 것입니다.

  6. 테스트할 별칭과 관련 버전을 선택하려면 테스트 창 상단의 드롭다운 메뉴를 사용하세요. 기본적으로 TestAlias: 작업 초안 조합이 선택됩니다.

  7. (선택 사항) 별칭의 프로비저닝된 처리량을 선택하려면 선택한 테스트 별칭 아래의 텍스트에 ODT 사용 또는 PT 사용이 표시됩니다. 프로비저닝된 처리량 모델을 만들려면 변경을 선택합니다. 자세한 정보는 Amazon Bedrock의 프로비저닝된 처리량을 참조하세요.

  8. 에이전트를 테스트하려면 메시지를 입력하고 [Run] 을 선택합니다. 응답이 생성될 때까지 기다리거나 생성된 후에 기다리는 동안 다음과 같은 옵션을 사용할 수 있습니다.

    • 프롬프트, 추론 구성, 각 단계 및 해당 작업 그룹 및 지식 베이스의 사용에 대한 에이전트의 추론 프로세스를 포함하여 에이전트의 오케스트레이션 프로세스의 각 단계에 대한 세부 정보를 보려면 추적 보기를 선택합니다. 추적은 실시간으로 업데이트되므로 응답이 반환되기 전에 확인할 수 있습니다. 단계의 추적을 확장하거나 축소하려면 단계 옆에 있는 화살표를 선택합니다. 트레이스 창 및 표시되는 세부 정보에 대한 자세한 내용은 을 참조하십시오Amazon Bedrock의 트레이스 이벤트.

    • 상담원이 지식창고를 호출하면 응답에 각주가 포함됩니다. 응답의 특정 부분에 대한 인용 정보가 들어 있는 S3 객체 링크를 보려면 관련 각주를 선택하십시오.

    • Lambda 함수를 사용하여 작업 그룹을 처리하는 대신 제어를 반환하도록 에이전트를 설정하는 경우 응답에는 예측된 작업과 해당 파라미터가 포함됩니다. 작업에 대한 API 또는 함수의 예제 출력 값을 제공한 다음 제출을 선택하여 에이전트 응답을 생성하십시오. 다음 이미지를 예시로 참조하세요.

      작업에 대한 예제 출력을 제공하기 위한 테스트 창 요청

    테스트 창에서 다음 작업을 수행할 수 있습니다.

    • 상담원과 새 대화를 시작하려면 새로 고침 아이콘을 선택합니다.

    • 트레이스 창을 보려면 확장 아이콘을 선택하세요. 추적 창을 닫으려면 축소 아이콘을 선택합니다.

    • 테스트 창을 닫으려면 오른쪽 화살표 아이콘을 선택합니다.

작업 그룹 및 지식 베이스를 활성화하거나 비활성화할 수 있습니다. 이 기능을 사용하면 다양한 설정으로 동작을 평가하여 업데이트해야 하는 작업 그룹이나 지식 베이스를 분리하여 에이전트 문제를 해결할 수 있습니다.

작업 그룹 또는 지식 베이스를 활성화하려면

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

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

  3. 상담원 섹션에서 상담원 목록에서 테스트하려는 상담원의 링크를 선택합니다.

  4. 상담원 세부 정보 페이지의 작업 초안 섹션에서 작업 초안 링크를 선택합니다.

  5. 작업 그룹 또는 지식베이스 섹션에서 상태를 변경하려는 작업 그룹 또는 지식창고의 상태를 마우스로 가리키십시오.

  6. 편집 버튼이 나타납니다. 편집 아이콘을 선택한 다음 드롭다운 메뉴에서 작업 그룹 또는 지식창고를 활성화할지 비활성화할지 선택합니다.

  7. 작업 그룹이 사용 안 함으로 설정된 경우 상담원은 작업 그룹을 사용하지 않습니다. 지식창고가 사용 중지된 경우 상담원은 지식창고를 사용하지 않습니다. 작업 그룹 또는 지식베이스를 활성화 또는 비활성화한 다음 테스트 창을 사용하여 에이전트의 문제를 해결하세요.

  8. Prepare를 선택하여 에이전트를 테스트하기 전에 변경한 내용을 에이전트에 적용하십시오.

API

에이전트를 처음으로 테스트하기 전에 Agents for Amazon Bedrock 빌드 타임 엔드포인트로 PrepareAgent요청 (요청 및 응답 형식과 필드 세부 정보는 링크 참조) 을 전송하여 작업 중인 초안 변경 사항과 함께 에이전트를 패키징해야 합니다. 요청에 포함시키십시오. agentId 변경 사항은 TSTALIASID 별칭이 가리키는 DRAFT 버전에 적용됩니다.

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

참고

작업 초안을 업데이트할 때마다 에이전트가 최신 변경 사항으로 에이전트를 패키징할 수 있도록 준비해야 합니다. Amazon Bedrock용 GetAgentAgents 빌드 타임 엔드포인트로 요청을 보내고 (요청 및 응답 형식과 필드 세부 정보는 링크 참조) 에이전트가 최신 구성으로 테스트하고 있는지 확인하는 것이 좋습니다. preparedAt

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

참고

는 AWS CLI 지원하지 않습니다. InvokeAgent

코드 예제 참조

요청에는 다음과 같은 필드가 있습니다.

  • 최소한 다음과 같은 필수 필드를 제공하십시오.

    필드 간단한 설명
    agentId 상담원 ID
    agentAliasId 별칭의 ID. 버전을 TSTALIASID 호출하는 데 사용합니다. DRAFT
    sessionId 세션의 영숫자 ID (2~100자)
    입력 텍스트 에이전트에게 메시지를 보내라는 사용자 메시지

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

    필드 간단한 설명
    트레이스 활성화 TRUE트레이스를 보려면 지정하십시오.
    세션 종료 이 요청 후 에이전트와의 세션을 TRUE 종료하도록 지정합니다.
    sessionState 상담원의 행동 또는 상담원과 연결된 지식 베이스의 행동에 영향을 미치는 컨텍스트를 포함합니다. 자세한 정보는 제어 세션 컨텍스트을 참조하세요.

응답은 이벤트 스트림으로 반환됩니다. 각 이벤트에는 chunk 디코딩해야 하는 bytes 필드 내 응답의 일부가 포함된 a가 포함됩니다. 상담원이 지식 베이스를 쿼리한 경우 지식창고도 포함됩니다. chunk citations 다음과 같은 객체도 반환될 수 있습니다.

  • 추적을 활성화한 경우 trace 개체도 반환됩니다. 오류가 발생하면 오류 메시지와 함께 필드가 반환됩니다. 트레이스를 읽는 방법에 대한 자세한 내용은 을 참조하십시오Amazon Bedrock의 트레이스 이벤트.