创建和更新评估

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

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

准备工作

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

• 针对 Mainframe Assessment Tool 配置项目 Google Cloud
• 设置和访问 Mainframe Assessment Tool

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

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

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

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

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

   • COBOL 程序（cob 和 cbl）
   • COBOL 副本（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. 在 Additional generation guidance（其他生成指南）中，输入要在 Gemini 提示中添加的文本，以便在 AI 生成期间使用。

   4. 点击下一步 。

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 会将模型调用路由到所选模型的最佳位置，包括评估区域、多区域或全局 Agent Platform 端点。

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

• 停用需要 Gemini 模型（评估区域中不可用）的质量级别。这些级别标有此区域中不可用 。
• 从特定模型列表中隐藏评估区域中不可用的模型。

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

如果您的 Mainframe Assessment Tool 实例没有外部 IP 地址，并且 您启用了 将数据保留在我的区域内，则可能无法使用仅在多区域 端点上提供的模型。发生这种情况的原因是 专用 Google 访问通道无法访问 多区域端点。如需在遵守数据驻留要求的同时提供这些模型，请设置与多区域端点的专用连接。如需了解相关说明，请参阅 配置专用连接以实现数据驻留。

向现有评估添加文件

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

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

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

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

更新评估详细信息和设置

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

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

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

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

后续步骤

• 了解如何查看和解读评估结果。