플러그인을 통해 수동 세그먼트 배송
비즈니스 단위 애플리케이션 개발자는 애플리케이션과 함께 수동 세그먼트를 제공하여 앱이 설치된 순간부터 작동하는 도메인별 저장된 검색을 제공할 수 있습니다.
배송 개요
수동 세그먼트는 도메인별 저장된 검색을 애플리케이션과 함께 제공하는 데 권장되는 방법입니다. 검색 중에 자동화된 세그먼트보다 우선순위가 향상되며, LLM은 완전히 관련이 없는 경우가 아닌 한 모든 필터를 유지하도록 지시받는 반면, 자동화된 세그먼트 필터는 개별적으로 비판됩니다.
플러그인과 함께 수동 세그먼트를 제공하면 사용자가 사용 패턴에서 자동화된 세그먼트가 생성될 때까지 기다릴 필요 없이 비즈니스 용어를 사용하여 애플리케이션의 데이터에 대해 즉시 자연어 질문을 할 수 있습니다.
수동 세그먼트를 배송하는 방법
- 개발 인스턴스에서 수동 세그먼트 구성 기록을 생성합니다.
- 올바르게 동기화되고 예상 검색 결과가 생성되는지 확인합니다.
- 앱의 업데이트 세트에 sn_query_gen_segment_table_config 기록을 포함합니다.
플러그인 설치 동작
플러그인 설치 중에 수동 세그먼트가 어떻게 작동하는지 이해하는 것은 적절한 기대치를 설정하는 데 중요합니다.
- 플러그인 설치 중에 비즈니스 규칙이 바이패스 됩니다. 설치 시 비동기 동기화가 자동으로 발생하지 않습니다.
- 기록은 다음에 시맨틱 레이어 작성 예약된 작업이 실행될 때(설치 후) 또는 주간 세그먼트 동기화 작업이 실행될 때 sn_query_gen_segment로 동기화됩니다.
- 플러그인이 중복 기록을 제공하지 않는지 확인하십시오. 데이터베이스 수준에는 고유한 제약 조건이 없으므로 관리자는 엔터티당 중복된 이름이 없는지 확인해야 합니다.
중요사항:
플러그인을 통해 제공된 수동 세그먼트는 설치 후 즉시 검색에 사용할 수 없습니다. 예약된 다음 동기화 작업이 실행된 후에 활성화됩니다.
예: 테이블에 대한 전체 구성
다음 예는 ITSM 애플리케이션과 함께 제공될 수 있는 인시던 트 테이블에 대한 수동 세그먼트를 보여줍니다.
전제 조건: 인시던트 테이블에는 sn_query_gen_table_configenable_semantic_generation = true 기록과 활성 엔터티가 있어야 합니다.
| 이름 | 설명 | 테이블 | 필터 |
|---|---|---|---|
| 중요한 오픈 인시던트 | 현재 오픈 상태이며 해결되지 않은 우선순위가 높은 인시던트입니다. 모든 할당 그룹을 포함합니다. | 인시던트 | 우선순위=1^상태!=7^상태!=8 |
| 내 팀의 지연된 인시던트 | 현재 사용자의 그룹에 할당되어 SLA 기한이 지난 인시던트입니다. | 인시던트 | assignment_group=javascript:getMyGroups()^sla_due<javascript:gs.nowDateTime()^state!=7 |
| 최근 P1/P2 에스컬레이션 | 지난 7일 동안 에스컬레이션된 우선순위 1 및 2 인시던트입니다. | 인시던트 | 우선순위<=2^escalation=1^sys_updated_on>=javascript:gs.daysAgoStart(7) |
배송 세그먼트에 대한 베스트 프랙티스
- 고가치, 트래픽이 많은 테이블에 집중
- 사용자가 가장 많이 묻는 테이블에 수동 세그먼트를 집중합니다. 앱의 기본 테이블에 있는 잘 만들어진 몇 가지 세그먼트는 거의 쿼리되지 않는 테이블에 대한 광범위한 범위보다 더 많은 영향을 미칩니다.
- 기술 코드가 아닌 비즈니스 언어를 사용합니다.
- 세그먼트 이름은 사용자가 도메인에 대해 자연스럽게 말하는 방식과 일치해야 합니다. "중요 오픈 인시던트"는 "P1_OPEN_INC"보다 낫습니다.
- 명확성을 위한 설명 제공
- 동일한 테이블에 대해 여러 세그먼트를 제공하는 경우 설명은 LLM이 올바른 세그먼트를 선택하는 데 도움이 됩니다. 설명이 없으면 LLM은 유사한 일치 항목 중에서 임의로 선택할 수 있습니다.
- 배송 전 테스트
- 테스트 환경에서 세그먼트가 올바르게 동기화되고 관련 발언에 대한 검색 결과에 표시되는지 확인합니다. 쿼리 로그를 확인하여 일치하는 동작을 확인합니다.
- 자동화된 세그먼트 중복 방지
- 수동 세그먼트를 만들기 전에 자동화된 세그먼트가 이미 동일한 필터를 포함하고 있는지 확인합니다. 존재하지만 이름이 좋지 않은 경우 중복을 만드는 대신 소스를 개선하는 것이 좋습니다.
배송 전 검사 목록
플러그인에 수동 세그먼트를 포함하기 전에 다음 사항을 확인하십시오.
- 각 대상 테이블은 시맨틱 계층에 활성 엔터티가 있습니다( sn_query_gen_table_configenable_semantic_generation = true)
- 세그먼트 이름은 기술적 약어가 아닌 일반 사용자 언어로 작성되었습니다.
- 이름만으로 모호할 수 있는 세그먼트에 대한 설명이 제공됩니다.
- 필터는 인코딩된 유효한 쿼리이며 최적의 LLM 프롬프트 포함을 위해 2,000자 미만입니다.
- 업데이트 세트에 중복 기록(같은 이름 + 테이블 조합)이 없습니다.
- 모든 sn_query_gen_segment_table_config 기록은 앱의 업데이트 세트에 포함됩니다.
- 테스트 환경에서 세그먼트가 올바르게 동기화되고 관련 발언에 대한 검색 결과에 표시되는지 확인했습니다.
배포 후 모니터링
애플리케이션과 함께 수동 세그먼트를 배송한 후:
- 쿼리 로그에서 일치하는 세그먼트 모니터링
- 생성된 쿼리가 의도한 사용 케이스에 맞는지 확인
- 쿼리 정확도 및 범위에 대한 사용자 피드백 수집
- 사용 패턴에 따라 세그먼트 이름 및 설명 반복
세그먼트가 일치하지만 잘못된 결과를 생성하는 경우 문제는 일반적으로 이름이 너무 일반적이거나 필터가 너무 광범위하기 때문입니다. 시스템 속성을 조정하기 전에 이름과 설명을 구체화합니다.