Evaluaciones externas

La evaluación externa es un mecanismo para llamar a 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 le permite enviar datos y recibir una respuesta de una evaluación objetivo. Una evaluación puede tener una de dos posibles configuraciones de uso compartido:

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

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 llamar a través de una regla desde cualquier evaluación de ese entorno.

Para evaluación privada: Entorno Y = Entorno X

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

Una evaluación de llamada hace referencia a cualquier evaluación que llame a 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 elementos secundarios no heredan las evaluaciones externas. Para usar una evaluación externa en una regla, debe configurar la evaluación externa en el entorno desde el que desea llamarla.

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 de Fraud Protection, en la zona de navegación izquierda, seleccione Evaluaciones externas y luego + Nueva evaluación externa.
2. En la página Nueva evaluación externa, configure los siguientes campos:

• Evaluación de destino a la que llamar : en la lista desplegable puede ver todas las evaluaciones privadas, configurarse en el mismo entorno raíz, así como cualquier evaluación compartida disponible, configurada en cualquier entorno raíz del mismo inquilino. Seleccione la evaluación que desee seleccionar.

Billete

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: ingrese el nombre que utilizará para hacer referencia a la evaluación externa de sus reglas. El nombre solo puede contener números, letras y guiones bajos. No puede comenzar con un número.

Billete

No 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 muestra. El código de ejemplo es el FQL que puede usar en una regla para llamar a 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 ejemplo esperada de la evaluación de destino. 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.

Llamada a una evaluación externa

Para usar sus evaluaciones externas, refiérase a ellas en sus reglas. Por ejemplo, para hacer referencia a una evaluación externa que se denomina myAssesment en su regla, use la siguiente sintaxis:

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

En el ejemplo anterior, $baseInput = @@ asignará todos los campos necesarios para la evaluación compartida/externa de la carga útil de la evaluación de llamadas. También puede asignar campos específicos solamente. 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 utilizando la plantilla de regla Usar una evaluación externa o copiando y pegando el FQL de muestra de la página de evaluación externa. Asegúrese de usar el código de ejemplo de la API (evaluar, observar, etiqueta) al que quiere llamar. El código de muestra mostrará todos los campos que se pueden enviar a la evaluación compartida. Los campos obligatorios están marcados como tales en el código.

Aquí hay otro ejemplo de FQL para llamar a la API de evaluación de la evaluación externa llamada 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 en reglas, lo que le permite detectar 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

Fraud Protection muestra un mosaico que contiene tres métricas para cada evaluación externa que defina:

• Solicitudes por segundo - El número total de solicitudes dividido por el número total de minutos en el período de tiempo seleccionado.
• Latencia promedio - El número total de solicitudes dividido 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 mosaico incluyen solo datos para el período de tiempo que seleccione en la lista desplegable en la esquina superior derecha de la página.

Billete

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

• Para profundizar en los datos sobre su evaluación externa, seleccione Actuación en la esquina derecha del mosaico. Fraud Protection 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 los últimos tres meses, ajuste Rango de fechas en la parte superior de la página.

Además de las tres métricas que se describieron anteriormente, también se muestra el gráfico de Error. Este gráfico muestra el número de errores, por tipo de error y código. Para ver los recuentos de errores a lo largo del tiempo o para ver la distribución de errores, seleccione Gráfico circular.

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

• ID de aplicación no válido - El ID de la aplicación que se proporcionó no existe en su inquilino 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.
• Se acabó el tiempo - La solicitud al objetivo tardó más que el tiempo de espera especificado.
• Fallo de comunicación - No se pudo establecer conexión con el destino debido a un problema de red o porque el destino no está disponible.
• Interruptor: si se produjo un error en la llamada externa continuamente y se superó un umbral determinado, todas las llamadas adicionales se suspenden durante un intervalo corto.
• Falla desconocida - Se produjo un error interno de Dynamics 365.