註冊客戶

本頁面會引導您完成下列步驟，註冊及取消註冊各方，以便建立預測結果：

1. 確認您已準備好註冊派對
2. 準備政黨登記資料表
3. 使用 projects.locations.instances.importRegisteredParties 方法註冊或取消註冊參與者
4. 驗證方法回應
5. (選用) 匯出已註冊的對象資料表

事前準備

開始之前，您需要一個 AML AI 執行個體。

如要讓模型建立風險分數預測值，您必須先註冊對象。建議您在擁有下列項目時註冊派對：

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

註冊參與者的時機

您必須先註冊群組，才能在某個資料集中為群組建立預測結果。訓練、調整或回測時，不需要註冊。

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

註冊參與者會產生額外費用，每位註冊參與者每月需支付額外費用 (詳情請參閱定價頁面)。

如何準備派對登記表

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

為您要註冊的業務範圍準備表格。如果您已註冊部分參與者，此參與者註冊資料表可能會包含您要用於預測結果的 參與者 資料表中部分參與者。

零售方結構定義

商業當事人結構定義

如何註冊政黨

每個反洗錢 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
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• 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
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • northamerica-northeast1
  • southamerica-east1
  • australia-southeast1
• 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 資料表：