다음을 통해 공유

기록 파일을 사용하여 봇 디버그

  • 아티클

적용 대상: SDK v4

봇을 성공적으로 테스트 및 디버깅하기 위한 요소 중 하나는 봇을 실행하는 동안 발생하는 조건 집합을 기록하고 검사하는 기능입니다. 이 문서에서는 봇 기록 파일을 만들어서 테스트 및 디버깅을 위한 구체적인 사용자 상호 작용 및 봇 응답 집합을 제공하는 방법을 설명합니다.

봇 기록 파일

봇 기록 파일은 사용자와 봇 간의 상호 작용을 유지하는 특수 JSON 파일입니다. 대본 파일은 메시지의 내용뿐만 아니라 사용자 ID, 채널 ID, 채널 유형, 채널 기능, 상호 작용 시간 등과 같은 상호 작용 세부 정보도 유지합니다. 이 모든 정보는 봇을 테스트 또는 디버깅할 때 문제를 찾아서 해결하는 데 사용할 수 있습니다.

봇 기록 파일 만들기/저장

이 문서에서는 Bot Framework Emulator 사용하여 봇 기록 파일을 만드는 방법을 보여줍니다. 대본 파일도 프로그래밍 방식으로 만들 수 있습니다. Blob Transcript Storage 를 참조하여 해당 접근 방식에 대해 자세히 알아보세요. 이 문서에서는 사용자의 운송 모드, 이름 및 연령을 요청하는 다중 턴 프롬프트 봇에 대한 Bot Framework 샘플 코드를 사용하지만 Microsoft의 Bot Framework Emulator 사용하여 액세스할 수 있는 모든 코드를 사용하여 대본 파일을 만들 수 있습니다.

이 프로세스를 시작하려면 테스트하려는 봇 코드가 개발 환경 내에서 실행 중인지 확인합니다.

  1. 에뮬레이터를 시작합니다.

  2. 시작 탭에서 봇 열기를 선택합니다.

  3. 예를 들어 http://localhost:3978/api/messages봇이 수신 대기 중인 /api/messages포트의 주소를 입력합니다.

    봇이 Microsoft 앱 ID 및 암호로 구성된 경우 봇 열기 대화 상자에서 ID와 암호를 입력합니다. 그렇지 않으면 에뮬레이터가 봇에 연결할 수 없습니다.

  4. 연결을 선택하여 에뮬레이터를 봇에 연결합니다.

    에뮬레이터에서 봇에 연결하는 대화 상자의 스크린샷

에뮬레이터에서 봇과 상호 작용하여 코드를 테스트합니다. 유지하려는 모든 사용자 상호 작용을 입력한 후 Bot Framework Emulator 사용하여 이 대화가 포함된 대본 파일을 만들고 저장합니다.

  1. 라이브 채팅 탭에서 대화 내용 저장을 선택합니다.

    에뮬레이터의 대화 및 '대본 저장' 단추 스크린샷.

  2. 대본 파일의 위치와 이름을 선택하고 저장을 선택합니다.

    '대화 대화 내용 저장' 대화 상자의 스크린샷.

에뮬레이터를 사용하여 코드를 테스트하기 위해 입력한 모든 사용자 상호 작용 및 봇 응답은 이제 나중에 다시 로드하여 사용자와 봇 간의 상호 작용을 디버그할 수 있는 대본 파일에 저장되었습니다.

봇 기록 파일 검색

기록 파일을 열면 에뮬레이터는 저장된 대화를 새 탭에 로드합니다.

봇 기록 파일을 검색하려면 다음을 수행합니다.

  1. 에뮬레이터를 엽니다.
  2. 메뉴에서 파일을 선택한 다음, 대본을 엽니다.
  3. 기록 파일 열기를 사용하여 검색할 대본 파일을 선택하고 엽니다.

'대화 상자 파일 열기' 대화 상자의 스크린샷.

기록 파일을 사용하여 디버그

기록 파일이 로드되면 이제 사용자와 봇 간에 캡처한 상호 작용을 디버그할 준비가 되었습니다.

  1. 에뮬레이터의 로그 창에 기록된 사용자 또는 봇 메시지 또는 활동을 선택합니다.

  2. 에뮬레이터는 검사 기 창에 활동 정보를 표시합니다. 활동 정보는 활동에 대한 HTTP 요청의 페이로드입니다.

    메시지 활동에는 다음이 포함됩니다.

    • 활동 유형
    • 채널에서 활동을 보내거나 받은 시간입니다.
    • 사용자의 채널에 대한 정보
    • 활동의 보낸 사람 및 수신자(각각 및 recipient 필드)from에 대한 정보
    • 메시지 활동의 메시지 텍스트와 같은 활동 유형과 관련된 정보입니다.

이 자세한 수준의 정보를 사용하면 사용자의 입력과 봇 응답 간의 단계별 상호 작용을 따를 수 있습니다. 이는 봇이 예상한 방식으로 응답하지 않았거나 사용자에게 전혀 응답하지 않은 상황을 디버깅하는 데 유용합니다. 이러한 값과 실패한 상호 작용으로 이어지는 단계의 레코드를 모두 사용하면 코드를 단계별로 실행하고, 봇이 예상대로 응답하지 않는 위치를 찾고, 이러한 문제를 해결할 수 있습니다.

Bot Framework Emulator와 함께 기록 파일을 사용하는 것은 봇의 코드 및 사용자 상호 작용을 테스트하고 디버그하는 데 사용할 수 있는 여러 도구 중 하나일 뿐입니다.

추가 정보

자세한 테스트 및 디버깅 정보는 다음을 참조하세요.