Avaliações externas

Importante

A partir de 3 de fevereiro de 2025, o Dynamics 365 Fraud Protection não está mais disponível para compra. O suporte à Proteção contra Fraudes terminará em 3 de fevereiro de 2026. Para obter mais informações, consulte o artigo Fim do suporte para o Dynamics 365 Fraud Protection.

A avaliação externa é um mecanismo para convocar uma avaliação a partir de qualquer outra avaliação. Uma avaliação externa não é uma avaliação em si. Em vez disso, ele age como uma fonte de dados que permite enviar dados e receber uma resposta de uma avaliação alvo. Uma avaliação pode ter uma das duas configurações de compartilhamento possíveis:

• Privado: Acessível somente no ambiente raiz da avaliação.
• Compartilhado: acessível em todos os ambientes no locatário.

Avaliações externas podem apontar para qualquer avaliação privada disponível no mesmo ambiente raiz ou qualquer avaliação compartilhada disponível em qualquer ambiente raiz do locatário.

Observação

Para obter mais informações sobre como alterar a configuração de compartilhamento de uma avaliação de Private para Shared ou Shared to Private, consulte a visão geral da configuração de avaliação.

Depois de configurar uma avaliação externa, ela pode ser chamada por meio de uma regra de qualquer avaliação nesse ambiente.

Para avaliação privada: Ambiente Y = Ambiente X

Para Avaliação Compartilhada: Ambiente Y = Qualquer ambiente raiz dentro do mesmo locatário

Uma avaliação de chamada refere-se a qualquer avaliação que chame uma avaliação privada ou compartilhada por meio de uma avaliação externa. A avaliação de chamada deve ter uma regra de avaliação externa estabelecida. Quando a condição da regra for atendida, a regra chamará a avaliação externa e executará as ações configuradas. Semelhante às chamadas externas, as avaliações externas não são herdadas por crianças. Para usar uma avaliação externa em uma regra, você deve configurar a avaliação externa no ambiente do qual deseja chamá-la.

Criar uma avaliação externa

Para criar uma avaliação externa, primeiro verifique se você tem a permissão certa para executar essa operação. Para obter mais informações sobre funções de usuário e permissões, consulte Funções de usuário e acesso

1. No portal da Proteção contra Fraudes, na navegação à esquerda, selecione Avaliações Externas e, em seguida, selecione + Nova avaliação externa.
2. Na página Nova avaliação externa , defina os seguintes campos:

• Avaliação de destino a ser chamada – Na lista suspensa, você pode ver todas as avaliações privadas, configuradas no mesmo ambiente raiz, bem como quaisquer avaliações compartilhadas disponíveis, configuradas em qualquer ambiente raiz do mesmo locatário. Selecione a avaliação que você deseja focar.

Observação

Se a avaliação compartilhada para a qual você deseja apontar sua avaliação externa não estiver sendo exibida na lista suspensa, verifique a configuração de compartilhamento da avaliação e verifique se ela está definida como Compartilhada. Para saber mais sobre como definir a configuração de compartilhamento , consulte a visão geral da configuração de avaliação.

• Nome – insira o nome que você usará para referenciar a avaliação externa de suas regras. O nome só pode conter números, letras e sublinhados. Ele não pode começar com um número.

Observação

Você não pode alterar o nome de uma avaliação externa depois de usá-la em uma regra.

• Descrição – Adicione uma descrição para ajudar sua equipe a identificar rapidamente a avaliação externa.
• API a ser visualizada – selecione a API para a qual você deseja visualizar o código de exemplo. O código de exemplo é o FQL que você pode usar em uma regra para chamar essa avaliação compartilhada

Observação

Você pode usar a avaliação externa para chamar as APIs de avaliação, observação ou rotulagem da avaliação compartilhada ou privada à qual se refere.

• Resposta de exemplo – esta seção contém a resposta de exemplo esperada da avaliação de destino. As informações exibidas são fornecidas manualmente pelo administrador de avaliação de destino e são usadas para habilitar descrições (dicas de ferramenta) e sugestões de preenchimento automático quando a avaliação é referenciada em uma regra.

3. Quando terminar de definir os campos necessários, selecione Criar.

Solicitar uma avaliação externa

Para usar suas avaliações externas, faça referência a elas nas suas regras. Por exemplo, para fazer referência a uma avaliação externa chamada myAssessment, em sua regra, use a seguinte sintaxe:

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

No exemplo acima, $baseInput = @@mapeará todos os campos necessários para a avaliação compartilhada/externa do conteúdo da avaliação de chamada. Você pode mapear apenas campos específicos também. Você também pode definir quais ações deseja que a regra execute com base nas informações que ela receberá de volta da chamada de avaliação externa.

Por exemplo

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

Você pode configurar uma regra para chamar a avaliação externa usando o modelo de regra de avaliação externa ou copiar/colar o FQL de exemplo da página de avaliação externa. Certifique-se de usar o código de exemplo para a API (avaliar, observar, rotular) que você deseja utilizar. O código de exemplo mostrará todos os campos que podem ser enviados para a avaliação compartilhada. Os campos necessários são marcados como tal no código.

Aqui está outro FQL de exemplo para chamar a API de avaliação da avaliação externa chamada 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)

Você também pode acessar o objeto de diagnóstico em regras, o que permite descobrir informações de diagnóstico e depuração importantes da resposta de uma avaliação externa. O objeto de diagnóstico contém o conteúdo da solicitação , o código HttpStatus , a mensagem de erro e a latência. O objeto de diagnóstico deve ser criado primeiro usando seu método de extensão correspondente, ". GetDiagnostics()", antes que os campos do objeto possam ser usados nas regras.

Veja a seguir um exemplo de uma regra usando o objeto de diagnóstico na resposta de uma avaliação externa chamada ExtAssessment2:

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

Chamadas externas e avaliações externas podem exigir objetos estruturados complexos como parte de seu esquema de solicitação. Para obter mais informações sobre como usar matrizes E objetos JSON, consulte o guia de referência de linguagem.

Observação

As Avaliações Externas também podem ser referenciadas no Functions. Para obter mais informações, consulte Funções.

Monitorar avaliações externas no portal da Proteção contra Fraudes

A Proteção contra Fraudes mostra um bloco que contém três métricas para cada avaliação externa que você define:

• Solicitações por segundo – O número total de solicitações dividido pelo número total de minutos no período selecionado.
• Latência média – o número total de solicitações divididas pelo número total de minutos no período selecionado.
• Taxa de êxito – o número total de solicitações bem-sucedidas divididas pelo número total de solicitações que foram feitas.

Os números e os gráficos mostrados neste bloco incluem somente os dados do período selecionado na lista suspensa no canto superior direito da página.

Observação

As métricas são mostradas somente quando sua avaliação externa é usada em uma regra ativa.

• Para se aprofundar nos dados sobre sua avaliação externa, selecione Desempenho no canto direito do bloco. O Fraud Protection mostra uma nova página com uma visão mais detalhada das métricas.
• Para exibir métricas para qualquer período nos últimos três meses, ajuste a configuração do intervalo de datas na parte superior da página.

Além das três métricas descritas anteriormente, um gráfico de erros também é mostrado. Este gráfico mostra o número de erros por tipo de erro e código. Para exibir a contagem de erros ao longo do tempo ou para exibir a distribuição de erros, selecione gráfico de pizza.

Além de erros de cliente HTTP (400, 401 e 403), você poderá ver os seguintes erros:

• ID do aplicativo inválido – o ID do aplicativo fornecido não existe no locatário ou não é válido.
• Falha do Microsoft Entra – O token do Microsoft Entra não pôde ser recuperado.
• Definição não encontrada – a chamada externa foi excluída, mas ainda é referenciada em uma regra.
• Tempo limite – A solicitação ao destino demorou mais do que o tempo limite especificado.
• Falha de comunicação – Não foi possível estabelecer conexão com o destino devido a um problema de rede ou porque o destino não está disponível.
• Disjuntor – se a chamada externa falhar continuamente e exceder um determinado limite, todas as chamadas adicionais serão suspensas por um curto intervalo de tempo.
• Falha desconhecida – Ocorreu uma falha interna do Dynamics 365.