註冊派對

本頁將引導您完成下列步驟，註冊及取消註冊參與者，以便建立預測結果：

1. 確認您已準備好註冊政黨
2. 準備政黨登記表
3. 使用 projects.locations.instances.importRegisteredParties 方法註冊或取消註冊當事人
4. 驗證方法回應
5. (選用) 匯出已註冊當事人表格

事前準備

開始前，請先準備 AML AI 執行個體。

如要讓模型建立風險評分預測，請先註冊當事人。如果已具備下列條件，建議您註冊當事人：

• 一或多個 資料集
• 經過調整、訓練和回溯測試的模型

何時註冊政黨

如要為資料集中的當事人建立預測，請先註冊當事人。訓練、調整或回溯測試時，不需要註冊。

在正式或測試 (平行) 階段，預測結果可用於調查客戶是否涉及洗錢。您也可以根據預測結果，建立自己的管理和模型分析程序。

每註冊一方，註冊方每月會產生額外費用 (詳情請參閱定價頁面)。

如何準備政黨登記表

如要瞭解如何註冊參與者，請參閱定價頁面。

準備好要為業務範圍註冊當事人的表格。 如果您已註冊部分派對，這個派對註冊表可能包含您想用於預測結果的「派對」表格子集。

零售當事人結構定義

商業派對結構定義

如何登記派對

每個 AML AI 執行個體都必須個別註冊。注意事項：

• 零售和商業合作夥伴必須分別註冊。使用個別的 API 呼叫和個別的當事人註冊表。如果政黨同時出現在兩份名單中，則視為個別登記。
• 如要進行預測，所有各方都必須向與所用引擎版本相關的業務範圍註冊。如果資料集包含未向相同業務範圍註冊的任何一方，您就無法建立預測結果。
• 提供的當事人登記資料表可用於在執行個體中附加至現有的登記當事人清單，或取代執行個體中提供的業務範圍的所有登記當事人。
• 註冊後，一段時間內無法取消註冊 (請參閱定價頁面)。因此，您可以將 validateOnly 欄位設為 TRUE。您可以在這個欄位中查看方法的淨效應和回應，而不必變更已註冊的當事人。驗證完成後，您可以重新執行作業，並將 validateOnly 參數設為 FALSE。
• 請務必檢查註冊要求的相關回應，確保所有參與者都已成功註冊，即使先前的 validateOnly 要求成功也一樣。
• 如果是商業合作夥伴註冊，合作夥伴註冊表 party_size 欄位中的值不是 SMALL 或 LARGE，就會觸發錯誤 (Invalid party_size present in table)，註冊的合作夥伴不會更新。
• 如果是零售派對註冊，系統會忽略 party_size 欄位，並註冊所提供派對註冊表格中的所有派對。

如要匯入已註冊的當事人，請使用 projects.locations.instances.importRegisteredParties 方法。

(您也可以在「建立及管理執行個體」中查看下列資訊)。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID： Google Cloud 列於「IAM 設定」的專案 ID
• LOCATION：執行個體的位置；請使用其中一個支援的區域
  顯示地區
  • us-central1
  • us-east1
  • europe-west2
  • europe-west6
• INSTANCE_ID：使用者定義的執行個體 ID
• BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME：BigQuery 資料集，內含描述已註冊當事人的資料表
• PARTY_REGISTRATION_TABLE：列出已註冊當事人的表格
• UPDATE_MODE：使用 REPLACE 將註冊當事人資料表中的可移除當事人替換為新當事人，或使用 APPEND 將新當事人新增至註冊當事人資料表
• LINE_OF_BUSINESS：這個欄位必須與lineOfBusiness引擎版本中引擎設定使用的值相符；商業銀行客戶 (法人和自然人實體) 請使用 COMMERCIAL，零售銀行客戶請使用 RETAIL

JSON 要求內文：

{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

如要傳送要求，請選擇以下其中一個選項：

cat > request.json << 'EOF'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties"

@'
{
  "partyTables": [
     "bq://PROJECT_ID.BQ_INPUT_REGISTERED_PARTIES_DATASET_NAME.PARTY_REGISTRATION_TABLE"
  ],
  "mode": "UPDATE_MODE",
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:importRegisteredParties" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "importRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如要瞭解如何取得長時間執行的作業 (LRO) 結果，請參閱「管理長時間執行的作業」。

註冊回應

LRO 完成後，回應會指出作業新增、移除或更新的當事人數量。

如何取消註冊當事人

系統會針對每個 AML AI 執行個體取消註冊當事人，方法是使用相同的 projects.locations.instances.importRegisteredParties 方法，並取代現有的當事人清單。將 mode 欄位設為 REPLACE。這項設定會取消註冊任何不屬於所提供業務範圍的註冊方，這些註冊方不屬於所提供的註冊方註冊資料表。

取消註冊回應

作業完成後，請檢查 API 回應，確認作業是否已新增或移除預期數量的參與者，以及註冊參與者的總數。

API 回應也會傳回因限制而無法移除的當事人數量；舉例來說，必須經過最少天數，才能取消註冊客戶。

匯出已註冊的當事人

如要匯出已註冊的當事人，請使用 projects.locations.instances.exportRegisteredParties 方法。

(您也可以在「建立及管理執行個體」中查看下列資訊)。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID： Google Cloud 列於「IAM 設定」的專案 ID
• LOCATION：執行個體的位置；請使用其中一個支援的區域
  顯示地區
  • us-central1
  • us-east1
  • europe-west2
  • europe-west6
• INSTANCE_ID：使用者定義的執行個體 ID
• BQ_OUTPUT_DATASET_NAME：要匯出資料表的 BigQuery 資料集，該資料表會說明已註冊的當事人
• PARTY_REGISTRATION_TABLE：要寫入已登記參與方的資料表
• WRITE_DISPOSITION：如果目的地資料表已存在，要執行的動作；請使用下列其中一個值：
  • WRITE_EMPTY：只有在 BigQuery 資料表為空白時，才能匯出資料。
  • WRITE_TRUNCATE：先清除 BigQuery 資料表中的所有現有資料，再寫入資料表。
• LINE_OF_BUSINESS：請為商業銀行客戶 (法人和自然人) 使用 COMMERCIAL，或為零售銀行客戶使用 RETAIL

JSON 要求內文：

{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}

如要傳送要求，請選擇以下其中一個選項：

cat > request.json << 'EOF'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
EOF

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties"

@'
{
  "dataset": {
    "tableUri": "bq://PROJECT_ID.BQ_OUTPUT_DATASET_NAME.PARTY_REGISTRATION_TABLE",
    "writeDisposition": "WRITE_DISPOSITION"
  },
  "lineOfBusiness": "LINE_OF_BUSINESS"
}
'@  | Out-File -FilePath request.json -Encoding utf8

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://financialservices.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID:exportRegisteredParties" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "projects/PROJECT_ID/locations/LOCATION/operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.cloud.financialservices.v1.OperationMetadata",
    "createTime": "2023-03-14T15:52:55.358979323Z",
    "target": "projects/PROJECT_ID/locations/LOCATION/instances/INSTANCE_ID",
    "verb": "exportRegisteredParties",
    "requestedCancellation": false,
    "apiVersion": "v1"
  },
  "done": false
}

如要瞭解如何取得長時間執行的作業 (LRO) 結果，請參閱「管理長時間執行的作業」。

這個方法會輸出具有下列結構定義的 BigQuery 資料表：