評価の作成と更新

このページでは、メインフレーム アプリケーション ファイルを 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 ファイルを選択します。一度にアップロードできるファイルは 1 つだけです。

  6. [次へ] をクリックします。

AI インサイト

  1. 省略可: 評価で AI インサイトを有効にするには、[AI インサイトを有効にする] を選択します。
  2. COBOL コードの段落レベルの要約を生成するには、[詳細な要約] を選択します。デフォルトでは、このオプションが選択されています。
  3. Gemini によって生成された評価仕様のテストケースを生成するには、[テストケース] を選択します。デフォルトでは、このオプションは選択されていません。
  4. アプリケーションがアクセスするデータベースとファイルに関する情報を抽出するには、[データソース] を選択します。

  5. 省略可: [追加の生成ガイダンス] に、AI 生成時に Gemini プロンプトに追加する自由形式のガイダンス を入力します。

  6. [次へ] をクリックします。

モデルと品質

評価用の Gemini モデルを構成します。これらの設定はこの評価にのみ適用されます。

  1. Mainframe Assessment Tool が評価ステップを Gemini モデルにルーティングする方法を選択します。

    • 高速: 軽量モデルを使用して、最も迅速に結果を返します。
    • バランス (推奨): 複雑な推論ステップをより重いモデルに、単純なステップをより軽量なモデルにルーティングすることで、ほとんどの評価で速度と深さのバランスを取ります。これはデフォルトのオプションです。
    • 拡張: より重いモデルを使用して分析の深さを最大化します。

    • 代わりに特定のモデルを使用する: レベルごとに最適化するのではなく、1 つの モデルですべての評価ステップを実行します。リストからモデルを選択します。 各モデルには、[General Availability] または [Preview]のラベルが付いています。

    各品質レベルには、各ステップで使用される Gemini モデルが一覧表示されます。Mainframe Assessment Tool は、使用可能な Agent Platform リージョン内のすべてのゾーンをサポートしています。

  2. 省略可: モデル呼び出しを評価リージョンとその関連するマルチリージョンに制限するには、[リージョン内にデータを保持する] を有効にします。

    デフォルトでは、Mainframe Assessment Tool は、評価リージョン、マルチリージョン、グローバル Agent Platform エンドポイントなど、選択したモデルに最適な場所にモデル呼び出しをルーティングします。この設定を有効にすると、Mainframe Assessment Tool は次の処理を行います。

    • 評価リージョンで使用できない Gemini モデルを必要とする品質レベルを無効にします。これらのレベルには [このリージョンでは利用できません] というラベルが付いています。
    • 評価リージョンで使用できないモデルを、特定のモデルリストから非表示にします。

    評価リージョンで使用可能なサポート対象モデルがない場合、[リージョン内にデータを保持する] を有効にすると評価を実行できません。評価を進めるには、[リージョン内にデータを保持する] を無効にして、リージョン外でのモデル呼び出しを許可します。

    Mainframe Assessment Tool インスタンスに外部 IP アドレスがなく、[リージョン内にデータを保持する] を有効にすると、マルチリージョン エンドポイントでのみモデル提供されるモデルが使用できなくなる可能性があります。これは、 プライベート Google アクセスが マルチリージョン エンドポイントに到達できないためです。データ所在地要件に準拠しながらこれらのモデルを使用できるようにするには、マルチリージョン エンドポイントへのプライベート接続を設定します。手順については、データ所在地用にプライベート接続を構成する をご覧ください。

  3. [次へ] をクリックします。

省略可: ドメイン

  1. 省略可: 異なる機能領域を表す 1 つ以上のドメインを追加するには、[ドメインを追加] をクリックします。

    ドメインを使用すると、評価が完了した後、特定のコンテキストに基づいて結果をフィルタして確認できます。

  2. [次へ] をクリックします。

評価の作成

  1. [評価を作成] をクリックします。

ZIP ファイルをアップロードすると、Mainframe Assessment Tool はソースコードを解凍して処理します。[評価] ページには、検出されたアセットごとに新しいエントリがテーブルに表示され、評価ステータスが表示されます。

  • 保留中: 評価の順番待ちです。
  • 処理中: 分析が進行中です。
  • 分析済み: 評価が完了しました。
  • 失敗: 評価が完了しませんでした。

ファイルをインポートした後にエラーが表示された場合は、Mainframe Assessment Tool でエラー メッセージを直接確認できます。

アイテムの評価の進捗状況の詳細を表示するには、テーブル内のアイテムの横にある参照 ID をクリックします。ステータスとともにすべてのステップが表示されるページが開きます。

既存の評価にファイルを追加する

評価を作成した後、追加の ZIP ファイルを追加できます。 新しい ZIP ファイルのファイルは、評価内の既存のファイルとマージされます。 既存のファイルを置き換える 場合は、新しい ZIP ファイルに、置き換えるファイルとまったく同じパス構造のファイルを含める必要があります。

既存の評価にファイルを追加する手順は次のとおりです。

  1. ウェブブラウザで Mainframe Assessment Tool を開きます。
  2. ナビゲーション メニューで [評価] をクリックします。
  3. [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
  4. [**ファイルを追加**] をクリックします。
  5. [ファイルを選択] をクリックして、アップロードする ZIP ファイルを選択します。 一度にアップロードできるファイルは 1 つだけです。
  6. [追加] をクリックします。

ファイルをアップロードすると、Mainframe Assessment Tool は分析を再開します。 ファイルを置き換えると、ファイルが完全に再評価され、これらのファイルの既存の分析が変更される可能性があります。再処理中、再処理中のファイルの横に [古い] インジケーターが表示されます。

評価の詳細と設定を更新する

評価を作成した後、名前と説明を更新し、AI 生成インサイトの設定を変更できます。

評価の詳細または設定を更新する手順は次のとおりです。

  1. ウェブブラウザで Mainframe Assessment Tool を開きます。
  2. ナビゲーション メニューで [評価] をクリックします。
  3. [評価] ページで、変更する評価を見つけて、 [評価を開く] をクリックします。
  4. settings [**評価設定を編集**] をクリックします。
  5. 省略可: [評価の詳細] ステップで、名前と説明を編集して [次へ] をクリックします。
  6. 省略可: [AI インサイト] ステップで、必要に応じて AI 設定を変更して [次へ] をクリックします。
  7. 省略可: [モデルと品質] ステップで、モデルまたは品質レベルを構成して [次へ] をクリックします。
  8. [ドメイン(省略可)] ステップで、[次へ] をクリックします。評価を作成した後にドメインを編集することはできません。
  9. [評価を更新] をクリックします。

設定を更新すると、Mainframe Assessment Tool は分析を再開します。

次のステップ

  • 評価結果を確認して理解する方法を確認する。