Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

使用 Agent Platform Threat Detection

本页面介绍了如何配置 Agent Platform Threat Detection。

本文档中的步骤仅适用于 Agent Platform Threat Detection 运行时检测器。如需了解如何使用 control plane detectors for Agent Runtime 的控制平面检测器，请参阅使用 Event Threat Detection。

准备工作

如需获得管理 Agent Platform Threat Detection 服务及其模块所需的权限，请让您的管理员为您授予组织、文件夹或项目的Security Center Management Admin (roles/securitycentermanagement.admin) IAM 角色。如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。
在包含要监控的托管式 AI 代理的所有项目中启用 Container Threat Detection API。如果此 API 在某个项目中处于停用状态，Agent Platform Threat Detection 将无法监控该项目中的任何 AI 智能体。

如需查看组织中受支持的 AI 代理，请参阅本文档中的查看已部署到 Agent Runtime的代理。

启用 API 所需的角色
如需启用 API，您需要拥有 serviceusage.services.enable 权限。如果您创建了项目，则可能已通过所有者角色 (roles/owner) 拥有此权限。否则，您可以通过 Service Usage Admin 角色 (roles/serviceusage.serviceUsageAdmin) 获得此权限。了解如何授予角色。
启用 API

启用或停用 Agent Platform Threat Detection

默认情况下，您的组织已启用 Agent Platform Threat Detection。如需停用或重新启用 Agent Platform Threat Detection，请按照以下步骤操作：

控制台

如需通过 Google Cloud 控制台启用或停用 Agent Platform Threat Detection，请按以下步骤操作：

在 Google Cloud 控制台中，前往AI Protection 的服务启用 页面。

前往“服务启用”
选择您的组织。
如果 AI Protection 尚未启用，请点击激活。启用后，该页面上会显示所有依赖于 AI Protection 的服务，包括 Agent Platform Threat Detection。
如果 Agent Platform Threat Detection 的状态为已停用，请执行以下操作：
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
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
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 威胁发现结果及其模块，请参阅检测器。

控制台

在 Google Cloud 控制台中，您可以在组织级启用或停用 Agent Platform Threat Detection 模块。

在 Google Cloud 控制台中，前往 Agent Platform Threat Detection 的模块页面。

进入“模块”
选择您的组织。
在模块标签页的状态列中，选择要启用或停用的模块的当前状态，然后选择以下任一选项：
- 启用：启用模块。
- 停用：停用模块。

使用 Agent Platform Threat Detection 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

启用或停用 Agent Platform Threat Detection

控制台

gcloud

Linux、macOS 或 Cloud Shell

Windows (PowerShell)

Windows (cmd.exe)

REST

curl（Linux、macOS 或 Cloud Shell）

PowerShell (Windows)

启用或停用 Agent Platform Threat Detection 模块

控制台

gcloud

使用 Agent Platform Threat Detection