创建和更新评估

本页介绍了如何将大型主机应用文件上传到 Mainframe Assessment Tool 并创建评估。

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

准备工作

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

  1. 为 Mainframe Assessment Tool 配置您的 Google Cloud 项目。
  2. 设置并访问 Mainframe Assessment Tool。
  3. 创建一个 ZIP 文件，其中包含您要迁移的所有应用：
    • Mainframe Assessment Tool 仅支持大小不超过 400 MB 的 ZIP 文件。 如果您的应用 ZIP 文件大于 400 MB，请考虑根据业务网域将文件拆分为较小的 ZIP 文件，并为每个网域上传一个 ZIP 文件。
    • 如果应用包含对外部工件（例如程序或表）的引用，我们建议您也包含这些依赖项。如需查看受支持的语言、数据库、事务 监控器和调度器配置的列表，请参阅 支持的语言。
    • 请勿在 ZIP 文件中添加二进制文件和其他非源文件。

创建评估

如需上传 ZIP 文件并在 Mainframe Assessment Tool 中创建评估，请按以下步骤操作：

评估详细信息

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

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

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

  3. 在名称字段中，输入评估的名称。

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

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

  6. 点击下一步 。

AI 洞见

  1. 可选：如需为评估启用 AI 洞见，请选择启用 AI 洞见 。
  2. 如需为 COBOL 代码生成段落级摘要，请选择详细摘要 。默认情况下，此选项处于选中状态。
  3. 如需为 Gemini 生成的评估规范生成测试用例，请选择测试用例 。默认情况下，此选项未选中。

  4. 如需提取有关应用访问的数据库和文件的信息，请选择数据源 。

  5. 可选：在其他生成指南字段中，输入自由格式的指南 ，以便在 AI 生成期间添加到 Gemini 提示词中。

  6. 点击下一步 。

模型和质量

为评估配置 Gemini 模型。这些设置仅适用于此评估。

  1. 选择 Mainframe Assessment Tool 如何将评估步骤路由到 Gemini 模型：

    • 快速：使用较轻的模型返回最快的结果。
    • 平衡 （推荐）：通过将复杂的推理步骤路由到较重的模型，并将简单的步骤路由到较轻的模型，在速度和深度之间取得平衡，适用于大多数评估。这是默认选项。

    • 扩展：通过使用较重的模型，最大限度地提高分析深度。

    • 改用特定模型：在单个 模型上运行所有评估步骤，而不是按级别进行优化。从列表中选择一个模型。 每个模型都标有正式版 或预览版。

    每个质量级别都会列出每个步骤使用的 Gemini 模型。Mainframe Assessment Tool 支持可用 Agent Platform 区域内的所有可用区。

  2. 可选：如需将模型调用限制为评估区域及其关联的多区域，请启用将数据保留在我的区域中 。

    默认情况下，Mainframe Assessment Tool 会将模型调用路由到所选模型的最佳位置，包括评估区域、多区域或全局 Agent Platform 端点。启用此设置后，Mainframe Assessment Tool 会执行以下操作：

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

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

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

  3. 点击下一步 。

可选：网域

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

    借助网域，您可以在评估完成后根据特定上下文过滤和查看结果。

  2. 点击下一步 。

创建评估

  1. 点击创建评估 。

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

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

如果在导入文件后看到出错提示，您可以直接在 Mainframe Assessment Tool 中查看出错提示。

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

向现有评估添加文件

创建评估后，您可以向其中添加其他 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 会再次开始分析。

后续步骤