Einstellungen konfigurieren

Auf dieser Seite wird beschrieben, wie Sie allgemeine Einstellungen für das Mainframe Assessment Tool konfigurieren und Standard-KI-Funktionen für neue Bewertungen ändern.

Die geänderten Einstellungen gelten nicht für vorhandene Bewertungen. Wenn Sie die geänderten Einstellungen verwenden möchten, erstellen Sie eine neue Bewertung.

Allgemeine Einstellungen konfigurieren

So konfigurieren Sie allgemeine Einstellungen für Ihre Bewertung:

  1. Klicken Sie auf das Symbol für die EinstellungenEinstellungen.

  2. So bearbeiten Sie Ihre Einstellungen für Cloud Logging und Google Analytics: Gehen Sie im Bereich Allgemeine Einstellungen so vor:

    • Wenn Sie Logging deaktivieren möchten, klicken Sie auf den Ein/Aus-Button Cloud Logging aktivieren , um ihn auf „Aus“ zu setzen. Diese Einstellung ist standardmäßig aktiviert.

      Weitere Informationen finden Sie in der Cloud Logging-Dokumentation.

    • Wenn Sie Google Analytics deaktivieren möchten, klicken Sie auf den Ein/Aus-Button Google Analytics aktivieren , um ihn auf „Aus“ zu setzen. Google Analytics ist standardmäßig aktiviert. Änderungen an dieser Einstellung werden erst nach dem Neuladen der Seite wirksam.

  3. Im Feld Google Cloud-Projekt sehen Sie die Google Cloud Projekt ID, die vom Mainframe Assessment Tool verwendet wird. Dieses Feld kann auf der UI nicht bearbeitet werden. Informationen zur Verwendung eines anderen Projekts finden Sie unter Das Google Cloud Projekt überschreiben.

  4. Wählen Sie unter Bereitstellungsebene eine Bereitstellungsebene für die Gemini Enterprise Agent Platform aus. Die Standardeinstellung ist Standard.

    Die Einstellung für die Bereitstellungsebene bestimmt das Inferenz- und Nutzungsmodell, das auf Gemini-Modellaufrufe während Mainframe-Bewertungen angewendet wird. Weitere Informationen zu den Bere101}itstellungsebenen der Gemini Enterprise Agent Platform finden Sie unter PayGo.

  5. Klicken Sie auf Einstellungen speichern.

Das Google Cloud Projekt überschreiben

Standardmäßig verwendet das Mainframe Assessment Tool das Google Cloud Projekt, in dem Ihre Instanz bereitgestellt wird. Wenn Sie das für Ihre Bewertungen verwendete Projekt überschreiben möchten, folgen Sie der Anleitung für Ihre Bereitstellungsumgebung.

Hinweis

So bereiten Sie das Überschreiben des Google Cloud Projekts vor:

  • Erforderliche Berechtigungen erteilen Welche Berechtigungen Sie benötigen, hängt davon ab, wie Sie das Mainframe Assessment Tool bereitgestellt haben:
    • In einer Compute Engine-VM-Instanz benötigen Sie die Berechtigung, benutzerdefinierte Metadaten für die Instanz festzulegen. Weitere Informationen zu den erforderlichen Rollen finden Sie unter Benutzerdefinierte Metadaten festlegen und entfernen.
    • In einem GKE-Cluster benötigen Sie die Berechtigung, Bereitstellungen im Cluster zu aktualisieren. Außerdem müssen Sie das Befehlszeilentool kubectl so konfigurieren, dass es eine Verbindung zum Cluster herstellt. Weitere Informationen finden Sie unter Clusterzugriff für kubectl konfigurieren.
  • Zugriff auf das Zielprojekt gewähren Erteilen Sie dem Dienstkonto, das von Mainframe Assessment Tool verwendet wird, die erforderlichen Rollen im Zielprojekt.

Das Projekt in einer Compute Engine-VM-Instanz überschreiben

Wenn Sie das Google Cloud Projekt in einer Compute Engine-VM-Instanz überschreiben möchten, fügen Sie den MAT_GCP_PROJECT_OVERRIDE Metadatenschlüssel hinzu und legen Sie seinen Wert auf Ihre Ziel Projekt-ID fest. Führen Sie dazu den folgenden gcloud Befehl aus:

gcloud compute instances add-metadata INSTANCE_NAME \
    --metadata=MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID \
    --zone=ZONE

Wenn Sie die Überschreibung entfernen möchten, entfernen Sie den Metadatenschlüssel mit dem folgenden gcloud-Befehl:

gcloud compute instances remove-metadata INSTANCE_NAME \
    --keys=MAT_GCP_PROJECT_OVERRIDE \
    --zone=ZONE

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: der Name Ihrer VM-Instanz.
  • PROJECT_ID: Ihre Ziel Google Cloud projekt-ID.
  • ZONE: die Zone, in der sich Ihre VM-Instanz befindet.

Das Mainframe Assessment Tool greift dann auf Ihre gespeicherte Projekt-ID zurück, falls vorhanden, oder auf das Projekt, in dem die Instanz bereitgestellt wird. Wenn Sie den Metadatenschlüssel in einer ausgeführten VM festlegen oder entfernen, müssen Sie die VM neu starten, damit die Änderungen wirksam werden.

Das Projekt in einem GKE-Cluster überschreiben

Wenn Sie das Google Cloud Projekt in einer GKE-Bereitstellung überschreiben möchten, legen Sie die MAT_GCP_PROJECT_OVERRIDE Umgebungsvariable im backend Container fest:

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE=PROJECT_ID --namespace=VERSION

Wenn Sie die Überschreibung entfernen möchten, heben Sie die Festlegung der Umgebungsvariable auf, indem Sie ein Minuszeichen (-) anhängen:

kubectl set env deployment/mat-apps --containers=backend \
    MAT_GCP_PROJECT_OVERRIDE- --namespace=VERSION

Ersetzen Sie Folgendes:

  • PROJECT_ID: Ihre Ziel Google Cloud projekt-ID.
  • VERSION: die Version des Mainframe Assessment Tool, die im Cluster bereitgestellt wird (z. B. mainframe-assessment-3-5-0).

Das Mainframe Assessment Tool greift dann auf Ihre gespeicherte Projekt-ID zurück, falls vorhanden, oder auf das Projekt, in dem die Instanz bereitgestellt wird. Wenn Sie die Umgebungsvariable aktualisieren, wird der Pod mit der angewendeten Projektüberschreibung neu gestartet. Da das Mainframe Assessment Tool als einzelner Pod ausgeführt wird, ist es während des Starts des neuen Pods kurzzeitig nicht verfügbar.

Standard-KI-Funktionen für neue Bewertungen konfigurieren

Mit dem Mainframe Assessment Tool können Sie die Standardparameter für KI-Statistiken in Ihren Bewertungen anpassen. KI-Statistiken sind standardmäßig aktiviert.

So konfigurieren Sie KI-Funktionen in neuen Bewertungen:

  1. Klicken Sie auf das Symbol für die EinstellungenEinstellungen.

  2. Wenn Sie Zusammenfassungen auf Absatzzebene für COBOL-Code generieren möchten, wählen Sie Detaillierte Zusammenfassungen aus.

    Diese Option ist standardmäßig ausgewählt, wenn die KI-Analyse aktiviert ist.

  3. Wenn Sie Testläufe für die von Gemini generierten Bewertungsspezifikationen erstellen möchten, wählen Sie Testläufe aus.

    Diese Option ist standardmäßig nicht ausgewählt, wenn die KI-Analyse aktiviert ist.

  4. Geben Sie unter Zusätzliche Hinweise zur Generierung Text ein, der während der KI-Generierung zu den Gemini-Prompts hinzugefügt werden soll.

  5. Klicken Sie auf Einstellungen speichern.

Systemzustand prüfen

Das Mainframe Assessment Tool prüft, ob in Ihrem Projekt Bewertungen ausgeführt werden können. Bei der Prüfung wird bestätigt, dass das Dienstkonto die erforderlichen IAM-Rollen enthält und dass jedes Gemini-Modell an jedem Endpunkt antwortet, der für eine Bewertung verwendet werden kann. Das Mainframe Assessment Tool führt die Prüfung beim Start aus. Die Prüfung blockiert keine Bewertungen.

So rufen Sie die Ergebnisse der Prüfung auf:

  1. Klicken Sie auf das Symbol für die EinstellungenEinstellungen.

  2. Prüfen Sie im Bereich Systemzustand Folgendes:

    • Geprüfte Identität: Das Dienstkonto, mit dem die Prüfung ausgeführt wurde.

    • IAM-Berechtigungen: Ob dieses Dienstkonto jede erforderliche Rolle enthält.

    • Modelle: Die Endpunkte, an denen jedes Modell antwortet. Für ein Modell, das nicht antwortet, gibt das Mainframe Assessment Tool den Endpunkt, die Ursache und die zu ergreifende Maßnahme an.

  3. Optional: Wenn Sie die Prüfung noch einmal ausführen möchten, z. B. nachdem Sie eine Rolle erteilt oder Ihre Netzwerkkonfiguration geändert haben, klicken Sie auf Nochmal prüfen.

Wenn bei der Prüfung ein Problem gefunden wird, zeigt das Mainframe Assessment Tool auf jeder Seite eine Benachrichtigung an, bis Sie das Problem behoben oder geschlossen haben.

Wenn die Cloud Resource Manager API in Ihrem Projekt nicht aktiviert ist, kann das Mainframe Assessment Tool keine IAM-Berechtigungen prüfen und meldet dies im Bereich Systemzustand. Informationen zum Aktivieren der API finden Sie unter APIs aktivieren.

Optional: Aktionen ausführen

In diesem Abschnitt wird beschrieben, wie Sie Aktionen ausführen, z. B. den Gemini-Cache leeren und Ihre Logs herunterladen.

So führen Sie Aktionen aus:

  1. Klicken Sie auf das Symbol für die EinstellungenEinstellungen.

  2. Wenn Sie den Gemini-Cache leeren möchten, klicken Sie auf Modellcache leeren.

  3. Wenn Sie Ihre Mainframe Assessment Tool-Logs herunterladen möchten, klicken Sie auf Support-Bundle herunterladen.

    Das Support-Bundle enthält die Mainframe Assessment Tool-Logs als ZIP-Datei, die Sie an den Google Cloud Support weitergeben können, um Probleme zu beheben.

KI-Statistiken für Bewertungen deaktivieren

Sie können die KI-Analyse deaktivieren, um zu verhindern, dass KI-Statistiken auf der Seite Bewertungen angezeigt werden.

So deaktivieren Sie die KI-Analyse für Bewertungen:

  1. Deaktivieren Sie im Bereich Standard-KI-Funktionen in neuen Bewertungen die Option KI-Statistiken aktivieren.

  2. Klicken Sie auf Einstellungen speichern.

Kosten der Agent Platform mit benutzerdefinierten Metadaten-Labels verfolgen

Das Mainframe Assessment Tool fügt automatisch benutzerdefinierte Metadaten-Labels zu allen Agent Platform-Anfragen hinzu, damit Sie Kosten verfolgen und analysieren können. In Ihrem Abrechnungsbericht können Sie diese Labels verwenden, um Kosten zu filtern und so die Nutzung der Agent Platform besser zu verstehen und zu optimieren. Die Kosten werden innerhalb von 24 Stunden nach der Nutzung im Abrechnungsbericht aktualisiert. In einigen Fällen kann es jedoch länger dauern.

Filtern Sie Kosten in Ihrem Abrechnungsbericht mit den folgenden Labels:

  • mat-version: Version des Mainframe Assessment Tool.
  • mat-host: Hostumgebung der Mainframe Assessment Tool-Instanz. Beispiel: Compute Engine-VM oder Google Kubernetes Engine.
  • mat-action-type: Art der Aktion, die vom Mainframe Assessment Tool ausgeführt wird.
  • mat-schema: Art des verarbeiteten Assets. Beispiel: COBOL oder JCL.
  • mat-target: Bereitstellungsziel der Mainframe Assessment Tool-Instanz.
  • mat-run-id: eindeutige ID der Bewertung.

Informationen zum Verfolgen der Nutzung mit einem oder mehreren dieser Filter im Abrechnungsbericht finden Sie unter Daten mit Filtern eingrenzen.

Weitere Informationen zu Labels in der Agent Platform finden Sie unter Benutzerdefinierte Metadaten-Labels.

Nächste Schritte