큐레이션 API

큐레이션 기능은 베타 기능입니다.

큐레이션을 사용하여 특정 자연어 쿼리에 대한 응답으로 반환할 정확한 문서를 지정할 수 있습니다. 큐레이션을 수행하면 빈번하거나 중요한 질문이 항상 가장 가치 있는 문서를 리턴할 수 있습니다. 선별된 쿼리에 대한 쿼리 결과( confidence_score )는 항상 1.00000 입니다.

이 베타 기능은 API에서만 사용할 수 있으며 Discovery 쿼리 언어를 사용하여 지정한 쿼리가 아닌 자연어 쿼리에만 적용됩니다. 베타 기능은 SDK에서 사용할 수 없습니다.

최대 1,000개의 큐레이션을 정의할 수 있습니다. 자세한 내용은 API 참조에서 큐레이션 만들기를 참조하세요.

이 예제에서는 API를 통해 큐레이션을 추가하는 방법을 보여줍니다. 동일하거니 비슷한 natural_language_query로 조회할 때 document_id가 document_id1234인 문서가 리턴됩니다.

{
  "natural_language_query": "curations in watson discovery",
  "curated_results": [
     {
       "document_id": "document_id1234",
      "collection_id": "collection_id1234"
     }
   ]
 }

고객이 제출한 자연어 쿼리는 큐레이션에 지정된 쿼리와 정확히 일치해야 합니다. 사용자가 런타임에 제출한 쿼리와 큐레이션 API에 의해 제출된 후 인덱스에 저장된 쿼리 모두 쿼리 분석을 거칩니다. 쿼리 분석기는 텍스트를 레매타이제이션하고, 중지 단어를 제거하고, 쿼리 확장을 추가합니다.

선택적으로 스니펫을 포함하여 쿼리에 대한 하드코딩된 응답을 지정할 수 있습니다. 스니펫은 사용자가 작성하고 지정된 자연어 쿼리에 대해 관련 문서가 반환될 때 반환되는 응답입니다.

{
  "curations": [
    {
      "curation_id": "c1175536f509405bc68a9f76235fa7bbb6f9af2f",
      "natural_language_query": "What is a project",
      "curated_results": [
        {
          "collection_id": "47477591-b520-6039-0000-017ea213e837",
          "document_id": "web_crawl_123a2a56-8c26-5acb-9544-c4702ac899a4",
          "snippet": "A project is a convenient way to collect and manage the resources in your application. You can assign a project type and connect your data to the project by creating a collection."
        }
      ]
    }
  ]
}

passages.per_document 가 true 이면 검색에서 선택한 원본 구절 대신 지정한 텍스트 스니펫이 passage_text 필드에서 맨 위 구절로 반환됩니다. 문서당 하나의 텍스트 스니펫만 지정할 수 있습니다. passages.max_per_document 가 1 보다 크면 스니펫이 먼저 반환되고 검색에서 선택한 구절이 그다음에 반환됩니다. 큐레이션 결과에 쿼리 필터가 적용됩니다.