에이전트 동작 테스트 및 문제 해결

에이전트를 생성하면 작업 초안이 생성됩니다. 규격 초안은 에이전트를 반복적으로 빌드하는 데 사용할 수 있는 에이전트 버전입니다. 에이전트를 변경할 때마다 작업 초안이 업데이트됩니다. 에이전트의 구성에 만족하면 에이전트의 스냅샷인 버전 과 버전을 가리키는 별칭 를 생성할 수 있습니다. 그런 다음 별칭을 호출하여 에이전트를 애플리케이션에 배포할 수 있습니다. 자세한 내용은 애플리케이션에 Amazon Bedrock 에이전트 배포 및 통합 단원을 참조하십시오.

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

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

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

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

다음은 에이전트를 테스트하는 단계입니다. 선택한 메서드에 해당하는 탭을 선택하고 다음 단계를 따릅니다.

Console

에이전트를 테스트하려면

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

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

3. 에이전트 섹션의 에이전트 목록에서 테스트할 에이전트의 링크를 선택합니다.

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

   참고

   테스트 창이 닫힌 경우 에이전트 세부 정보 페이지 또는 해당 페이지 내의 아무 페이지에서나 테스트를 선택하여 다시 열 수 있습니다.

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

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

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

   참고

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

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

7. (선택 사항) 별칭에 대해 프로비저닝된 처리량을 선택하려면 선택한 테스트 별칭 아래의 텍스트가 PT 사용 ODT 또는 사용을 나타냅니다. 프로비저닝된 처리량 모델을 생성하려면 변경을 선택합니다. 자세한 내용은 Amazon Bedrock의 프로비저닝된 처리량으로 모델 호출 용량 증가 단원을 참조하십시오.

8. 에이전트를 테스트하려면 메시지를 입력하고 실행을 선택합니다. 응답이 생성될 때까지 기다리는 동안 또는 생성된 후 다음 옵션이 있습니다.

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

   • 에이전트가 지식 기반을 호출하면 응답에 각주가 포함됩니다. 응답의 특정 부분에 대해 인용된 정보가 포함된 S3 객체에 대한 링크를 보려면 관련 각주를 선택합니다.

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

     

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

   • 에이전트와 새 대화를 시작하려면 새로 고침 아이콘을 선택합니다.

   • 추적 창을 보려면 확장 아이콘을 선택합니다. 추적 창을 닫으려면 축소 아이콘을 선택합니다.

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

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

작업 그룹 또는 지식 기반을 활성화하려면

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

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

3. 에이전트 섹션의 에이전트 목록에서 테스트할 에이전트의 링크를 선택합니다.

4. 에이전트의 세부 정보 페이지의 작업 초안 섹션에서 작업 초안에 대한 링크를 선택합니다.

5. 작업 그룹 또는 지식 기반 섹션에서 변경하려는 작업 그룹 또는 지식 기반 상태 위에 마우스를 올려 놓습니다.

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

7. 작업 그룹이 비활성화된 경우 에이전트는 작업 그룹을 사용하지 않습니다. 지식 기반이 비활성화 인 경우 에이전트는 지식 기반을 사용하지 않습니다. 작업 그룹 또는 지식 기반을 활성화 또는 비활성화한 다음 테스트 창을 사용하여 에이전트 문제를 해결합니다.

8. 테스트하기 전에 에이전트에 변경한 내용을 적용하려면 준비를 선택합니다.

API

에이전트를 처음 테스트하기 전에 PrepareAgent Agents for Amazon Bedrock 빌드 타임 엔드포인트 를 사용한 요청(요청 및 응답 형식과 필드 세부 정보는 링크 참조). 요청에 agentId 를 포함합니다. 변경 사항은 TSTALIASID별칭이 가리키는 DRAFT 버전에 적용됩니다.

코드 예제 참조

참고

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

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

참고

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

코드 예제 참조

요청에 다음 필드가 있습니다.

• 최소한 다음 필수 필드를 입력합니다.

  필드	간단한 설명
  agentId	에이전트의 ID
  agentAliasId	별칭의 ID입니다. DRAFT 버전을 호출하는 TSTALIASID 데 사용
  sessionId	세션의 영숫자 ID(2~100자)
  inputText	에이전트에 보낼 사용자 프롬프트

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

  필드	간단한 설명
  enableTrace	트레이스TRUE를 보려면 를 지정합니다.
  endSession	이 요청 후 에이전트와의 세션을 종료TRUE하려면 를 지정합니다.
  sessionState	에이전트의 동작 또는 에이전트에 연결된 지식 기반 동작에 영향을 미치는 컨텍스트가 포함됩니다. 자세한 내용은 제어 에이전트 세션 컨텍스트 단원을 참조하십시오.

응답은 이벤트 스트림에 반환됩니다. 각 이벤트에는 bytes 필드에 응답의 일부를 chunk포함하는 가 포함되며, 이 응답은 디코딩되어야 합니다. 에이전트가 지식 기반을 쿼리한 경우 chunk에도 이 포함됩니다citations. 다음 객체도 반환될 수 있습니다.

• 추적을 활성화하면 trace 객체도 반환됩니다. 오류가 발생하면 오류 메시지와 함께 필드가 반환됩니다. 추적을 읽는 방법에 대한 자세한 내용은 섹션을 참조하세요추적을 사용하여 에이전트의 step-by-step 추론 프로세스 추적.