使用 Agent Platform Threat Detection

Premium 和 Enterprise (已淘汰) 服務級別

Security Command Center Enterprise 服務級別將於 2027 年 5 月 21 日停用。 如果貴組織使用 Enterprise 服務級別，則會在 2027 年 5 月 21 日當天或之後自動移至 Premium 服務級別。如有任何問題，請與您的帳戶代表或Google Cloud 銷售專員聯絡。

預覽

這項功能適用《服務專屬條款》中「一般服務條款」一節的《正式發布前產品條款》。正式發布前功能是依「原樣」提供，支援服務可能受限。 詳情請參閱推出階段說明。

Agent Platform Threat Detection 可監控部署至 Agent Runtime 的 AI 代理，偵測安全威脅和異常的執行階段活動。您可以設定服務啟用、管理偵測模組、從發現項目中排除敏感指令列引數，以及查看發現項目，保護生成式 AI 工作負載。

本文中的程序僅適用於 Agent Platform Threat Detection 執行階段偵測工具。如要瞭解如何使用 Agent Runtime 的控制層偵測工具，請參閱「使用 Event Threat Detection」。

事前準備

1. 如要取得管理 Agent Platform Threat Detection 服務和模組所需的權限，請要求管理員授予組織、資料夾或專案的 Security Center Management 管理員 (roles/securitycentermanagement.admin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

   您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

2. 在所有專案中啟用 Container Threat Detection API，其中包含您要監控的託管 AI 代理。如果專案停用這個 API，Agent Platform Threat Detection 就無法監控該專案中的任何 AI 代理。

   如要查看組織或專案中支援的 AI 代理，請參閱本文的「查看部署至 Agent Runtime 的代理」一節。

   啟用 API 所需的角色

   如要啟用 API，您必須具備 serviceusage.services.enable 權限。如果您建立了專案，可能已透過擁有者角色 (roles/owner) 取得這項權限。否則，您可以透過 Service Usage 管理員角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

   啟用 API

啟用或停用 Agent Platform Threat Detection

根據預設，組織或專案會啟用 Agent Platform Threat Detection。如要停用或重新啟用 Agent Platform Threat Detection，請按照下列步驟操作：

控制台

如要透過 Google Cloud 控制台啟用或停用 Agent Platform Threat Detection，請按照下列步驟操作：

1. 前往 Google Cloud 控制台，在「AI Protection」部分點選「Service Enablement」。

   前往「Service Enablement」(服務啟用)

2. 選取您的機構或專案。

3. 如果尚未啟用 AI Protection，請按一下「啟用」。啟用後，頁面會顯示所有依賴 AI Protection 的服務，包括 Agent Platform Threat Detection。

4. 如果 Agent Platform Threat Detection 的狀態為「Disabled」(已停用)，請執行下列操作：

   1. 按一下「管理設定」。

   2. 選取要修改的組織、資料夾或專案啟用狀態，然後選取下列其中一項：

      • 啟用：啟用 Agent Platform Threat Detection。
      • 停用：停用 Agent Platform Threat Detection。
      • 沿用：沿用上層資料夾或組織的啟用狀態；僅適用於專案和資料夾。

gcloud

gcloud scc manage services update 指令會更新 Security Command Center 服務或模組的狀態。

使用下列任何指令資料前，請先替換以下項目：

• RESOURCE_TYPE：要更新的資源類型 (organization、folder 或 project)
• RESOURCE_ID：要更新的組織、資料夾或專案數值 ID；如果是專案，您也可以使用英數字元專案 ID
• NEW_STATE：ENABLED 表示啟用 Agent Platform Threat Detection；DISABLED 表示停用 Agent Platform Threat Detection；INHERITED 表示沿用上層資源的啟用狀態 (僅適用於專案和資料夾)

執行 gcloud scc manage services update 指令：

Linux、macOS 或 Cloud Shell

gcloud scc manage services update agent-engine-threat-detection \
    --RESOURCE_TYPE=RESOURCE_ID \
    --enablement-state=NEW_STATE

Windows (PowerShell)

gcloud scc manage services update agent-engine-threat-detection `
    --RESOURCE_TYPE=RESOURCE_ID `
    --enablement-state=NEW_STATE

Windows (cmd.exe)

gcloud scc manage services update agent-engine-threat-detection ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --enablement-state=NEW_STATE

您應該會收到類似以下的回應：

effectiveEnablementState: ENABLED
intendedEnablementState: INHERITED
modules:
  AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_CONTAINER_ESCAPE:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_URL_OBSERVED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REPORT_CLI_ARGUMENTS:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REVERSE_SHELL:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_UNEXPECTED_CHILD_SHELL:
    effectiveEnablementState: ENABLED
name: organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection
updateTime: '2025-08-20T18:14:24.731692211Z'

REST

Security Command Center Management API 的 RESOURCE_TYPE.locations.securityCenterServices.patch 方法會更新 Security Command Center 服務或模組的狀態。

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

• RESOURCE_TYPE：要更新的資源類型 (organizations、folders 或 projects)
• QUOTA_PROJECT：用於追蹤帳單和配額的專案 ID。
• RESOURCE_ID：要更新的組織、資料夾或專案數值 ID；如果是專案，您也可以使用英數字元專案 ID
• NEW_STATE：ENABLED 表示啟用 Agent Platform Threat Detection；DISABLED 表示停用 Agent Platform Threat Detection；INHERITED 表示沿用上層資源的啟用狀態 (僅適用於專案和資料夾)

HTTP 方法和網址：

PATCH https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=intendedEnablementState

JSON 要求主體：

{
  "intendedEnablementState": "NEW_STATE"
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: QUOTA_PROJECT" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=intendedEnablementState"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "QUOTA_PROJECT" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=intendedEnablementState" | Select-Object -Expand Content

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

{
  "name": "organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection",
  "intendedEnablementState": "INHERITED",
  "effectiveEnablementState": "ENABLED",
  "modules": {
    "AGENT_ENGINE_REPORT_CLI_ARGUMENTS": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_URL_OBSERVED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_CONTAINER_ESCAPE": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_REVERSE_SHELL": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_UNEXPECTED_CHILD_SHELL": {
      "effectiveEnablementState": "ENABLED"
    }
  },
  "updateTime": "2025-08-20T18:14:24.731692211Z"
}

啟用或停用 Agent Platform Threat Detection 模組

如要啟用或停用個別 Agent Platform Threat Detection 模組，請按照下列步驟操作。如要瞭解所有 Agent Platform Threat Detection 威脅發現項目和模組，請參閱「偵測工具」。

注意：如果停用 Agent Platform Threat Detection，Security Command Center 也會停用個別 Agent Platform Threat Detection 模組，並儲存先前的啟用狀態。如果重新啟用 Agent Platform Threat Detection，Security Command Center 會將模組還原至先前的啟用狀態。

控制台

在 Google Cloud 控制台中，您可以在組織或專案層級啟用或停用 Agent Platform Threat Detection 模組。

1. 前往 Google Cloud 控制台的 Agent Platform Threat Detection「Modules」(模組) 頁面。

   前往「Modules」(模組)

2. 選取您的機構或專案。

3. 在「Modules」(模組) 分頁的「Status」(狀態) 欄中，選取要啟用或停用的模組目前狀態，然後選取下列其中一項：

   • 啟用：啟用模組。
   • 停用：停用模組。

gcloud

gcloud scc manage services update 指令會更新 Security Command Center 服務或模組的狀態。

使用下列任何指令資料前，請先替換以下項目：

• RESOURCE_TYPE：要更新的資源類型 (organization、folder 或 project)。
• RESOURCE_ID：要更新的組織、資料夾或專案數字 ID。如果是專案，您也可以使用英數字元組成的專案 ID。
• MODULE_NAME：要啟用或停用的模組名稱。如要查看有效值，請參閱「Agent Platform Threat Detection 偵測工具」。
• NEW_STATE：ENABLED 表示啟用模組；DISABLED 表示停用模組；INHERITED 表示沿用父項資源的啟用狀態 (僅適用於專案和資料夾)。

將下列內容儲存至名為 request.json 的檔案：

{
  "MODULE_NAME": {
    "intendedEnablementState": "NEW_STATE"
  }
}

執行 gcloud scc manage services update 指令：

Linux、macOS 或 Cloud Shell

gcloud scc manage services update agent-engine-threat-detection \
    --RESOURCE_TYPE=RESOURCE_ID \
    --module-config-file=request.json

Windows (PowerShell)

gcloud scc manage services update agent-engine-threat-detection `
    --RESOURCE_TYPE=RESOURCE_ID `
    --module-config-file=request.json

Windows (cmd.exe)

gcloud scc manage services update agent-engine-threat-detection ^
    --RESOURCE_TYPE=RESOURCE_ID ^
    --module-config-file=request.json

您應該會收到類似以下的回應：

effectiveEnablementState: ENABLED
intendedEnablementState: INHERITED
modules:
  AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_CONTAINER_ESCAPE:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_URL_OBSERVED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REPORT_CLI_ARGUMENTS:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REVERSE_SHELL:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_UNEXPECTED_CHILD_SHELL:
    effectiveEnablementState: ENABLED
name: organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection
updateTime: '2025-08-20T18:14:24.731692211Z'

REST

Security Command Center Management API 的 RESOURCE_TYPE.locations.securityCenterServices.patch 方法會更新 Security Command Center 服務或模組的狀態。

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

• RESOURCE_TYPE：要更新的資源類型 (organizations、folders 或 projects)。
• QUOTA_PROJECT：用於追蹤帳單和配額的專案 ID。
• RESOURCE_ID：要更新的組織、資料夾或專案數字 ID。如果是專案，您也可以使用英數字元組成的專案 ID。
• MODULE_NAME：要啟用或停用的模組名稱。如需有效值，請參閱「Agent Platform Threat Detection 偵測工具」。
• NEW_STATE：ENABLED 表示啟用模組；DISABLED 表示停用模組；INHERITED 表示沿用父項資源的啟用狀態 (僅適用於專案和資料夾)。

HTTP 方法和網址：

PATCH https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=modules

JSON 要求主體：

{
  "modules": {
    "MODULE_NAME": {
      "intendedEnablementState": "NEW_STATE"
    }
  }
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: QUOTA_PROJECT" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=modules"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "QUOTA_PROJECT" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection?updateMask=modules" | Select-Object -Expand Content

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

{
  "name": "organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection",
  "intendedEnablementState": "INHERITED",
  "effectiveEnablementState": "ENABLED",
  "modules": {
    "AGENT_ENGINE_REPORT_CLI_ARGUMENTS": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_URL_OBSERVED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_CONTAINER_ESCAPE": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_REVERSE_SHELL": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_UNEXPECTED_CHILD_SHELL": {
      "effectiveEnablementState": "ENABLED"
    }
  },
  "updateTime": "2025-08-20T18:14:24.731692211Z"
}

查看 Agent Platform Threat Detection 模組的狀態

如要查看 Agent Platform Threat Detection 模組的狀態，請按照下列步驟操作。如要瞭解所有 Agent Platform Threat Detection 威脅發現項目和模組，請參閱「偵測工具」。

控制台

在 Google Cloud 控制台中，您可以在組織或專案層級，查看 Agent Platform Threat Detection 模組的啟用狀態。

1. 前往 Google Cloud 控制台的 Agent Platform Threat Detection「Modules」(模組) 頁面。

   前往「Modules」(模組)

2. 選取組織或專案。

gcloud

gcloud scc manage services describe 指令會取得 Security Command Center 服務或模組的狀態。

使用下列任何指令資料前，請先替換以下項目：

• RESOURCE_TYPE：要取得的資源類型 (organization、folder 或 project)
• RESOURCE_ID：要取得的組織、資料夾或專案數字 ID。如果是專案，您也可以使用英數字元組成的專案 ID。

執行 gcloud scc manage services describe 指令：

Linux、macOS 或 Cloud Shell

gcloud scc manage services describe agent-engine-threat-detection \
    --RESOURCE_TYPE=RESOURCE_ID

Windows (PowerShell)

gcloud scc manage services describe agent-engine-threat-detection `
    --RESOURCE_TYPE=RESOURCE_ID

Windows (cmd.exe)

gcloud scc manage services describe agent-engine-threat-detection ^
    --RESOURCE_TYPE=RESOURCE_ID

您應該會收到類似以下的回應：

effectiveEnablementState: ENABLED
intendedEnablementState: INHERITED
modules:
  AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_CONTAINER_ESCAPE:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MALICIOUS_URL_OBSERVED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REPORT_CLI_ARGUMENTS:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_REVERSE_SHELL:
    effectiveEnablementState: ENABLED
  AGENT_ENGINE_UNEXPECTED_CHILD_SHELL:
    effectiveEnablementState: ENABLED
name: organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection
updateTime: '2025-08-20T18:14:24.731692211Z'

REST

Security Command Center Management API 的 RESOURCE_TYPE.locations.securityCenterServices.get 方法會取得 Security Command Center 服務或模組的狀態。

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

• RESOURCE_TYPE：要取得的資源類型 (organizations、folders 或 projects)。
• QUOTA_PROJECT：用於追蹤帳單和配額的專案 ID。
• RESOURCE_ID：要取得的組織、資料夾或專案數字 ID。如果是專案，您也可以使用英數字元組成的專案 ID。

HTTP 方法和網址：

GET https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: QUOTA_PROJECT" \
     "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "QUOTA_PROJECT" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://securitycentermanagement.googleapis.com/v1/RESOURCE_TYPE/RESOURCE_ID/locations/global/securityCenterServices/agent-engine-threat-detection" | Select-Object -Expand Content

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

{
  "name": "organizations/1234567890/locations/global/securityCenterServices/agent-engine-threat-detection",
  "intendedEnablementState": "INHERITED",
  "effectiveEnablementState": "ENABLED",
  "modules": {
    "AGENT_ENGINE_REPORT_CLI_ARGUMENTS": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_BUILT_IN_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_KUBERNETES_ATTACK_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_URL_OBSERVED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_ADDED_MALICIOUS_LIBRARY_LOADED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_LOCAL_RECONNAISSANCE_TOOL_EXECUTION": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_CONTAINER_ESCAPE": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_SCRIPT_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MALICIOUS_PYTHON_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_REVERSE_SHELL": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_MODIFIED_MALICIOUS_BINARY_EXECUTED": {
      "effectiveEnablementState": "ENABLED"
    },
    "AGENT_ENGINE_UNEXPECTED_CHILD_SHELL": {
      "effectiveEnablementState": "ENABLED"
    }
  },
  "updateTime": "2025-08-20T18:14:24.731692211Z"
}

從發現項目中排除 CLI 引數

根據預設，Agent Platform Threat Detection 在發現項目中提供程序詳細資料時，會包含程序的指令列介面 (CLI) 引數。CLI 引數值在威脅調查中可能很重要。

不過，CLI 引數可能含有密鑰和其他機密資訊，因此您可能會決定從發現項目中排除 CLI 引數。

• 如要從 Agent Platform Threat Detection 發現項目中排除 CLI 引數，請將 AGENT_ENGINE_REPORT_CLI_ARGUMENTS 模組設為 DISABLED。

• 如要在 Agent Platform Threat Detection 發現項目中加入 CLI 引數，請將 AGENT_ENGINE_REPORT_CLI_ARGUMENTS 模組設為 ENABLED。

如需操作說明，請參閱本文件中的「啟用或停用 Agent Platform Threat Detection 模組」。

查看發現項目

Agent Platform Threat Detection 產生發現項目後，您可以在 Security Command Center 查看。

您可以在組織、資料夾或專案層級，授予 Security Command Center 的 IAM 角色。您能否查看、編輯、建立或更新發現項目、資產和安全性來源，取決於您獲得的存取權層級。如要進一步瞭解 Security Command Center 角色，請參閱「存取控管」。

如要在 Security Command Center 查看 Agent Platform Threat Detection 發現項目，請按照下列步驟操作：

1. 前往 Google Cloud 控制台的 Security Command Center「發現項目」頁面。

   前往「發現項目」

2. 選取 Google Cloud 專案或組織。
3. 在「快速篩選器」部分的「來源顯示名稱」子部分，選取「Agent Platform Threat Detection」。發現項目查詢結果會更新，只顯示這個來源的發現項目。
4. 如要查看特定發現項目的詳細資料，請按一下「Category」(類別) 欄中的發現項目名稱。系統會開啟發現項目的詳細資料面板，並顯示「摘要」分頁。
5. 在「摘要」分頁中，查看發現項目的詳細資料，包括偵測到的內容、受影響的資源，以及可採取的修復步驟 (如有)。
6. 選用：如要查看發現項目的完整 JSON 定義，請按一下「JSON」分頁標籤。

為協助您調查，威脅發現項目也包含下列外部資源的連結：

• MITRE ATT&CK 框架項目。這個架構說明攻擊雲端資源的技術，並提供修復指南。
• VirusTotal：Alphabet 旗下的服務，可提供潛在惡意檔案、指令碼、網址和網域的相關資訊。

如需 Agent Platform Threat Detection 發現項目類型清單，請參閱「Agent Platform Threat Detection 偵測工具」。

查看部署至 Agent Runtime 的代理

啟用 Agent Platform Threat Detection 後，系統會監控部署至 Agent Runtime 的 AI 代理。本節說明如何查看 Agent Platform Threat Detection 監控的各個代理資訊，包括相關聯的專案、架構、位置，以及該代理偵測到的任何發現項目。

Enterprise (已淘汰) 服務級別

如要取得查看 Agent Platform Threat Detection 可監控的 AI 代理所需的權限，請要求管理員授予組織或專案的 Security Command Center 管理員檢視者 (roles/securitycenter.adminViewer) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

1. 前往 Google Cloud 控制台的「AI Security」頁面。

   前往「AI Security」

2. 選取您的機構或專案。

3. 在資源類型清單中，選取「Agent Platform 代理」。系統會顯示代理。

4. 如要查看代理的詳細資料，請按一下代理名稱。

如要進一步瞭解如何在Google Cloud 控制台中使用資源，請參閱「檢查 Security Command Center 監控的資產」。

後續步驟

• 進一步瞭解 Agent Platform Threat Detection。
• 瞭解如何測試 Agent Platform Threat Detection。
• 瞭解如何應對 AI 威脅發現項目。
• 請參閱威脅發現項目索引。