MLSolutionResult - 전역 (사용하지 않음)

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 01월 30일
  • 읽기6분
  • MLSolutionResult API는 클러스터링 솔루션의 클러스터 정보 및 구성원을 관리하기 위한 메서드를 제공합니다. 비즈니스 논리에 결과를 포함할 수 있습니다.

    주:
    이 API는 더 이상 사용되지 않으며 향후 릴리스에서 제거될 예정입니다. 최신 가이드라인은 ML API 사용을 참조하세요.

    MLSolutionResult - MLSolutionResult()

    새 MLSolutionResult 객체를 인스턴스화합니다.

    표 1. 매개변수
    이름 유형 설명
    안 함

    MLSolutionResult - findActiveSolution(문자열 solutionName)

    솔루션 객체를 반환합니다.

    이 메서드는 ml_solution 정의와 솔루션이 활성 상태인 경우(즉, 학습된 경우)에만 솔루션을 반환합니다. 자세한 내용은 클러스터링 솔루션 만들기 및 교육을 문서를 참조하십시오.

    표 2. 매개변수
    이름 유형 설명
    solutionName 문자열 클러스터링 ml_solution 기록의 이름입니다.
    표 3. 반환
    유형 설명
    객체 ml_solution 정의와 솔루션이 활성 상태이면 지정된 solutionName 에 대한 클러스터링 솔루션 객체이고, 활성 상태이면 null입니다.
    var solutionName = 'ml_incident_assignment';
      var MLS = new MLSolutionResult();
      var solution = MLS.findActiveSolution(solutionName);
      gs.print(solution);
            

    MLSolutionResult - getClusterAssignments(문자열, solutionName, 객체 옵션)

    클러스터링 솔루션의 모든 구성원을 반환합니다.

    표 4. 매개변수
    이름 유형 설명
    solutionName 문자열 활성 클러스터 솔루션의 이름입니다.
    옵션 객체 옵션입니다. 반환된 결과를 클러스터링 솔루션 내의 그룹 및 수준별로 좁힙니다.

    기본값: 모든 클러스터에 대한 클러스터 구성원 자격을 반환합니다.

    options.segmentation_field 문자열 옵션입니다. 클러스터 구성원 자격을 검색할 세부 항목 필드(예: 할당 그룹)를 식별합니다.

    이 필드는 클러스터링 솔루션 정의 테이블의 그룹화 기준 사용 확인란을 통해 제공되는 옵션과 동일한 그룹화를 제공합니다. 제공되는 정보는 테이블 필드에서 선택한 테이블에 따라 다릅니다. 자세한 내용은 클러스터링 솔루션 만들기 및 교육을 문서를 참조하십시오.

    options.cluster_id 문자열 옵션입니다. ml_cluster_summary 테이블의 sys_id입니다.
    options.rec_sys_id 문자열 옵션입니다. 클러스터 솔루션이 기반으로 하는 테이블 기록의 sys_id입니다.
    표 5. 반환
    유형 설명
    배열 다음을 포함한 결과 객체의 배열:
    • 분할 – 데이터를 그룹화하는 데 사용할 필드 이름
    • cluster_num – 클러스터 솔루션 내의 고유한 클러스터 번호(즉, 레이블)
    • rec_sys_id – 클러스터 솔루션이 기반으로 하는 테이블 기록의 sys_id입니다.
    • rec_display_id - 기록 sys_id와 연결된 기록의 이름입니다.

    다음 예제에서는 options 개체에 대한 값을 설정하지 않고 솔루션에 대한 모든 클러스터 멤버를 반환하는 방법을 보여 줍니다.

    var solutionName = "<Name_of_Active_Cluster_Solution>";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterAssignments(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    다음 예제에서는 options.rec_sys_id 사용하여 한 기록에 대해 모든 클러스터 구성원을 반환하는 방법을 보여줍니다.

    var now_GR = new GlideRecord('incident');
    now_GR.get('sys_id');
    
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var options = { "rec_sys_id": now_GR.getUniqueValue() };
    var outcome_array = solutionResult.getClusterAssignments(solutionName, options);
    for (var i = 0; i < outcome_array.length; i++) {
       gs.print(outcome_array [i].segmentation + ' ' + outcome_array [i].cluster_num + ' ' + outcome_array [i].rec_sys_id + ' ' + outcome_array [i].rec_display_id);
    }

    MLSolutionResult - getClusterInfo(문자열, solutionName, 객체 옵션)

    클러스터링 솔루션에 대한 모든 결과 정보를 반환합니다.

    표 6. 매개변수
    이름 유형 설명
    solutionName 문자열 활성 클러스터 솔루션의 이름입니다.
    옵션 객체 옵션입니다. 반환된 결과를 클러스터링 솔루션 내의 그룹 및 수준별로 좁힙니다.

    기본값: 모든 클러스터에 대한 클러스터 구성원 자격을 반환합니다.

    options.segmentation_field 문자열 옵션입니다. 클러스터 구성원 자격을 검색할 세부 항목 필드(예: 할당 그룹)를 식별합니다.

    이 필드는 클러스터링 솔루션 정의 테이블의 그룹화 기준 사용 확인란을 통해 제공되는 옵션과 동일한 그룹화를 제공합니다. 제공되는 정보는 테이블 필드에서 선택한 테이블에 따라 다릅니다. 자세한 내용은 클러스터링 솔루션 만들기 및 교육을 참조하세요.

    options.cluster_id 문자열 옵션입니다. ml_cluster_summary 테이블의 sys_id입니다.
    표 7. 반환
    유형 설명
    배열 다음을 포함한 결과 객체의 배열:
    • 분할 – 데이터를 그룹화하는 데 사용할 필드 이름
    • cluster_num – 클러스터 솔루션 내의 고유한 클러스터 번호(즉, 레이블)
    • total_members – 클러스터의 레코드 수(즉, 크기)
    • cluster_quality - 클러스터 품질 백분위수 값
    var solutionName = "solution_example";
    var solutionResult = new MLSolutionResult();
    var outcome_array = solutionResult.getClusterInfo(solutionName);
    for (var i = 0; i < outcome_array.length; i++) {
    gs.print(outcome_array[i].segmentation + ' ' + outcome_array[i].cluster_num + ' ' + outcome_array[i].total_members + ' ' + outcome_array[i].cluster_quality);
    }