Uso de entidades em seu aplicativo

O Communications Mining fornece várias maneiras de obter previsões, incluindo entidades prevista. 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 todas as entidades esperadas estão presentes na resposta
• A resposta contém várias correspondências para uma ou mais entidades
• Nem todas as entidades presentes na resposta estão corretas

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

Nem todas as entidades estão presentes na resposta

Você deve esperar lidar com casos em que nem todas as entidades esperadas estão presentes. No exemplo abaixo, o e-mail tem o número da apólice, mas não tem o nome da organização do segurado. Seu aplicativo deve ser capaz de lidar com essas informações parciais.

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

A resposta contém várias correspondências para uma ou mais entidades

Você também deve lidar com o oposto do caso anterior, ou seja, casos em que um comentário tem mais entidades do que o esperado. No exemplo abaixo, embora esperemos um número de apólice e um nome de organização segurada por e-mail, o e-mail tem vários números de apólice.

Figura 2. Várias correspondências para a mesma entidade

Observe que você pode usar os metadados na resposta ao lidar com esses casos. Por exemplo, podemos escolher preferencialmente números de políticas que aparecem no assunto do e-mail em vez daqueles que aparecem no corpo do e-mail. O exemplo abaixo mostra a resposta que a API retornará para o nosso email de exemplo.

{
  "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 todas as entidades presentes na resposta estão corretas

Por fim, como as entidades são extraídas usando aprendizado de máquina, você deve esperar receber correspondências erradas. O número de correspondências incorretas dependerá da entidade que você está usando. A página Validação de seu conjunto de dados fornece estatísticas de validação para entender como uma entidade será executada.

Figura 3. Validação de entidade