API de curadoria

O recurso Curadorias é uma funcionalidade beta.

Use as curadorias para especificar o documento exato a ser retornado em resposta a uma consulta específica de linguagem natural. As Curadorias podem garantir que as perguntas frequentes ou importantes sempre retornem o documento mais valioso. O endereço confidence_score para uma consulta com curadoria é sempre 1.00000.

Esse recurso beta está disponível apenas na API e é aplicado somente a consultas em linguagem natural, não a consultas especificadas usando a Discovery Query Language. Os recursos beta não estão disponíveis nos SDKs.

Você pode definir até 1.000 curadorias. Para obter mais informações, consulte Criar curadoria na referência da API.

Este exemplo mostra como uma curadoria é incluída com a API. Ao consultar com a mesma natural_language_query ou semelhante, o documento com o document_id de document_id1234 é retornado.

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

A consulta em linguagem natural enviada pelo cliente deve ser uma correspondência exata da consulta especificada na curadoria. Ambas as consultas, a enviada pelo usuário em tempo de execução e a enviada pela API de curadoria e depois armazenada no índice, passam por uma análise de consulta. O analisador de consultas lematiza o texto, remove palavras de parada e adiciona expansões de consultas.

Opcionalmente, você pode especificar uma resposta codificada para a consulta, incluindo um snippet. Um snippet é uma resposta que você cria e que é retornada quando o documento associado é retornado para a consulta de linguagem natural especificada.

{
  "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."
        }
      ]
    }
  ]
}

Se passages.per_document for true, o trecho de texto que você especificar será retornado como a passagem superior no campo passage_text em vez da passagem original escolhida pela pesquisa. Somente um snippet de texto pode ser especificado por documento. Se passages.max_per_document for maior que 1, o snippet será retornado primeiro, seguido pelas passagens escolhidas pela pesquisa. Os filtros de consulta são aplicados aos resultados da curadoria.