外部評量

發行項
05/20/2024

外部評定是從任何其他評定呼叫評量的機制。外部評定本身不是評定。相反地，它的作用就像數據源，可讓您傳送數據並從目標評定接收回應。評量可以有兩個可能的共享設定之一：

私人：只能在評定的根環境中存取。
共用：可在租使用者中的所有環境中存取。

外部評定可以指向相同根環境中可用的任何私人評定，或租使用者任何根環境中可用的共享評定。

注意

如需如何將評定的共用設定從私人變更為共用或共用至私人的詳細資訊，請參閱評定組態概觀。

設定外部評定之後，即可透過來自該環境中任何評量的規則來呼叫。

外部評估流程

針對私人評定：環境 Y = 環境 X

針對共享評定：環境 Y = 相同租使用者中的任何根環境

通話評量是指透過外部評定呼叫私人或共用評定的任何評量。呼叫評量必須設定外部評定規則。符合規則條件時，規則會呼叫外部評定並執行設定的動作。與外部呼叫類似，子系不會繼承外部評量。若要在規則中使用外部評定，您必須在想要從中呼叫的外部評量環境中設定外部評量。

建立外部評定

若要建立外部評定，請先確定您有執行這項作業的正確許可權。如需使用者角色和許可權的詳細資訊，請參閱使用者角色和存取權

在 [詐騙保護] 入口網站的左側導覽中，選取 [外部評定]，然後選取 [+ 新增外部評定]。
在 [ 新增外部評估 ] 頁面上，設定下列欄位：

要呼叫 的目標評定 – 在下拉式清單中，您可以看到所有私人評定、在相同的根環境中設定，以及任何可用的共用評定，在相同租使用者的任何根環境中設定。選取您想要設定目標的評定。

注意

如果您想要將外部評量指向的共用評定未顯示在下拉式清單中，請檢查評定的 [共用] 設定，並確定其設定為 [共用]。 若要深入瞭解如何設定共用設定，請參閱評定設定概觀。

名稱 – 輸入您將用來從規則參考外部評定的名稱。名稱只能包含數位、字母和底線。它不能以數字開頭。

注意

在規則中使用外部評定之後，您無法變更其名稱。

描述 – 新增描述，以協助小組快速識別外部評定。
要預覽 的 API – 選取您要預覽範例程式代碼的 API。範例程式代碼是您可以在規則中用來呼叫此共享評定的 FQL

注意

您可以使用外部評定來呼叫其所指向之共用或私用評定的評估、觀察或標籤 API。

範例回應 – 本節包含目標評量預期的範例回應。顯示的資訊是由目標評估管理員手動提供，並用來在規則中參考評估時啟用自動完成的描述（工具提示）和建議。

當您完成設定必要的欄位時，請選取 [ 建立]。

呼叫外部評定

若要使用您的外部評定，請從規則參考它們。例如，若要在規則中參考名為 myAssessment 的外部評量，請使用下列語法：

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

在上述範例中， $baseInput = @@將會從呼叫評定的承載對應共用/外部評量所需的所有欄位。您也可以只對應特定欄位。您也可以根據從外部評估呼叫收到的信息，定義您希望規則採取哪些動作。

例如，

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

您可以使用 [使用 外部評估規則範本]，或從外部評定 頁面複製/貼上範例 FQL，以設定規則來呼叫外部評定。請務必針對您想要呼叫的 API 使用範例程式代碼（評估、觀察、標籤）。範例程式代碼會顯示可傳送至共用評量的所有欄位。必要的欄位會在程式代碼中標示為這類。

以下是另一個範例 FQL，用於呼叫名為 ExtAssessment1 的外部評估 API：

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)

您也可以存取規則中的診斷物件，這可讓您從外部評定的回應中探索重要的診斷和偵錯資訊。診斷物件包含要求承載、HttpStatus 程式代碼、錯誤訊息和延遲。必須先使用其對應的擴充方法來建立診斷物件，”GetDiagnostics（）“，物件字段可以在規則中使用之前。

以下是在外部評定的回應上使用診斷對象的規則範例，名為 ExtAssessment2：

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

外部呼叫和外部評估可能需要複雜的結構化對象作為其要求架構的一部分。如需如何使用 JSON 陣列和物件的詳細資訊，請參閱語言參考指南。

注意

您也可以在 Functions 內參考外部評定。如需詳細資訊，請參閱函式。

在詐騙保護入口網站中監視外部評量

詐騙防護會顯示一個圖格，其中包含您定義之每個外部評定的三個計量：

每秒要求數 – 要求總數除以所選時間範圍內的總分鐘數。
平均延遲 – 要求總數除以所選時間範圍內的總分鐘數。
成功率 – 成功要求總數除以已提出的要求總數。

此圖格上顯示的數字和圖表只包含您在頁面右上角下拉式清單中選取的時間範圍數據。

注意

只有在使用中的規則中使用外部評量時，才會顯示計量。

若要深入瞭解外部評量的相關數據，請選取圖格右上角的 [效能]。詐騙保護會顯示新頁面，其中包含更詳細的計量檢視。
若要檢視過去三個月中任何時間範圍的計量，請調整頁面頂端的 [日期範圍] 設定。

除了稍早所述的三個 計量之外，也會顯示錯誤 圖表。此圖表依錯誤類型和程式代碼顯示錯誤數目。若要檢視一段時間的錯誤計數，或檢視錯誤的分佈，請選取餅圖。

除了 HTTP 用戶端錯誤（400、401 和 403），您可能會看到下列錯誤：

無效的應用程式識別碼 – 所提供的應用程式標識碼不存在於您的租使用者中，或無效。
Microsoft Entra 失敗 – 無法擷取 Microsoft Entra 令牌。
找不到 定義 – 已刪除外部呼叫，但仍會在規則中參考。
逾時 – 對目標的要求花費的時間超過指定的逾時時間。
通訊失敗 – 因為網路問題或目標無法使用，無法連線到目標。
斷路器 – 如果外部呼叫連續失敗並超過特定閾值，則所有進一步的呼叫都會暫停短暫的間隔。
未知失敗 – 發生內部 Dynamics 365 失敗。

共用方式為

外部評量

建立外部評定

呼叫外部評定

在詐騙保護入口網站中監視外部評量

意見反應

其他資源