建立及更新評估

本頁說明如何將應用程式上傳至 Mainframe Assessment Tool，以及如何評估 Mainframe Assessment Tool 在上傳的程式碼庫中探索到的資產。

您可以自行發掘資產，也可以要求 Google 客戶工程師提供協助。

事前準備

如要準備評估，請確認已完成下列先決條件：

• 設定 Google Cloud 專案以使用 Mainframe Assessment Tool
• 設定及存取 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. 如需其他生成指引，請輸入文字，在 AI 生成期間新增至 Gemini 提示。

   4. 點選「下一步」。

4. 如要設定評估使用的 Gemini 模型和品質等級，請設定「模型和品質」步驟，然後按一下「下一步」。

   根據預設，Mainframe Assessment Tool 會使用建議的 Balanced 品質等級。如要進一步瞭解品質等級、如何選擇特定模型，以及如何將資料保留在您所在的區域，請參閱「選擇模型和品質」。

5. 選用：如要新增一或多個網域來代表不同的功能區域，請按一下「新增網域」。

   評估完成後，您可以使用網域，根據特定情境篩選及查看結果。

6. 點選「下一步」。

7. 按一下「建立評估」。

上傳 ZIP 檔案後，Mainframe Assessment Tool 會解壓縮並處理原始碼。「評估」頁面會顯示每個已發現資產的表格新項目，並顯示評估狀態。

• 待處理：評估正在等待輪到自己。
• 進行中：分析正在進行中。
• 已分析：評估已完成。
• Failed (已失敗)：評估未完成。

如果匯入檔案後看到錯誤訊息，可以直接在 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. 在「評估」頁面中，找出要修改的評估，然後按一下「開啟評估」圖示 arrow_forward。
4. 按一下「新增檔案」add。
5. 按一下「選取檔案」，然後選取要上傳的 ZIP 檔案。 一次只能上傳一個檔案。
6. 按一下「新增」。

上傳檔案後，Mainframe Assessment Tool 會再次開始分析。 如果取代檔案，系統會重新評估檔案，這些檔案的現有分析結果可能會變更。重新處理期間，重新處理的檔案旁會顯示「過時」指標。

更新評估詳細資料和設定

建立評估後，您可以更新名稱和說明，以及修改 AI 生成洞察資料的設定。

如要更新評估詳細資料或設定，請按照下列步驟操作：

1. 在網路瀏覽器中開啟 Mainframe Assessment Tool。
2. 在導覽選單中，按一下「評估」。
3. 在「評估」頁面中，找出要修改的評估，然後按一下「開啟評估」圖示 arrow_forward。
4. 依序點選「設定」「編輯評估設定」。
5. 選用：在「評估詳細資料」步驟中，編輯名稱和說明，然後按一下「下一步」。
6. 選用：在「AI 設定」步驟中，視需要修改 AI 設定，然後按一下「下一步」。
7. 選用：在「模型和品質」步驟中，設定模型或品質等級，然後點按「下一步」。詳情請參閱「選擇模型和品質」。
8. 在「網域」步驟中，按一下「下一步」。評估建立完成後，就無法編輯網域。
9. 按一下「更新評估」。

更新設定後，Mainframe Assessment Tool 會再次開始分析。

後續步驟

• 瞭解如何查看及解讀評估結果。