Utilisation de champs généraux dans votre application

Communications Mining™ propose plusieurs façons de récupérer les prédictions, y compris les champs généraux prévus. Veuillez consulter la vue d’ensemble du téléchargement de données pour comprendre la méthode la mieux adaptée à votre cas d’utilisation.

Quelle que soit la méthode que vous choisissez, vous devez connaître les cas particuliers suivants et les gérer dans votre application :

• Tous les champs généraux attendus ne sont pas présents dans la réponse
• La réponse contient plusieurs correspondances pour un ou plusieurs champs généraux
• Tous les champs généraux présents dans la réponse ne sont pas corrects

Dans cette section, nous allons examiner chacun de ces cas limites plus en détail.

Tous les champs généraux ne sont pas présents dans la réponse

You should expect to handle cases where not all expected general fields are present. In the following example, the email has the policy number, but doesn't have the insured organization name. Your application should be able to handle such partial information.

Figure 1.. Organisation assurée manquante

La réponse contient plusieurs correspondances pour un ou plusieurs champs généraux

You should also expect to handle the opposite of the previous case, namely cases where a comment has more general fields than expected. In the following example, even though we expect one policy number and insured organization name per email, the email has multiple policy numbers.

Figure 2. Correspondances multiples pour le même champ général

Note that you can use the metadata in the response when handling such cases. For example, we can choose to preferentially pick policy numbers that appear in the email subject over those that appear in the email body. The following example shows the response that the API will return for our example email.

{
  "predictions": [
    {
      "uid": "aa05ba2250de48e3.7588b85f68f81c3b",
      "labels": [...],
      "entities": [
        {
          "id": "6a1d11118b60868e",
          "name": "policy-number",
          "span": {
            "content_part": "body",
            "message_index": 0,
            "utf16_byte_start": 200,
            "utf16_byte_end": 222,
            "char_start": 100,
            "char_end": 111
          },
          "kind": "policy-number",
          "formatted_value": "GHI-0204963"
        },
        {
          "id": "6a1d11118b60868e",
          "name": "policy-number",
          "span": {
            "content_part": "subject",
            "message_index": 0,
            "utf16_byte_start": 0,
            "utf16_byte_end": 22,
            "char_start": 0,
            "char_end": 11
          },
          "kind": "policy-number",
          "formatted_value": "GHI-0068448"
        },
        {...},
        {...},
        {...}
      ]
    }
  ],
  "model": {
    "version": 31,
    "time": "2021-07-14T15:00:57.608000Z"
  },
  "status": "ok"
}

Tous les champs généraux présents dans la réponse ne sont pas corrects

Enfin, étant donné que les champs généraux sont extraits à l'aide de l'apprentissage automatique, vous devez vous attendre à ce que les correspondances soient erronées. Le nombre de correspondances erronées dépendra du champ général que vous utilisez. La page Validation de votre ensemble de données fournit des statistiques de validation pour comprendre les performances d'un champ général.

Figure 3. Validation du champ général