Externa utvärderingar

Extern utvärdering är en mekanism för att anropa en utvärdering från andra utvärderingar. En extern utvärdering är inte en utvärdering i sig. I stället fungerar den som en datakälla som gör att du kan skicka data och ta emot ett svar från en målutvärdering. En utvärdering kan ha någon av två möjliga delningsinställningar:

• Privat: Endast tillgängligt i utvärderingens rotmiljö.
• Delad: Tillgänglig i alla miljöer i klientorganisationen.

Externa utvärderingar kan peka på alla privata utvärderingar som är tillgängliga i samma rotmiljö eller alla delade utvärderingar som är tillgängliga i valfri rotmiljö i klientorganisationen.

Kommentar

Mer information om hur du ändrar delningsinställningen för en utvärdering från Privat till Delad eller Delad till Privat finns i Översikt över utvärderingskonfiguration.

När du har konfigurerat en extern utvärdering kan den anropas via en regel från valfri utvärdering i den miljön.

För privat utvärdering: Miljö Y = Miljö X

För delad utvärdering: Miljö Y = Alla rotmiljöer i samma klientorganisation

En samtalsbedömning refererar till alla utvärderingar som anropar en privat eller delad utvärdering via en extern utvärdering. Den anropande utvärderingen måste ha en extern utvärderingsregel konfigurerad. När regelvillkoret uppfylls anropar regeln den externa utvärderingen och utför de konfigurerade åtgärderna. På samma sätt som externa anrop ärvs inte externa utvärderingar av underordnade. Om du vill använda en extern utvärdering i en regel måste du konfigurera den externa utvärderingen i den miljö som du vill anropa den från.

Skapa en extern utvärdering

Om du vill skapa en extern utvärdering måste du först se till att du har rätt behörighet att utföra den här åtgärden. Mer information om användarroller och behörigheter finns i Användarroller och åtkomst

1. I det vänstra navigeringsfönstret i bedrägeriskyddsportalen väljer du Externa utvärderingar och sedan + Ny extern utvärdering.
2. På sidan Ny extern utvärdering anger du följande fält:

• Målutvärdering att anropa – I listrutan kan du se alla privata utvärderingar, konfigurerade i samma rotmiljö, samt alla tillgängliga delade utvärderingar, konfigurerade i alla rotmiljöer i samma klientorganisation. Välj den utvärdering som du vill rikta in dig på.

Kommentar

Om den delade utvärderingen som du vill peka den externa utvärderingen till inte visas i listrutan kontrollerar du inställningen Delning för utvärderingen och ser till att den är inställd på Delad. Mer information om hur du konfigurerar delningsinställningen finns i Översikt över utvärderingskonfiguration.

• Namn – Ange det namn som du ska använda för att referera till den externa utvärderingen från dina regler. Namnet får bara innehålla siffror, bokstäver och understreck. Det kan inte börja med ett tal.

Kommentar

Du kan inte ändra namnet på en extern utvärdering när du har använt den i en regel.

• Beskrivning – Lägg till en beskrivning som hjälper ditt team att snabbt identifiera den externa utvärderingen.
• API som ska förhandsgranskas – Välj det API som du vill förhandsgranska exempelkoden för. Exempelkoden är den FQL som du kan använda i en regel för att anropa den här delade utvärderingen

Kommentar

Du kan använda den externa utvärderingen för att anropa API:et för utvärdering, observation eller etikett för den delade eller privata utvärdering som den pekar på.

• Exempelsvar – Det här avsnittet innehåller det exempelsvar som förväntas från målutvärderingen. Den information som visas tillhandahålls manuellt av målutvärderingsadministratören och används för att aktivera beskrivningar (knappbeskrivningar) och förslag på automatisk komplettering när utvärderingen refereras till i en regel.

3. När du är klar med att ange de obligatoriska fälten väljer du Skapa.

Anropa en extern utvärdering

Om du vill använda dina externa utvärderingar refererar du till dem från dina regler. Om du till exempel vill referera till en extern utvärdering med namnet myAssessment använder du följande syntax i regeln:

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

I exemplet ovan $baseInput = @@mappas alla fält som behövs av den delade/externa utvärderingen från den anropande utvärderingens nyttolast. Du kan endast mappa specifika fält. Du kan också definiera vilka åtgärder du vill att regeln ska vidta baserat på den information som den får tillbaka från det externa utvärderingsanropet.

Exempel:

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

Du kan konfigurera en regel för att anropa den externa utvärderingen genom att antingen använda mallen Använd en extern utvärderingsregel eller kopiera/klistra in exempel-FQL från den externa utvärderingssidan. Se till att använda exempelkoden för API:et (utvärdera, observera, etikett) som du vill anropa. Exempelkoden visar alla fält som kan skickas till den delade utvärderingen. De obligatoriska fälten markeras som sådana i koden.

Här är ett annat exempel på FQL för att anropa utvärdera API för extern utvärdering med namnet 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)

Du kan också komma åt diagnostikobjektet i regler, vilket gör att du kan identifiera viktig diagnostik- och felsökningsinformation från en extern utvärderings svar. Diagnostikobjektet innehåller nyttolasten Begär , HttpStatus-kod , felmeddelande och svarstid. Diagnostikobjektet måste skapas först med hjälp av motsvarande tilläggsmetod, ". GetDiagnostics()", innan objektets fält kan användas i reglerna.

Följande är ett exempel på en regel som använder diagnostikobjektet på svaret från en extern utvärdering med namnet ExtAssessment2:

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

Externa anrop och externa utvärderingar kan kräva komplexa strukturerade objekt som en del av deras begärandeschema. Mer information om hur du använder JSON-matriser och -objekt finns i språkreferensguiden.

Kommentar

Externa utvärderingar kan också refereras i Functions. Mer information finns i Funktioner.

Övervaka externa utvärderingar i bedrägeriskyddsportalen

Bedrägeriskydd visar en panel som innehåller tre mått för varje extern utvärdering som du definierar:

• Begäranden per sekund – Det totala antalet begäranden dividerat med det totala antalet minuter under den valda tidsramen.
• Genomsnittlig svarstid – det totala antalet begäranden dividerat med det totala antalet minuter i den valda tidsramen.
• Lyckad frekvens – Det totala antalet lyckade begäranden dividerat med det totala antalet begäranden som har gjorts.

De siffror och diagram som visas på den här panelen innehåller endast data för den tidsram som du väljer i listrutan i det övre högra hörnet på sidan.

Kommentar

Mått visas bara när din externa utvärdering används i en aktiv regel.

• Om du vill fördjupa dig i data om din externa utvärdering väljer du Prestanda i det högra hörnet av panelen. Bedrägeriskydd visar en ny sida med en mer detaljerad vy över måtten.
• Om du vill visa mått för en tidsram under de senaste tre månaderna justerar du inställningen Datumintervall överst på sidan.

Förutom de tre mått som beskrevs tidigare visas även ett feldiagram . Det här diagrammet visar antalet fel efter feltyp och kod. Om du vill visa antalet fel över tid eller om du vill visa fördelningen av fel väljer du Cirkeldiagram.

Förutom HTTP-klientfel (400, 401 och 403) kan följande fel visas:

• Ogiltigt program-ID – det program-ID som angavs finns inte i din klientorganisation eller så är det inte giltigt.
• Microsoft Entra-fel – Det gick inte att hämta Microsoft Entra-token.
• Det gick inte att hitta definitionen – det externa anropet togs bort, men det refereras fortfarande till i en regel.
• Tidsgräns – Begäran till målet tog längre tid än den angivna tidsgränsen.
• Kommunikationsfel – Det gick inte att upprätta någon anslutning till målet på grund av ett nätverksproblem eller på grund av att målet inte är tillgängligt.
• Kretsbrytare – Om det externa anropet misslyckades kontinuerligt och överskred ett visst tröskelvärde, pausas alla ytterligare anrop under ett kort intervall.
• Okänt fel – Ett internt Dynamics 365-fel inträffade.