Configura impostazioni

Questa pagina descrive come configurare le impostazioni generali di Mainframe Assessment Tool e modificare le funzionalità di AI predefinite per le nuove valutazioni.

Le impostazioni modificate non si applicano alle valutazioni esistenti. Per utilizzare le impostazioni modificate, crea una nuova valutazione.

Configurare le impostazioni generali

Per configurare le impostazioni generali della valutazione:

  1. Fai clic sull'icona delle impostazioniImpostazioni.

  2. Per modificare le preferenze per Cloud Logging e Google Analytics, nella sezione Impostazioni generali:

    • Per disattivare Logging, fai clic sul pulsante di attivazione/disattivazione Abilita Cloud Logging in modo che sia impostato su Off. Per impostazione predefinita, questa impostazione è abilitata.

      Per ulteriori informazioni, consulta la documentazione di Cloud Logging.

    • Per disattivare Google Analytics, fai clic sul pulsante di attivazione/disattivazione Abilita Google Analytics in modo che sia impostato su Off. Per impostazione predefinita, Google Analytics è abilitato. Le modifiche a questa impostazione diventano effettive solo dopo aver ricaricato la pagina.

  3. Visualizza il campo Progetto Google Cloud per vedere l' Google Cloud ID progetto utilizzato da Mainframe Assessment Tool. Non puoi modificare questo campo nell'UI. Per utilizzare un progetto diverso, vedi Sostituire il Google Cloud progetto.

  4. Per Livello di pubblicazione, seleziona un livello di pubblicazione di Gemini Enterprise Agent Platform. Il valore predefinito è Standard.

    L'impostazione del livello di pubblicazione determina il modello di inferenza e consumo applicato alle chiamate del modello Gemini durante le valutazioni del mainframe. Per ulteriori informazioni sui livelli di pubblicazione di Gemini Enterprise Agent Platform, vedi PayGo.

  5. Fai clic su Salva impostazioni.

Sostituire il Google Cloud progetto

Per impostazione predefinita, Mainframe Assessment Tool utilizza il Google Cloud progetto in cui è stato eseguito il deployment dell' istanza. Per sostituire il progetto utilizzato per le valutazioni, segui le istruzioni per l'ambiente di deployment.

Prima di iniziare

Per prepararti a sostituire il Google Cloud progetto, completa le seguenti attività:

  • Concedi le autorizzazioni necessarie. Le autorizzazioni richieste dipendono dalla modalità di deployment di Mainframe Assessment Tool:
    • In un'istanza VM di Compute Engine, devi avere l'autorizzazione per impostare i metadati personalizzati sull'istanza. Per informazioni dettagliate sui ruoli richiesti, vedi Impostare e rimuovere i metadati personalizzati.
    • In un cluster GKE, devi avere l'autorizzazione per aggiornare i deployment nel cluster e devi configurare lo strumento a riga di comando kubectl per connetterti al cluster. Per ulteriori informazioni, vedi Configurare l'accesso al cluster per kubectl.
  • Fornisci l'accesso al progetto di destinazione. Concedi al account di servizio utilizzato da Mainframe Assessment Tool i ruoli richiesti nel progetto di destinazione.

Sostituire il progetto in un'istanza VM di Compute Engine

Per sostituire il Google Cloud progetto in un'istanza VM di Compute Engine, aggiungi la chiave dei metadati MAT_GCP_PROJECT_OVERRIDE e imposta il relativo valore sull'ID progetto di destinazione eseguendo il seguente comando gcloud:

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

Per rimuovere la sostituzione, rimuovi la chiave dei metadati eseguendo il seguente comando gcloud:

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

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza VM.
  • PROJECT_ID: l'ID progetto di destinazione Google Cloud .
  • ZONE: la zona in cui si trova l'istanza VM.

Mainframe Assessment Tool torna quindi all'ID progetto salvato, se ne hai uno, o al progetto in cui è stato eseguito il deployment dell'istanza. Se imposti o rimuovi la chiave dei metadati su una VM in esecuzione, devi riavviare la VM affinché le modifiche diventino effettive.

Sostituire il progetto in un cluster GKE

Per sostituire il Google Cloud progetto in un deployment GKE, imposta la variabile di ambiente MAT_GCP_PROJECT_OVERRIDE nel backend container:

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

Per rimuovere la sostituzione, annulla l'impostazione della variabile di ambiente aggiungendo un trattino (-):

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto di destinazione Google Cloud .
  • VERSION: la versione di Mainframe Assessment Tool di cui è stato eseguito il deployment nel cluster (ad esempio, mainframe-assessment-3-5-0).

Mainframe Assessment Tool torna quindi all'ID progetto salvato, se ne hai uno, o al progetto in cui è stato eseguito il deployment dell'istanza. L'aggiornamento della variabile di ambiente riavvia il pod con la sostituzione del progetto applicata. Poiché Mainframe Assessment Tool viene eseguito come un singolo pod, non è disponibile per un breve periodo di tempo durante l'avvio del nuovo pod.

Configurare le funzionalità di AI predefinite per le nuove valutazioni

Mainframe Assessment Tool ti consente di personalizzare i parametri predefiniti per gli insight di AI nelle valutazioni. Per impostazione predefinita, gli insight di AI sono abilitati.

Per configurare le funzionalità di AI nelle nuove valutazioni:

  1. Fai clic sull' icona delle impostazioniImpostazioni.

  2. Per generare riepiloghi a livello di paragrafo per il codice COBOL, seleziona Riepiloghi dettagliati.

    Per impostazione predefinita, questa opzione è selezionata quando l'analisi AI è abilitata.

  3. Per generare scenari di test per le specifiche di valutazione generate da Gemini, seleziona Scenari di test.

    Per impostazione predefinita, questa opzione non è selezionata quando l'analisi AI è abilitata.

  4. In Indicazioni di generazione aggiuntive, inserisci il testo da aggiungere ai prompt di Gemini durante la generazione di AI.

  5. Fai clic su Salva impostazioni.

Verificare lo stato di integrità del sistema

Mainframe Assessment Tool verifica se il tuo progetto può eseguire valutazioni. Il controllo conferma che il account di servizio dispone dei ruoli IAM richiesti e che ogni modello Gemini risponde a ogni endpoint che una valutazione può utilizzare. Mainframe Assessment Tool esegue il controllo all'avvio. Il controllo non blocca le valutazioni.

Per esaminare i risultati del controllo:

  1. Fai clic sull' icona delle impostazioniImpostazioni.

  2. Nella sezione Stato di integrità del sistema, esamina quanto segue:

    • Identità controllata: il account di servizio con cui è stato eseguito il controllo.

    • Autorizzazioni IAM: se il account di servizio dispone di ogni ruolo richiesto ruolo.

    • Modelli: gli endpoint a cui risponde ogni modello. Per un modello che non risponde, Mainframe Assessment Tool indica l'endpoint, la causa e l'azione da intraprendere.

  3. (Facoltativo) Per eseguire di nuovo il controllo, ad esempio dopo aver concesso un ruolo o modificato la configurazione di rete, fai clic su Ricontrolla.

Se il controllo rileva un problema, Mainframe Assessment Tool mostra una notifica su ogni pagina finché non lo risolvi o lo ignori.

Se l'API Cloud Resource Manager non è abilitata nel tuo progetto, Mainframe Assessment Tool non può verificare le autorizzazioni IAM e lo segnala nella sezione Stato di integrità del sistema. Per abilitare l'API, vedi Abilitare le API.

(Facoltativo) Eseguire azioni

Questa sezione descrive come eseguire azioni, ad esempio svuotare la cache di Gemini e scaricare i log.

Per eseguire azioni:

  1. Fai clic sull' icona delle impostazioniImpostazioni.

  2. Per svuotare la cache di Gemini, fai clic su Svuota cache del modello.

  3. Per scaricare i log di Mainframe Assessment Tool, fai clic su Scarica bundle di assistenza.

    Il bundle di assistenza contiene i log di Mainframe Assessment Tool come file zip, che puoi condividere con Google Cloud l'assistenza per risolvere i problemi.

Disabilitare gli insight di AI per le valutazioni

Puoi disabilitare l'analisi AI per impedire la visualizzazione degli insight di AI nella pagina Valutazioni.

Per disabilitare l'analisi AI per le valutazioni:

  1. Nella sezione Funzionalità di AI predefinite nelle nuove valutazioni, deseleziona Abilita insight di AI.

  2. Fai clic su Salva impostazioni.

Monitorare i costi di Agent Platform utilizzando le etichette dei metadati personalizzati

Mainframe Assessment Tool aggiunge automaticamente etichette di metadati personalizzati a tutte le richieste di Agent Platform per aiutarti a monitorare e analizzare i costi. Nel report sulla fatturazione, puoi utilizzare queste etichette per filtrare i costi e comprendere e ottimizzare meglio l'utilizzo di Agent Platform. I costi vengono aggiornati nel report sulla fatturazione entro 24 ore dall'utilizzo, ma in alcuni casi potrebbero essere necessari più tempo.

Filtra i costi nel report sulla fatturazione con le seguenti etichette:

  • mat-version: versione di Mainframe Assessment Tool.
  • mat-host: ambiente host dell'istanza di Mainframe Assessment Tool. Ad esempio, VM di Compute Engine o Google Kubernetes Engine.
  • mat-action-type: tipo di azione eseguita da Mainframe Assessment Tool.
  • mat-schema: tipo di risorsa elaborata. Ad esempio, COBOL o JCL.
  • mat-target: target di deployment dell'istanza di Mainframe Assessment Tool.
  • mat-run-id: ID univoco della valutazione.

Per monitorare l'utilizzo utilizzando uno o più di questi filtri nel report sulla fatturazione, vedi Utilizzare i filtri per perfezionare i dati.

Per ulteriori informazioni sulle etichette in Agent Platform, vedi Etichette dei metadati personalizzati.

Passaggi successivi