쿼리 작성 로그

  • 릴리스 버전: Australia
  • 업데이트 날짜 2026년 03월 12일
  • 소요 시간: 4분

    • 쿼리 생성기에 대한 모든 호출과 해당 결과는 쿼리 생성 로그 [sn_query_gen_log] 테이블에 로깅됩니다.

    로그 사용

    이동 쿼리 작성 > 관리 > 로그 항목 실패하거나 잘못된 쿼리를 검사합니다.
    1. 사용자, 날짜 또는 발언별로 항목을 찾습니다.
    2. 시맨틱 엔터티/차원/세그먼트 수 확인
    3. 쿼리 구성기 출력을 열어 선택한 항목을 확인합니다.
    4. 원시 시맨 틱 일치에 대한 시맨틱 필터 결과 와 비교합니다.
    표 1. AI 데이터 탐색기 문제 해결 가이드
    증상 예상 원인 수정
    "이해할 수 없음" 응답 시스템에서 일치하는 테이블을 찾을 수 없습니다. 엔터티 설명을 개선합니다. 테이블 이름으로 문구를 바꿉니다. AI 검색이 실행 중인지 확인합니다. 인덱싱된 모든 소스가 완전히 처리되었는지 확인합니다.
    잘못된 테이블이 선택됨 유사한 테이블 이름, 명확성 없음 시맨틱 사용 지침을 추가하여 구분합니다.
    잘못된 테이블 선택됨(권한) 사용자에게 의도한 테이블 또는 필드에 대한 읽기 권한이 없습니다. 의도한 데이터에 대한 테이블 및 필드 읽기 ACL을 확인하고 부여합니다.
    "테이블 데이터 액세스 중 오류 발생" 또는 "범위 액세스 권한이 부여되지 않음" 응답 일부 데이터는 액세스할 수 없는 보호된 애플리케이션 범위 AI 데이터 탐색기 에 있습니다. 의 AI 데이터 탐색기범위에 대한 액세스 권한을 부여하는 ACL을 생성합니다. 이후에 생성된 제한된 호출자 접근(RCA) 기록을 승인합니다. 자세한 내용은 및 에 대해 AI 데이터 탐색기 보호된 범위의 애플리케이션에 대한 액세스 활성화 쿼리 생성 문서를 참조하십시오.
    결과에서 누락된 필드 차원이 꺼졌거나, 레이블이 불분명하거나, 필드가 시맨틱 계층에 없습니다. 차원이 활성 상태인지 확인합니다. 레이블을 업데이트합니다.
    관련 필드를 끌어오지 않음 시맨틱 계층 또는 참조 차원에서 누락된 참조 테이블이 꺼짐 참조된 테이블 엔터티를 추가하고 활성화합니다. 참조 차원을 활성화합니다.
    잘못된 필터가 적용됨 잘못된 세그먼트 일치 세그먼트 이름 및 설명을 수정합니다. 세그먼트를 비활성화합니다.
    예상되는 경우 필터 없음 일치하는 세그먼트가 없습니다. 너무 모호한 표현 수동 세그먼트를 생성합니다. 질문 문구를 변경합니다.
    보고서의 세그먼트가 잘못됨 자동 생성된 세그먼트에 부실하거나 관련 없는 필터가 있음 보고서 세그먼트 소스 또는 특정 세그먼트를 비활성화합니다.
    표 2. 쿼리 생성 로그 열
    열 설명 기본적으로 표시됩니까?
    작성됨 쿼리 생성에 대한 호출의 타임스탬프 예
    사용자 호출을 한 사용자 [sys_user] 테이블의 사용자입니다. 이것이 비어 있으면 작성자를 시도하십시오. 예
    발언 사용자가 묻는 일반 언어 질문 예
    상태 호출의 성공 여부 예
    오류 메시지 상태가 "오류"인 경우 사용자에게 반환되는 오류 메시지입니다. 예
    총 시간 AI가 쿼리를 처리하고 응답을 반환하는 데 걸린 시간(밀리초) 예
    "X" 시간 각 구성요소 X가 쿼리를 처리하는 데 소요된 시간(밀리초) 예
    시맨틱 필터 결과 쿼리가 참조하는 시맨틱 계층 테이블의 필드(JSON) 예
    발언 저장소 결과 발언 저장소에서 발견되어 사용자의 질문을 해석하는 데 사용되는 사용자의 질문(발화)과 유사한 질문(JSON) 형식 예
    응답 쿼리에 대한 JSON 응답 예
    엔터티 쿼리에서 참조하는 엔터티 테이블의 기록입니다. 각 기록은 팩트 테이블에 해당합니다. 예
    쿼리 구성기 출력 작성된 쿼리의 JSON 예
    소스 질문을 제기한 애플리케이션입니다. 애플리케이션의 일부가 아닌 페이지에서 열렸을 때 패널에서 Now Assist 질문한 경우 해당 페이지의 UUID가 대신 표시됩니다. 예
    응답 LLM이 반환하는 응답 예
    생성 AI 로그 쿼리에 사용되는 LLM 예
    대화 쿼리 작성 대화를 위한 Now Assist 패널과 같은 고유 채팅 대화 ID 예
    ACL 시간 기본 테이블에 대한 사용자의 액세스 또는 보안을 확인하는 데 걸린 시간 아니요
    추가 정보 시작 시간, 총 호출 수 및 실행에 대한 AI 검색 기타 메타데이터 아니요
    작성자 쿼리를 생성한 사람입니다. 유지관리로 로그온한 직원 구성원을 포함 ServiceNow® 합니다. 아니요
    도메인 쿼리가 생성된 도메인 아니요
    닷워킹됨 쿼리에 테이블 간 닷워킹이 포함되어 있는지 여부(예/아니오) 아니요
    엔터티에 사용량 점수가 있음 엔터티에 사용량 점수가 있는지 여부(예/아니오) 아니요
    엔터티 소스 소스가 엔터티, 사용자 감각 또는 세그먼트에 있는지 여부 아니요
    오류 코드 오류가 있는 경우 오류 코드 아니요
    후속 작업 생성됨 LLM이 쿼리에 응답하여 생성한 후속 질문 수입니다 아니요
    후속 작업 반환됨 생성된 후속 질문 중 실제로 반환되는 질문 수입니다. 예를 들어 질문은 쿼리 사용자가 액세스할 수 있고 의미 체계 계층에 있는 테이블을 참조해야 합니다. 아니요
    LLM 시간 대규모 언어 모델(LLM)이 쿼리에 소요한 시간 아니요
    쿼리 작성자 시간 쿼리 작성자가 쿼리에 소요한 시간 아니요
    RAG 시간 쿼리에서 RAG(검색 증강 세대)에 소요된 시간 아니요
    시맨틱 차원 수 쿼리에 대해 검사한 테이블 기록(차원) 수 아니요
    시맨틱 엔터티 수 쿼리에 대해 검사된 테이블(엔터티) 수 아니요
    시맨틱 필터 결과 시맨틱 필터 실행 결과 아니요
    시맨틱 필터 시간 시맨틱 필터에 소요된 시간 아니요
    시맨틱 세그먼트 수 쿼리에 대해 검사된 세그먼트 수 아니요
    소스 테이블 소스 ID에 해당하는 테이블의 이름 아니요
    태그 로그에 추가하는 모든 태그 아니요
    업데이트 일시 로그 항목이 마지막으로 업데이트된 날짜 스탬프 아니요
    업데이트한 사람 마지막 로그 항목 업데이트를 담당하는 사용자 아니요
    업데이트 로그 항목의 업데이트 횟수 아니요
    발언 저장소 결과 발언 저장소에서 추출한 유사한 예 아니요
    발언 저장소 시간 발언 저장소를 검색하는 데 소요된 시간 아니요