创建和更新评估

本页介绍了如何将应用上传到 Mainframe Assessment Tool，以及如何评估 Mainframe Assessment Tool 在上传的代码库中发现的资产。

您可以自行执行资产发现，也可以请求 Google 客户工程师提供帮助。

准备工作

为准备评估，请确保您已完成以下前提条件：

将大型主机应用文件上传到 Mainframe Assessment Tool

如需将应用文件上传到 Mainframe Assessment Tool，请按以下步骤操作：

  1. 创建一个包含要迁移的所有应用的 ZIP 文件。

    Mainframe Assessment Tool 仅支持大小不超过 400 MB 的 zip 文件。如果应用 zip 文件大于 400 MB，请考虑根据业务网域将文件拆分为较小的 zip 文件，并为每个网域上传一个 zip 文件。

    如果应用包含对外部制品（例如程序或表）的引用，我们建议您也添加这些依赖项。如果可以，请提供以下类型的源代码：

    • COBOL 程序（cob 和 cbl）
    • COBOL copybook（inc 和 cpy）
    • Easytrieve 程序 (ezt)
    • HLASM 程序 (asm)
    • JCL 作业 (jcl)
    • JCL 过程 (proc)
    • JCL 包括
    • JCL 卡数据 (ctl)
    • PL/I 程序（pli 和 pl1）
    • RPG/RPGLE 程序（rpg 和 rpgle）
    • RPG/RPGLE 包含文件（rpginc 和 rpgleinc）
    • BMC Control-M 的调度器配置

    请勿在 ZIP 文件中添加二进制文件和其他非源文件。

  2. 如需将 ZIP 文件上传到 Mainframe Assessment Tool，请按以下步骤操作：

    1. 如需在本地计算机上打开 Mainframe Assessment Tool，请打开一个网络浏览器窗口，然后前往 http://localhost:PORT。

      将 PORT 替换为本地机器上用于与 Mainframe Assessment Tool 建立隧道连接的端口号。

    2. 在首页上，点击创建评估。

    3. 对于名称，请输入名称。

    4. 可选：在“说明”中，输入评估的说明。

    5. 如需上传 ZIP 文件，请点击选择文件。系统会打开文件浏览器。选择要上传的 ZIP 文件。您一次只能上传一个文件。

    6. 点击下一步。

  3. 如需配置 AI 生成的数据洞见，请按以下步骤操作：

    1. 如需为 COBOL 代码生成段落级摘要，请选择详细摘要。默认情况下，此选项处于选中状态。

    2. 如需为 Gemini 生成的评估规范生成测试用例，请选择测试用例。默认情况下，此选项处于未选中状态。

    3. 如需生成将大型机语言转换为 Python、Java、C# 和 SQL 的代码示例，请选择代码建议。默认情况下，此选项处于未选中状态。

    4. 对于技术堆栈提示，请输入有助于 Gemini 为特定技术堆栈生成代码的文本。例如，输入 Spring Boot and MySQL。

    5. 点击下一步。

  4. 如需配置评估所用的 Gemini 模型和质量级别，请配置模型和质量步骤，然后点击下一步。

    默认情况下，Mainframe Assessment Tool 使用建议的平衡质量级别。 如需详细了解质量级别、如何选择特定模型以及如何将数据保留在您所在的区域，请参阅选择模型和质量。

  5. 可选：如需添加一个或多个代表不同功能领域的网域，请点击添加网域。

    评估完成后，您可以通过网域根据特定情境过滤和查看结果。

  6. 点击下一步。

  7. 点击创建评估。

上传 ZIP 文件后，Mainframe Assessment Tool 会解压缩并处理源代码。评估页面会在表格中为每个发现的资产显示一个新条目，其中会显示相应资产的评估状态。

  • 待处理：评估正在等待轮到自己。
  • 正在进行：分析正在进行中。
  • 已分析：评估已完成。
  • 失败：知识评测未完成。

如果您在导入文件后看到错误，可以直接在 Mainframe Assessment Tool 中查看错误消息。

如需查看有关某个项目的评估进度的更多详情，请点击表格中该项目旁边的参考 ID。系统会打开一个页面，其中显示所有步骤及其状态。

选择模型和画质

在创建或修改评估时，配置 Gemini 模型以进行评估。这些设置仅适用于相应评估。

默认情况下，Mainframe Assessment Tool 会根据所选的质量级别，针对每个评估步骤优化模型。该工具会将复杂的推理步骤分配给较重的模型，并将较简单的步骤分配给较轻的模型。

选择质量级别

在优化部分，选择以下质量级别之一：

  • 平衡（推荐）：在大多数评估中，速度和深度之间可实现理想平衡。 这是默认级别。
  • 快速：使用较轻的模型返回最快的结果。
  • 扩展：使用更复杂的模型最大限度地提高分析深度。

每个质量级别都列出了每个步骤所用的 Gemini 模型。

指定单个模型

如需对单个模型运行所有评估步骤，而不是按级别进行优化，请选择改用特定模型，然后从列表中选择一个模型。每个模型都标记为正式版或预览版。

Mainframe Assessment Tool 支持所有可用的 Agent Platform 区域中的所有可用区。

强制执行数据驻留

默认情况下，Mainframe Assessment Tool 会将模型调用路由到所选模型的最佳位置，包括评估区域、多区域或全球代理平台端点。

如需将模型调用限制在评估区域及其关联的多区域，请启用将数据保留在我的区域。启用此设置后，Mainframe Assessment Tool 会执行以下操作：

  • 停用需要 Gemini 模型（在评估区域中不可用）的质量等级。这些级别会标记为此地区不支持。
  • 隐藏评估区域中不可用的特定型号列表中的型号。

如果评估区域中没有受支持的模型，则无法在启用将数据保留在我所在的区域的情况下运行评估。如需继续进行评估，请停用将数据保留在我的区域，以允许在该区域之外调用模型。

向现有评估中添加文件

创建评估后，您可以向其中添加其他 ZIP 文件。新 ZIP 文件中的文件会与评估中的现有文件合并。 如果您想替换现有文件，新的 ZIP 文件必须包含您要替换的文件，且路径结构完全相同。

如需向现有评估添加文件，请按以下步骤操作：

  1. 在网络浏览器中打开 Mainframe Assessment Tool。
  2. 在导航菜单中，点击评估。
  3. 在评估页面上，找到要修改的评估，然后点击 打开评估。
  4. 点击 添加文件。
  5. 点击选择文件，然后选择要上传的 ZIP 文件。 您一次只能上传一个文件。
  6. 点击 Add（添加）。

上传文件后，Mainframe Assessment Tool 会重新开始分析。 如果您替换文件，系统会重新全面评估这些文件，并且这些文件的任何现有分析结果可能会发生变化。在重新处理期间，系统会在正在重新处理的文件旁边显示过时指示器。

更新评估详细信息和设置

创建评估后，您可以更新其名称和说明，并修改 AI 生成的数据洞见设置。

如需更新评估详细信息或设置，请按以下步骤操作：

  1. 在网络浏览器中打开 Mainframe Assessment Tool。
  2. 在导航菜单中，点击评估。
  3. 在评估页面上，找到要修改的评估，然后点击 打开评估。
  4. 依次点击设置修改评估设置。
  5. 可选：在评估详细信息这一步中，修改名称和说明，然后点击下一步。
  6. 可选：在 AI 设置步骤中，根据需要修改 AI 设置，然后点击下一步。
  7. 可选：在模型和质量这一步中，配置模型或质量级别，然后点击下一步。如需了解详情，请参阅选择模型和质量。
  8. 在网域步骤中，点击下一步。创建评估后，您无法修改网域。
  9. 点击更新评估。

更新设置后，Mainframe Assessment Tool 会重新开始分析。

后续步骤