API de curado

La característica de preselección es una funcionalidad beta.

Utilice las curraciones para especificar el documento exacto que debe devolverse en respuesta a una consulta específica en lenguaje natural. Las preselecciones pueden garantizar que las preguntas frecuentes o importantes siempre devuelven el documento más valioso. La dirección URL ( confidence_score ) para una consulta seleccionada es siempre 1.00000.

Esta función beta sólo está disponible desde la API y se aplica únicamente a las consultas en lenguaje natural, no a las que se especifican utilizando el Discovery Query Language. Las funciones beta no están disponibles en los SDK.

Puedes definir hasta 1000 curaciones. Para obtener más información, consulte Crear curación en la referencia de la API.

Este ejemplo muestra cómo se añade una preselección con la API. Al consultar con la misma natural_language_query o similar se devuelve el documento con el document_id de document_id1234.

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

La consulta en lenguaje natural enviada por el cliente debe coincidir exactamente con la consulta especificada en la curación. Ambas consultas, la que envía el usuario en tiempo de ejecución y la que envía la API de curación y luego se almacena en el índice, se someten al análisis de consultas. El analizador de consultas lematiza el texto, elimina las palabras vacías y añade expansiones a las consultas.

Opcionalmente, puede especificar una respuesta codificada a la consulta incluyendo un fragmento. Un fragmento es una respuesta de su autoría que se devuelve cuando se obtiene el documento asociado para la consulta en lenguaje 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."
        }
      ]
    }
  ]
}

Si passages.per_document es true, el fragmento de texto que especifique se devuelve como pasaje principal en el campo passage_text en lugar del pasaje original que se elige mediante la búsqueda. Sólo se puede especificar un fragmento de texto por documento. Si passages.max_per_document es mayor que 1, se devuelve primero el fragmento, seguido de los pasajes elegidos por la búsqueda. Los filtros de consulta se aplican a los resultados de la curación.