Uso de entidades en tu aplicación

Communications Mining ofrece múltiples formas de obtener predicciones, incluidas las entidades predichas. Consulta la descripción general de la descarga de datos para entender qué método funcionará mejor para tu caso de uso.

Cualquiera que sea el método que elijas, debes tener en cuenta los siguientes casos límite y manejarlos en tu aplicación:

• No todas las entidades esperadas están presentes en la respuesta
• La respuesta contiene varias coincidencias para una o más entidades
• No todas las entidades presentes en la respuesta son correctas

En esta sección repasaremos cada uno de estos casos límite con más detalle.

No todas las entidades están presentes en la respuesta

Debe esperar manejar casos en los que no estén presentes todas las entidades esperadas. En el siguiente ejemplo, el correo electrónico tiene el número de póliza, pero no tiene el nombre de la organización asegurada. Tu aplicación debería poder manejar dicha información parcial.

Figura 1. Falta la organización asegurada

La respuesta contiene varias coincidencias para una o más entidades

También deberías esperar manejar lo contrario del caso anterior, es decir, casos en los que un comentario tiene más entidades de las esperadas. En el siguiente ejemplo, aunque esperamos un número de póliza y un nombre de organización asegurada por correo electrónico, el correo electrónico tiene varios números de póliza.

Figura 2. Múltiples coincidencias para la misma entidad

Ten en cuenta que puedes utilizar los metadatos en la respuesta al gestionar estos casos. Por ejemplo, podemos elegir elegir preferentemente los números de póliza que aparecen en el asunto del correo electrónico sobre los que aparecen en el cuerpo del correo electrónico. El siguiente ejemplo muestra la respuesta que la API devolverá para nuestro correo electrónico de ejemplo.

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

No todas las entidades presentes en la respuesta son correctas

Por último, dado que las entidades se extraen mediante el aprendizaje automático, deberías esperar recibir coincidencias incorrectas. El número de coincidencias incorrectas dependerá de la entidad que estés utilizando. La página Validación de tu conjunto de datos proporciona estadísticas de validación para comprender cómo se comportará una entidad.

Figura 3. Validación de entidad