配置设置

本页面介绍如何配置 Mainframe Assessment Tool 的常规设置,以及如何修改新评估的默认 AI 功能。

修改后的设置不适用于现有评估。如需使用修改后的设置,请创建新的评估。

配置常规设置

如需为评估配置常规设置,请按以下步骤操作:

  1. 点击设置设置 图标。

  2. 如需修改 Cloud Logging 和 Google Analytics 的偏好设置,请在常规设置 部分中执行以下操作:

    • 如需关闭 Logging,请点击启用 Cloud Logging 切换开关,将其切换到关闭位置。默认情况下,此设置处于启用状态。

      如需了解详情,请参阅 Cloud Logging 文档

    • 如需关闭 Google Analytics,请点击启用 Google Analytics 切换开关,将其切换到关闭位置。默认情况下,Google Analytics 处于启用状态。只有在您重新加载页面后,对此设置所做的更改才会生效。

  3. 查看 Google Cloud 项目 字段,了解 Mainframe Assessment Tool 使用的 Google Cloud 项目 ID。您无法在界面中修改此字段。 如需使用其他项目,请参阅 替换 Google Cloud 项目

  4. 对于服务层级 ,请选择 Gemini Enterprise Agent Platform 服务层级。默认值为标准

    服务层级设置决定了在大型机评估期间应用于 Gemini 模型调用的推理和使用模式。如需详细了解 Gemini Enterprise Agent Platform 服务层级,请参阅 PayGo

  5. 点击保存设置

替换 Google Cloud 项目

默认情况下,Mainframe Assessment Tool 使用部署实例的 Google Cloud 项目。如需替换用于评估的项目,请按照适用于您的部署环境的说明操作。

准备工作

如需准备替换 Google Cloud 项目,请完成以下 任务:

  • 授予必要权限。您需要的权限取决于您部署 Mainframe Assessment Tool 的方式:
    • 在 Compute Engine 虚拟机实例上,您需要拥有在该实例上设置自定义元数据的权限。如需详细了解所需角色,请参阅 设置和移除自定义元数据
    • 在 GKE 集群上,您需要拥有更新集群中部署的权限,并且必须配置 kubectl 命令行工具以连接到集群。如需了解详情,请参阅 为 kubectl 配置集群访问权限
  • 提供目标项目访问权限。向 Mainframe Assessment Tool 使用的服务帐号授予目标项目中的 必要角色

替换 Compute Engine 虚拟机实例上的项目

如需替换 Compute Engine 虚拟机实例上的 Google Cloud 项目,请添加 MAT_GCP_PROJECT_OVERRIDE元数据键,并通过运行以下 gcloud命令将其值设置为目标 项目 ID:

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID \
    --zone=ZONE

如需移除替换,请运行以下 gcloud 命令来移除元数据键:

gcloud compute instances remove-metadata INSTANCE_NAME \
    --keys=MAT_GCP_PROJECT_OVERRIDE \
    --zone=ZONE

替换以下内容:

  • INSTANCE_NAME:虚拟机实例的名称。
  • PROJECT_ID:您的目标 Google Cloud 项目 ID。
  • ZONE:虚拟机实例所在的可用区。

然后,Mainframe Assessment Tool 会回退到您保存的项目 ID(如果有),或回退到部署实例的项目。如果您在运行的虚拟机上设置或移除元数据键,则必须重启虚拟机,更改才会生效。

替换 GKE 集群上的项目

如需替换 GKE 部署上的 Google Cloud 项目, 请在 backend 容器上设置 MAT_GCP_PROJECT_OVERRIDE 环境变量:

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID --namespace=VERSION

如需移除替换,请通过附加连字符 (-) 来取消设置环境变量:

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE- --namespace=VERSION

替换以下内容:

  • PROJECT_ID:您的目标 Google Cloud 项目 ID。
  • VERSION:部署在集群上的 Mainframe Assessment Tool 版本(例如 mainframe-assessment-3-5-0)。

然后,Mainframe Assessment Tool 会回退到您保存的项目 ID(如果有),或回退到部署实例的项目。更新环境变量会重启应用了项目替换的 pod。由于 Mainframe Assessment Tool 作为单个 pod 运行,因此在启动新 pod 时,它会暂时不可用。

为新评估配置默认 AI 功能

Mainframe Assessment Tool 可让您自定义评估中 AI 分析洞见的默认参数。默认情况下,AI 分析洞见处于启用状态。

如需在新评估中配置 AI 功能,请按以下步骤操作:

  1. 点击设置设置 图标。

  2. 如需为 COBOL 代码生成段落级摘要,请选择详细摘要

    默认情况下,启用 AI 分析后,此选项处于选中状态。

  3. 如需为 Gemini 生成的评估规范生成测试用例,请选择测试用例

    默认情况下,启用 AI 分析后,此选项未选中。

  4. 对于其他生成指南,请输入要在 AI 生成期间添加到 Gemini 提示中的文本。

  5. 点击保存设置

检查系统运行状况

Mainframe Assessment Tool 会检查您的项目是否可以运行评估。该检查会确认服务帐号是否拥有所需的 IAM 角色,以及每个 Gemini 模型是否在评估可以使用的每个端点上做出响应。Mainframe Assessment Tool 会在启动时运行检查。该检查不会阻止评估。

如需查看检查结果,请按以下步骤操作:

  1. 点击设置设置 图标。

  2. 系统运行状况 部分中,查看以下内容:

    • 检查的身份:运行检查的服务帐号。

    • IAM 权限:该服务帐号是否拥有每个必要 角色。

    • 模型:每个模型响应的端点。对于不响应的模型,Mainframe Assessment Tool 会命名端点、原因和要采取的操作。

  3. 可选:如需再次运行检查(例如在您授予角色或更改网络配置后),请点击重新检查

如果检查发现问题,Mainframe Assessment Tool 会在每个页面上显示通知,直到您修复或关闭该问题为止。

如果您的项目未启用 Cloud Resource Manager API,则 Mainframe Assessment Tool 无法验证 IAM 权限,并在系统运行状况 部分中报告此情况。如需启用该 API,请参阅 启用 API

可选:执行操作

本部分介绍如何执行操作,例如清除 Gemini 缓存和下载日志。

如需执行操作,请按以下步骤操作:

  1. 点击设置设置 图标。

  2. 如需清除 Gemini 缓存,请点击清除模型缓存

  3. 如需下载 Mainframe Assessment Tool 日志,请点击下载支持软件包

    支持软件包包含 Mainframe Assessment Tool 日志(以 zip 文件形式), 您可以与 Google Cloud 支持团队分享该文件,以便排查问题。

为评估停用 AI 分析洞见

您可以停用 AI 分析,以防止 AI 分析洞见显示在评估 页面上。

如需为评估停用 AI 分析,请按以下步骤操作:

  1. 新评估中的默认 AI 功能 部分中,取消选中启用 AI 分析洞见

  2. 点击保存设置

使用自定义元数据标签跟踪 Agent Platform 费用

Mainframe Assessment Tool 会自动向所有 Agent Platform 请求添加自定义元数据标签,以帮助您跟踪和分析费用。 在结算报告中,您可以使用这些标签过滤费用,以便更好地了解和优化 Agent Platform 用量。费用会在使用后 24 小时内在结算报告中更新,但在某些情况下可能需要更长时间。

使用以下标签过滤结算报告中的费用:

  • mat-version:Mainframe Assessment Tool 的版本。
  • mat-host:Mainframe Assessment Tool 实例的宿主环境。例如,Compute Engine 虚拟机或 Google Kubernetes Engine。
  • mat-action-type:Mainframe Assessment Tool 执行的操作类型。
  • mat-schema:处理的资产类型。例如,COBOLJCL
  • mat-target:Mainframe Assessment Tool 实例的部署目标。
  • mat-run-id:评估的唯一 ID。

如需在结算报告中使用其中一个或多个过滤条件来跟踪用量,请参阅 使用过滤条件优化数据

如需详细了解 Agent Platform 中的标签,请参阅 自定义元数据标签

后续步骤