Azure AI 검색의 디버그 세션
디버그 세션은 Azure Portal의 기존 기술 집합과 함께 작동하는 시각적 편집기로, 세션 기간 동안 인덱서 및 기술 집합에 의해 생성된 보강된 단일 문서의 구조와 콘텐츠를 노출합니다. 라이브 문서로 작업하고 있기 때문에 세션은 대화형입니다. 오류를 식별하고, 기술 실행을 수정 및 호출하고, 결과를 실시간으로 유효성 검사할 수 있습니다. 변경 내용으로 문제가 해결되면 게시된 기술 집합에 커밋하여 전역적으로 수정 사항을 적용할 수 있습니다.
디버그 세션 작동 방식
세션을 시작하면 검색 서비스가 기술 집합, 인덱서 및 기술 집합을 테스트하는 데 사용할 단일 문서가 포함된 데이터 원본의 복사본을 만듭니다. 모든 세션 상태는 사용자가 제공한 Azure Storage 계정의 Azure AI 검색 서비스에서 만든 새 Blob 컨테이너에 저장됩니다. 생성된 컨테이너의 이름에는 "ms-az-cognitive-search-debugsession"이라는 접두사가 있습니다. 접두사는 실수로 계정의 다른 컨테이너로 세션 데이터를 내보낼 가능성을 줄이기 때문에 필요합니다.
보강된 문서 및 기술 집합의 캐시된 복사본이 시각적 편집기에 로드되므로 각 문서 노드를 확인하고 기술 집합 정의의 모든 측면을 편집할 수 있는 기능을 통해 보강된 문서의 콘텐츠 및 메타데이터를 검사할 수 있습니다. 세션 내에서 이루어진 모든 변경 내용은 캐시됩니다. 이러한 변경 내용은 커밋하지 않는 한 게시된 기술 집합에 영향을 미치지 않습니다. 변경 내용을 커밋하면 프로덕션 기술 세트를 덮어쓰게 됩니다.
보강 파이프라인에 오류가 없으면 변경 내용을 커밋하기 전에 디버그 세션을 사용하여 문서를 점증적으로 보강하고, 테스트하고, 유효성을 검사할 수 있습니다.
디버그 세션 상태 관리
시작 단추를 사용하여 디버그 세션을 다시 실행하거나 취소 단추를 사용하여 진행 중인 세션을 취소할 수 있습니다.
AI 보강 탭 > 기술 그래프
시각적 편집기는 탭과 창으로 구성됩니다. 이 섹션에서는 시각적 편집기의 구성 요소를 소개합니다.
기술 그래프는 기술 세트의 시각적 계층 구조와 해당 실행 순서를 위에서 아래로 제공합니다. 다른 기술의 출력에 의존하는 기술은 그래프에서 아래쪽에 배치됩니다. 계층에서 같은 수준에 있는 기술은 병렬로 실행할 수 있습니다. 그래프에서 색상으로 구분된 기술 레이블은 기술 세트에서 실행 중인 기술 형식(TEXT 또는 VISION)을 나타냅니다.
그래프에서 기술을 선택하면 정의, 오류 또는 경고, 실행 기록을 포함하여 오른쪽 창에 해당 기술 인스턴스의 세부 정보가 표시됩니다. 기술 그래프에서는 디버그 또는 개선할 기술을 선택할 수 있습니다. 오른쪽의 세부 정보 창은 편집하고 탐색하는 곳입니다.
기술 세부 정보 창
기술 그래프에서 개체를 선택하면 인접한 창에서 탭 레이아웃으로 대화형 작업 영역을 제공합니다. 세부 정보 창의 그림은 이전 스크린샷에서 찾을 수 있습니다.
기술 세부 정보에는 다음 영역이 포함됩니다.
- 기술 설정은 기술 정의의 형식화된 버전을 보여 줍니다.
- 기술 JSON 편집기는 정의의 원시 JSON 문서를 보여 줍니다.
- 실행은 기술이 실행된 각 시간에 해당하는 데이터를 보여 줍니다.
- 오류 및 경고는 세션 시작 또는 새로 고침 시 생성된 메시지를 보여 줍니다.
실행 또는 기술 설정에서 </> 기호를 선택하여 기술 입출력의 식을 보고 편집하는 데 사용되는 식 계산기를 엽니다.
기술 설정의 중첩된 입력 컨트롤을 사용하여 프로젝션을 위한 복잡한 모양, 복합 형식 필드에 대한 출력 필드 매핑 또는 기술에 대한 입력을 만들 수 있습니다. 중첩된 입력을 식 계산기와 함께 사용하면 편리한 테스트 및 식 유효성 검사 빌더가 제공됩니다.
실행 창
기술은 단일 문서의 기술 세트에서 여러 번 실행할 수 있습니다. 예를 들어, OCR 기술은 단일 문서에서 추출된 각 이미지에 대해 한 번씩 실행됩니다. 실행 창에는 기술의 각 호출에 대한 자세한 정보를 제공하는 기술의 실행 기록이 표시됩니다.
실행 기록을 통해 특정 보강에서 이것을 생성한 기술로 역방향 추적할 수 있습니다. 기술 입력을 클릭하면 해당 입력을 생성한 기술로 이동하여 기능과 같은 스택 추적을 제공합니다. 이를 통해 다운스트림 기술에서 나타날 수 있는 문제의 근본 원인을 식별할 수 있습니다.
사용자 지정 기술로 오류를 디버깅할 때 실행 기록에서 기술 호출에 대한 요청을 생성하는 옵션이 있습니다.
AI 보강 탭 > 보강된 데이터 구조
보강 데이터 구조 창에는 기술 세트를 통해 문서의 보강이 표시되며, 각 보강 및 원래 기술에 대한 컨텍스트가 자세히 설명되어 있습니다. 식 계산기를 사용하여 각 보강에 대한 내용을 볼 수도 있습니다.
식 계산기
식 계산기에서는 경로의 값을 얼른 엿볼 수 있습니다. 기술이나 프로젝션에 대한 입력 또는 컨텍스트를 업데이트하기 전에 경로를 편집하고 결과를 테스트 할 수 있습니다.
종속성 그래프의 일부 또는 보강 트리의 노드를 포함하여 </> 기호를 표시하는 모든 노드 또는 요소에서 창을 열 수 있습니다.
식 계산기는 기술 컨텍스트 테스트, 입출력 확인을 위한 완전한 대화형 액세스를 제공합니다.
다음 단계
이제 디버그 세션의 요소를 이해했으므로 기존 기술 집합에서 첫 번째 디버그 세션을 시작합니다.