Curation API

La funzione Cure dei contenuti è una funzionalità beta.

Utilizzate le curatele per specificare il documento esatto da restituire in risposta a una specifica query in linguaggio naturale. Le cure dei contenuti possono garantire che domande frequenti o importanti restituiscano sempre il documento più valido. Il sito confidence_score per una query curata è sempre 1.00000.

Questa funzione beta è disponibile solo dall'API e si applica solo alle query in linguaggio naturale, non alle query specificate utilizzando il Discovery Query Language. Le funzioni beta non sono disponibili negli SDK.

È possibile definire fino a 1.000 curatele. Per ulteriori informazioni, vedere Creare la curation nel riferimento API.

Questo esempio mostra come si aggiunge una cura dei contenuti con l'API. Quando si esegue una query con il valore natural_language_query uguale o simile, viene restituito il documento con il document_id di document_id1234.

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

La query in linguaggio naturale inviata dal cliente deve corrispondere esattamente alla query specificata nella curation. Entrambe le query, quella inviata dall'utente in fase di esecuzione e quella inviata dall'API di curation e poi memorizzata nell'indice, vengono sottoposte all'analisi della query. L'analizzatore di query lemmatizza il testo, rimuove le stop words e aggiunge le espansioni della query.

È possibile specificare una risposta codificata alla query, includendo uno snippet. Uno snippet è una risposta creata dall'utente che viene restituita quando il documento associato viene restituito per la query in linguaggio naturale specificata.

{
  "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 è true, il frammento di testo specificato viene restituito come primo passaggio nel campo passage_text invece del passaggio originale scelto dalla ricerca. È possibile specificare un solo frammento di testo per documento. Se passages.max_per_document è maggiore di 1, viene restituito prima il frammento, seguito dai passaggi scelti dalla ricerca. I filtri della query vengono applicati ai risultati della curation.