Evaluaciones externas

Importante

A partir del 3 de febrero de 2025, Dynamics 365 Fraud Protection ya no está disponible para su compra. El soporte técnico para la protección contra fraudes finalizará el 3 de febrero de 2026. Para obtener más información, consulte el artículo Fin de soporte técnico de Dynamics 365 Fraud Protection.

La evaluación externa es un mecanismo para activar una evaluación desde cualquier otra evaluación. Una evaluación externa no es una evaluación en sí misma. En su lugar, actúa como un origen de datos que permite enviar datos y recibir una respuesta de una evaluación de destino. Una evaluación puede tener una de estas dos opciones de configuración de uso compartido posibles:

• Privado: accesible solo en el entorno raíz de la evaluación.
• Compartido: accesible en todos los entornos del arrendatario.

Las evaluaciones externas pueden apuntar a cualquier evaluación privada que esté disponible en el mismo entorno raíz o cualquier evaluación compartida que esté disponible en cualquier entorno raíz del inquilino.

Nota:

Para obtener más información sobre cómo cambiar la configuración Uso compartido de una evaluación de Privado a Compartido o Compartido a Privado, consulte Introducción a la configuración de evaluación.

Después de configurar una evaluación externa, se puede activar mediante una regla desde cualquier evaluación de ese entorno.

Para la evaluación privada: Entorno Y = Entorno X

Para la evaluación compartida: Entorno Y = Cualquier entorno raíz dentro del mismo inquilino

Una evaluación que implica llamadas se refiere a cualquier evaluación que invoque una evaluación privada o compartida a través de una evaluación externa. La evaluación de llamadas debe tener configurada una regla de evaluación externa. Cuando se cumpla la condición de regla, la regla llamará a la evaluación externa y realizará las acciones configuradas. De forma similar a las llamadas externas, los hijos no heredan las evaluaciones externas. Para usar una evaluación externa en una regla, debe configurar la evaluación externa en el entorno en el que desea realizar la llamada.

Creación de una evaluación externa

Para crear una evaluación externa, asegúrese primero de tener el permiso adecuado para realizar esta operación. Para obtener más información sobre los roles y permisos de usuario, consulte Roles de usuario y acceso.

1. En el portal protección contra fraudes, en el panel de navegación izquierdo, seleccione Evaluaciones externas y, a continuación, seleccione + Nueva evaluación externa.
2. En la página Nueva evaluación externa , establezca los campos siguientes:

• Evaluación de destino a la que llamar: en la lista desplegable puede ver todas las evaluaciones privadas, configuradas en el mismo entorno raíz, así como cualquier evaluación compartida que esté disponible, configurada en cualquier entorno raíz del mismo tenant. Seleccione la evaluación que desea enfocar.

Nota:

Si la evaluación compartida a la que desea señalar la evaluación externa no se muestra en la lista desplegable, compruebe la opción Compartir de la evaluación y asegúrese de que está establecida en Compartido. Para obtener más información sobre cómo configurar la opción Uso compartido, consulte Información general sobre la configuración de evaluación.

• Nombre : escriba el nombre que usará para hacer referencia a la evaluación externa desde sus reglas. El nombre solo puede contener números, letras y caracteres de subrayado. No puede comenzar con un número.

Nota:

No se puede cambiar el nombre de una evaluación externa después de usarlo en una regla.

• Descripción : agregue una descripción para ayudar a su equipo a identificar rápidamente la evaluación externa.
• API para obtener una vista previa : seleccione la API para la que desea obtener una vista previa del código de ejemplo. El código de ejemplo es el FQL que puede utilizar en una regla para invocar esta evaluación compartida.

Nota:

Puede usar la evaluación externa para llamar a la API evaluate, observation o label de la evaluación compartida o privada a la que apunta.

• Respuesta de ejemplo: Esta sección contiene la respuesta de muestra esperada de la evaluación objetivo. El administrador de la evaluación de destino proporciona manualmente la información que se muestra y se usa para habilitar descripciones (información sobre herramientas) y sugerencias para autocompletar cuando se hace referencia a la evaluación en una regla.

3. Cuando haya terminado de establecer los campos obligatorios, seleccione Crear.

Llama a una evaluación externa

Para usar sus evaluaciones externas, haga referencia a ellas desde sus reglas. Por ejemplo, para hacer referencia a una evaluación externa, denominada myAssessment, en la regla, use la sintaxis siguiente:

Assessments.myAssessment.Evaluate($baseInput = @@)

En el ejemplo anterior, $baseInput = @@asignará todos los campos necesarios para la evaluación compartida o externa desde la carga de la evaluación de llamada. Puede asignar únicamente campos específicos. También puede definir qué acciones desea que realice la regla en función de la información que recibirá de la llamada de evaluación externa.

Por ejemplo

LET $card = {
  number: 12345,
  expy: "2023-03-10".ToDateTime()
}
LET $response = Assessments.MicroTx.evaluate(card = $card, user = @@"user")
OBSERVE Output(decision = $response.decisionDetails.merchantRuleDecision)

Puede configurar una regla para llamar a la evaluación externa mediante la plantilla Usar una regla de evaluación externa o copiar o pegar el FQL de ejemplo desde la página de evaluación externa. Asegúrese de usar el código de ejemplo de la API (evaluar, observar, etiquetar) al que quiere llamar. El código de ejemplo mostrará todos los campos que se pueden enviar a la evaluación compartida. Los campos obligatorios se marcan como tal en el código.

Este es otro FQL de ejemplo para llamar a la API de evaluación externa denominada ExtAssessment1:

LET $customUser = {
    id: "userId123456",
    username: "johnsmith2",
    firstName: "John",
    lastName: "Smith",
    email: "johnsmith2@gmail.com",
    address: {
        street1: "0123 Bechtelar Loop",
        city: "Kubtown",
        state: "SC",
        zipCode: "44329",
        countryRegion: "US"
    }
}

LET $result = Assessments.ExtAssessment1.Evaluate(
    user = $customUser,
    specialConsideration = true)
OBSERVE Output(Result = $result)

También puede acceder al objeto de diagnóstico dentro de las reglas, lo que le permite obtener información importante de diagnóstico y depuración a partir de la respuesta de una evaluación externa. El objeto de diagnóstico contiene la carga de solicitud , el código HttpStatus , el mensaje de error y la latencia. El objeto de diagnóstico se debe crear primero mediante su método de extensión correspondiente, ". GetDiagnostics()", antes de que los campos del objeto se puedan usar en las reglas.

A continuación se muestra un ejemplo de una regla mediante el objeto de diagnóstico en la respuesta de una evaluación externa denominada ExtAssessment2:

LET $result = Assessments.ExtAssessment2.evaluate($baseInput =@@)
LET $diagnostics = $result.GetDiagnostics()
RETURN Approve(), Output (Diagnostics = $diagnostics)
WHEN $diagnostics.httpStatusCode==200

Las llamadas externas y las evaluaciones externas pueden requerir objetos estructurados complejos como parte de su esquema de solicitud. Para obtener más información sobre cómo usar matrices y objetos JSON, consulte la guía de referencia de lenguaje.

Nota:

También se puede hacer referencia a las evaluaciones externas en Functions. Para obtener más información, vea Funciones.

Supervisión de evaluaciones externas en el portal protección contra fraudes

Protección contra fraudes muestra un icono que contiene tres métricas para cada evaluación externa que defina:

• Solicitudes por segundo : el número total de solicitudes divididas por el número total de minutos en el período de tiempo seleccionado.
• Latencia media : el número total de solicitudes divididas por el número total de minutos en el período de tiempo seleccionado.
• Tasa de éxito : el número total de solicitudes correctas divididas por el número total de solicitudes realizadas.

Los números y gráficos que se muestran en este icono solo incluyen datos para el período de tiempo que seleccione en la lista desplegable de la esquina superior derecha de la página.

Nota:

Las métricas solo se muestran cuando la evaluación externa se utiliza en una regla activa.

• Para profundizar más en los datos sobre la evaluación externa, seleccione Rendimiento en la esquina derecha del icono. Protección contra fraudes muestra una nueva página que tiene una vista más detallada de las métricas.
• Para ver las métricas de cualquier período de tiempo en los últimos tres meses, ajuste la configuración Intervalo de fechas en la parte superior de la página.

Además de las tres métricas descritas anteriormente, también se muestra un gráfico de errores . En este gráfico se muestra el número de errores por tipo de error y código. Para ver el recuento de errores a lo largo del tiempo o para ver la distribución de errores, seleccione Gráfico circular.

Además de los errores de cliente HTTP (400, 401 y 403), es posible que vea los siguientes errores:

• Identificador de aplicación no válido – El identificador de aplicación que se proporcionó no existe en su arrendatario o no es válido.
• Error de Microsoft Entra : no se pudo recuperar el token de Microsoft Entra.
• Definición no encontrada : se eliminó la llamada externa, pero todavía se hace referencia a ella en una regla.
• Tiempo de espera : la solicitud al destino tardó más tiempo que el tiempo de espera especificado.
• Error de comunicación : no se pudo realizar ninguna conexión al destino debido a un problema de red o porque el destino no está disponible.
• Disyuntor: si la llamada externa está fallando continuamente y supera un umbral determinado, todas las llamadas posteriores se suspenden durante un intervalo corto.
• Error desconocido : se produjo un error interno de Dynamics 365.