Uso de campos gerais em seu aplicativo

O Communications Mining™ fornece várias maneiras de buscar previsões, incluindo campos gerais previstos. Consulte a visão geral do download de dados para entender qual método funcionará melhor no seu caso de uso.

Seja qual for o método escolhido, você precisa estar ciente dos seguintes casos extremos e lidar com eles em seu aplicativo:

• Nem todos os campos gerais esperados estão presentes na resposta
• A resposta contém várias correspondências para um ou mais campos gerais
• Nem todos os campos gerais presentes na resposta estão corretos

Nesta seção, examinamos cada um desses casos extremos com mais detalhes.

Nem todos os campos gerais estão presentes na resposta

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.

Figura 1. Organização segurada não encontrada

A resposta contém várias correspondências para um ou mais campos gerais

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.

Figura 2. Várias correspondências para o mesmo campo Geral

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"
}

Nem todos os campos gerais presentes na resposta estão corretos

Por fim, como os campos gerais são extraídos usando aprendizado de máquina, você deve esperar receber correspondências erradas. O número de correspondências erradas dependerá do campo geral que você está usando. A página Validação de seu conjunto de dados fornece estatísticas de validação para entender como um campo geral será executado.

Figura 3. Validação de campo geral