IBM Cloud Docs
인리치먼트 관리

인리치먼트 관리

문서의 필드에 인리치먼트를 적용하여 의미 있는 정보를 더 쉽게 찾고 검색에서 리턴할 수 있습니다.

일반적으로 인리치먼트를 작성할 때 필드에 인리치먼트를 적용합니다. 그러나 나중에 필드에 인리치먼트를 적용할 수 있습니다. 예를 들어, SDU 도구를 사용하여 작성하는 새 사용자 정의 필드에 기존 인리치먼트를 적용할 수 있습니다. 필드에 적용한 인리치먼트도 제거할 수 있습니다.

사용 가능한 보강 기능에 대한 자세한 내용은 다음 주제를 참조하십시오

Content Mining 프로젝트에 인리치먼트를 적용하려면 Discovery 사용자 인터페이스를 사용하는 대신 Content Mining 애플리케이션을 사용해야 합니다. 컨텐츠 마이닝 애플리케이션을 사용하면 컨텐츠 마이닝 프로젝트에서 인리치먼트가 허용되는지 확인합니다. 컨텐츠 마이닝 프로젝트에 인리치먼트 (예: 사전 또는 구문 감성) 적용에 대한 자세한 정보는 콜렉션 강화 를 참조하십시오.

보강을 관리하려면 다음 단계를 완료하십시오

  1. 탐색 분할창에서 콜렉션 관리 페이지를 열고 콜렉션을 클릭하여 여십시오.

  2. 강화 탭을 클릭하십시오.

    사용 가능한 보강 목록이 표시됩니다.

    System 유형으로 분류되므로 기본 제공 인리치먼트를 식별할 수 있습니다. 목록에는 서비스 인스턴스의 프로젝트에서 작성된 사용자 정의 인리치먼트도 포함됩니다.

  3. 적용하거나 제거할 인리치먼트를 찾으십시오.

  4. 연관된 필드에서 트위스티를 클릭하여 필드 목록을 펼치십시오.

  5. 다음 중 하나를 수행하십시오.

    • 문서에 인리치먼트를 적용하려면 강화할 필드를 선택하십시오. 업로드된 JSON 또는 CSV 파일이나 SDU (Smart Document Understanding) 도구에서 추가된 사용자 정의 필드 및 texthtml 필드에 인리치먼트를 적용할 수 있습니다.

      선택하는 필드가 JSON 파일에서 오는 경우, 인리치먼트를 적용한 후 필드 데이터 유형이 배열로 변환됩니다. 이 필드는 단일 값을 포함하는 경우에도 배열로 변환됩니다. 예를 들어, "field1": "Discovery""field1": ["Discovery"] 가 됩니다. JSON 파일에서 사용자 정의 필드의 처음 50 ,000자만 강화됩니다.

    • 인리치먼트를 제거하려면 인리치먼트를 제거할 필드의 선택란을 선택 취소하십시오.

  6. 변경 사항 적용 및 재처리를 클릭하여 변경 사항을 컬렉션에 적용합니다.

인리치먼트 삭제

서비스에 대해 Discovery 에 알리기 위해 빌드한 사용자 정의 인리치먼트를 삭제할 수 있습니다. 사용자 정의 인리치먼트에는 사전, 정규식, 패턴 등이 포함됩니다. 자세한 정보는 도메인 특정 자원 추가 를 참조하십시오.

사전 빌드된 인리치먼트를 삭제할 수 없습니다. 사전 빌드된 인리치먼트에는 제품에 빌드되는 Natural Language Understanding 인리치먼트 (예: 엔티티 인리치먼트) 가 포함됩니다. 빌드되는 인리치먼트를 판별하려면 콜렉션에 대한 인리치먼트 페이지의 유형 열을 확인하십시오. 사전 빌드된 인리치먼트에는 System 유형이 있습니다.

사용자 지정 보강을 삭제하려면 다음 단계를 완료하십시오

  1. 사용자 정의 인리치먼트를 사용하는 프로젝트를 여십시오.

  2. 콜렉션 관리를 클릭한 후 인리치먼트가 사용 중인 콜렉션을 여십시오.

  3. 콜렉션의 인리치먼트 페이지에서, 인리치먼트가 적용되는 모든 필드에서 인리치먼트를 제거하십시오.

  4. 변경사항 적용 및 재처리를 클릭한 후 시스템이 인리치먼트 없이 콜렉션의 문서를 처리할 때까지 기다리십시오.

  5. 인리치먼트가 사용되는 모든 프로젝트의 모든 콜렉션에 대해 이전 단계를 반복하십시오.

    사용자 정의 인리치먼트는 단일 Discovery 서비스 인스턴스 내의 프로젝트에 있는 모든 콜렉션에서 사용할 수 있습니다.

  6. 인리치먼트를 사용한 콜렉션에서 인리치먼트 페이지를 열고 삭제 아이콘을 클릭하여 인리치먼트를 삭제하십시오.

사용자 정의 인리치먼트는 이 서비스 인스턴스의 모든 위치에 있는 인리치먼트 목록에서 제거됩니다.

API를 사용하여 인리치먼트 관리

API를 사용하여 데이터에 인리치먼트를 적용하려면 다음 단계를 완료하십시오.

  1. 먼저 적용할 인리치먼트의 고유 ID를 알아야 합니다. 자세한 정보는 인리치먼트 ID 를 참조하십시오.
  2. 콜렉션 작성 또는 콜렉션 업데이트 메소드를 사용하여 콜렉션의 문서에 인리치먼트를 적용하십시오. 자세한 정보는 API를 사용하여 인리치먼트 적용 을 참조하십시오.

인리치먼트 ID

한 콜렉션에 대해 작성한 사용자 정의 인리치먼트를 다른 콜렉션에 적용하려면 인리치먼트가 작성될 때 생성된 고유 ID를 알아야 합니다. API를 사용하여 사용자 정의 인리치먼트가 사용 중인 프로젝트에서 인리치먼트를 나열 하십시오. 리턴되는 목록에는 인리치먼트 ID 정보가 포함됩니다.

사전 빌드된 인리치먼트의 경우 고유 ID가 변경되지 않습니다. 다음 표에서는 각 사전 빌드된 인리치먼트 유형과 연관된 ID를 나열하고 인리치먼트가 지원되는 콜렉션 언어를 식별합니다. 인리치먼트에서 콜렉션 언어를 지원하지 않으면 인리치먼트를 콜렉션에 적용할 수 없습니다.

사전 빌드된 인리치먼트 ID
이름 인리치먼트 ID 지원되는 언어
계약 701db916-fc83-57ab-0000-000000000014 ko
엔티티 701db916-fc83-57ab-0000-00000000001e ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN
키워드 701db916-fc83-57ab-0000-000000000018 ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN
품사 701db916-fc83-57ab-0000-000000000002 지원되는 모든 언어
문서의 감성 701db916-fc83-57ab-0000-000000000016 ar, de, en, es, fr, it, ja, ko, nl, pt, zh-CN
테이블 이해 701db916-fc83-57ab-0000-000000000012 지원되는 모든 언어

지원되는 모든 언어에 대한 자세한 정보는 언어 지원 을 참조하십시오.

API를 사용하여 인리치먼트 적용

API를 사용하여 인리치먼트를 적용하려면 다음 단계를 완료하십시오.

  1. 엔드포인트의 기본 URL 와 배포를 위한 토큰 또는 API 키를 결정합니다.

    자세한 정보는 API를 사용하여 사용자 정의 애플리케이션 빌드 를 참조하십시오.

  2. 프로젝트의 프로젝트 ID를 가져오십시오.

    제품 사용자 인터페이스에서 통합 및 배치 > API 정보 보기 페이지로 이동한 후 프로젝트 ID를 복사하십시오.

  3. 인리치먼트를 적용할 콜렉션의 ID를 모르는 경우 콜렉션 목록을 가져와서 찾으십시오.

    예를 들어,

    GET $authentication $url/v2/projects/$project_id/collections?version=2019-11-22
    

    collection_id 가 리턴됩니다.

  4. GET 요청을 전송하여 적용된 인리치먼트를 나열하는 콜렉션의 구성을 리턴하십시오.

    예를 들어,

    GET $authentication $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
    

    사전 빌드된 인리치먼트의 인리치먼트 ID는 인리치먼트 ID 를 참조하십시오.

  5. 적용하고자 하는 보강을 추가하세요.

    예를 들어, 키워드 인리치먼트를 추가하기 위해 인리치먼트 목록에 인리치먼트를 포함할 수 있습니다. 먼저 테이블에서 해당 ID를 가져오십시오.

    키워드 인리치먼트 ID는 701db916-fc83-57ab-0000-000000000018 입니다. 콜렉션에 있는 문서의 text 필드에 있는 컨텐츠에 키워드 인리치먼트를 적용하도록 표시하기 위해 다음과 같이 JSON 형식으로 표시할 수 있습니다.

    {
        "enrichment_id" : "701db916-fc83-57ab-0000-000000000018",
        "fields" : [ "text" ]
    }
    

    사용자가 지정하는 인리치먼트는 기본 인리치먼트를 대체합니다. 따라서 기본 인리치먼트를 유지하려면 콜렉션에 적용하는 인리치먼트 목록에 이를 포함하는 것을 잊지 마십시오. 프로젝트 유형별 기본 인리치먼트 목록은 프로젝트 유형별 기본 인리치먼트 를 참조하십시오.

    예를 들어, 엔티티 인리치먼트를 보유하고 키워드 인리치먼트를 추가하려면 요청 본문에서 다음을 지정할 수 있습니다.

    "enrichments": [
      {
        "enrichment_id": "701db916-fc83-57ab-0000-00000000001e",
        "fields": [
          "text"
        ]
      },
      {
        "enrichment_id": "701db916-fc83-57ab-0000-000000000018",
        "fields": [
          "text"
        ]
      }
    ]
    
  6. update collection 메소드를 사용하여 업데이트된 JSON 요청 본문을 제출하여 콜렉션에 인리치먼트를 적용하십시오.

    예를 들어,

    POST $authentication -d '$requestBody' $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
    

프로젝트 유형별 기본 인리치먼트

일부 사전 빌드된 인리치먼트는 프로젝트 유형에 따라 프로젝트의 콜렉션에 자동으로 적용됩니다. 다음 표는 각 프로젝트 유형에 적용되는 기본 인리치먼트를 표시합니다.

프로젝트 유형별 기본 인리치먼트
이 테이블에는 행 및 열 머리글이 있습니다. 행 헤더는 프로젝트 유형을 식별합니다. 열 헤더는 다른 인리치먼트를 식별합니다. 기본적으로 프로젝트 유형에 적용되는 인리치먼트를 이해하려면 인리치먼트를 설명하는 행으로 이동하여 관심이 있는 프로젝트 유형의 열을 찾으십시오.
보강 문서 검색 계약에 대한 문서 검색 대화식 검색 컨텐츠 마이닝
계약 체크표시 아이콘
엔티티 체크표시 아이콘 체크표시 아이콘
키워드
품사 체크표시 아이콘
문서의 감성
테이블 이해 체크표시 아이콘