API Curations

La fonction Organisations (Curations) est une fonctionnalité bêta.

Utilisez les curations pour spécifier le document exact à renvoyer en réponse à une requête spécifique en langage naturel. Elles peuvent garantir que les questions fréquentes ou importantes renvoient toujours le document le plus utile. Le site confidence_score pour une requête curatée est toujours 1.00000.

Cette fonctionnalité bêta n'est disponible qu'à partir de l'API et ne s'applique qu'aux requêtes en langage naturel, et non aux requêtes spécifiées à l'aide du langage de requête de découverte (Discovery Query Language). Les fonctionnalités bêta ne sont pas disponibles dans les SDK.

Vous pouvez définir jusqu'à 1 000 curations. Pour plus d'informations, voir Créer une curation dans la référence API.

Cet exemple montre comment une organisation est ajoutée avec l'API. Lorsque vous envoyez une requête avec une natural_language_query identique ou similaire, le document avec le document_id document_id1234 est renvoyé.

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

La requête en langage naturel soumise par le client doit correspondre exactement à la requête spécifiée dans la curation. Les deux requêtes, celle soumise par l'utilisateur au moment de l'exécution et celle soumise par l'API de curation puis stockée dans l'index, font l'objet d'une analyse. L'analyseur de requêtes lemmatise le texte, supprime les mots vides et ajoute des expansions de requêtes.

Vous pouvez éventuellement spécifier une réponse codée en dur à la requête en incluant un extrait. Un extrait est une réponse que vous avez créée et qui est renvoyée lorsque le document associé est renvoyé pour la requête en langage naturel spécifiée.

{
  "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 est true, l'extrait de texte que vous spécifiez est renvoyé comme premier passage dans le champ passage_text au lieu du passage original choisi par la recherche. Un seul extrait de texte peut être spécifié par document. Si passages.max_per_document est supérieur à 1, l'extrait est renvoyé en premier, suivi des passages choisis par la recherche. Les filtres de requête sont appliqués aux résultats de la curation.