Kuratoren-API

Die Kuratierungsfunktion liegt in einer Betaversion vor.

Verwenden Sie Kurationen, um das genaue Dokument anzugeben, das als Antwort auf eine bestimmte natürlichsprachliche Abfrage zurückgegeben werden soll. Kuratierungen können dafür sorgen, dass häufige oder wichtige Fragen immer das wertvollste Dokument zurückgeben. confidence_score Die E-Mail-Adresse für eine kuratierte Anfrage lautet immer 1.00000.

Diese Beta-Funktion ist nur über die API verfügbar und wird nur auf Abfragen in natürlicher Sprache angewendet, nicht auf Abfragen, die mit der Discovery Query Language spezifiziert werden. Beta-Funktionen sind in den SDKs nicht verfügbar.

Sie können bis zu 1.000 Kuratierungen festlegen. Weitere Informationen finden Sie unter Kuration erstellen in der API-Referenz.

Dieses Beispiel zeigt, wie eine Kuratierung mit der API hinzugefügt wird. Bei einer Abfrage mit derselben oder einer ähnlichen natural_language_query wird das Dokument mit document_id von document_id1234 zurückgegeben.

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

Die vom Kunden eingegebene natürlichsprachliche Abfrage muss genau der Abfrage entsprechen, die in der Kuration angegeben ist. Beide Abfragen, die vom Benutzer zur Laufzeit gestellte und die von der Kurations-API gestellte und dann im Index gespeicherte, werden einer Abfrageanalyse unterzogen. Der Abfrageanalysator lemmatisiert den Text, entfernt Stoppwörter und fügt Abfrageerweiterungen hinzu.

Sie können optional eine fest kodierte Antwort auf die Abfrage angeben, indem Sie ein Snippet einfügen. Ein Snippet ist eine Antwort, die Sie verfassen und die zurückgegeben wird, wenn das zugehörige Dokument für die angegebene natürlichsprachliche Abfrage zurückgegeben wird.

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

Wenn passages.per_document true ist, wird der von Ihnen angegebene Textausschnitt als oberste Passage im Feld passage_text zurückgegeben, anstatt der ursprünglichen Passage, die von der Suche ausgewählt wird. Pro Dokument kann nur ein Textausschnitt angegeben werden. Wenn passages.max_per_document größer ist als 1, wird zuerst das Snippet zurückgegeben, gefolgt von den Passagen, die durch die Suche ausgewählt wurden. Abfragefilter werden auf die Kuratierungsergebnisse angewendet.