註冊派對

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

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
  • asia-south1
  • europe-west1
  • europe-west2
  • europe-west4
  • europe-west6
  • me-central2
  • 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引擎版本引擎設定使用的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
  • europe-west6
  • me-central2
  • 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 資料表：