Configurer les paramètres

Cette page explique comment configurer les paramètres généraux de Mainframe Assessment Tool et modifier les fonctionnalités d'IA par défaut pour les nouvelles évaluations.

Les paramètres modifiés ne s'appliquent pas aux évaluations existantes. Pour utiliser les paramètres modifiés, créez une évaluation.

Configurer les paramètres généraux

Pour configurer les paramètres généraux de votre évaluation, procédez comme suit :

  1. Cliquez sur l'icône Paramètressettings.

  2. Pour modifier vos préférences pour Cloud Logging et Google Analytics, dans la section Paramètres généraux, procédez comme suit :

    • Pour désactiver Logging, cliquez sur le bouton Activer Cloud Logging pour le désactiver. Par défaut, ce paramètre est activé.

      Pour en savoir plus, consultez la documentation Cloud Logging.

    • Pour désactiver Google Analytics, cliquez sur le bouton Activer Google Analytics pour le désactiver. Par défaut, Google Analytics est activé. Les modifications apportées à ce paramètre ne prennent effet qu'après le rechargement de la page.

  3. Consultez le champ Projet Google Cloud pour afficher l' Google Cloud ID de projet utilisé par Mainframe Assessment Tool. Vous ne pouvez pas modifier ce champ dans l'interface utilisateur. Pour utiliser un autre projet, consultez Remplacer le Google Cloud projet.

  4. Pour Niveau de diffusion, sélectionnez un Gemini Enterprise Agent Platform niveau de diffusion. La valeur par défaut est "Standard".

    Le paramètre de niveau de diffusion détermine le modèle d'inférence et de consommation appliqué aux appels de modèle Gemini lors des évaluations de mainframe. Pour en savoir plus sur les niveaux de diffusion de Gemini Enterprise Agent Platform, consultez PayGo.

  5. Cliquez sur Enregistrer les paramètres.

Remplacer le Google Cloud projet

Par défaut, Mainframe Assessment Tool utilise le Google Cloud projet dans lequel votre instance est déployée. Pour remplacer le projet utilisé pour vos évaluations, suivez les instructions correspondant à votre environnement de déploiement.

Avant de commencer

Pour préparer le remplacement du Google Cloud projet, effectuez les tâches suivantes :

  • Accorder les autorisations nécessaires. Les autorisations dont vous avez besoin dépendent de la façon dont vous avez déployé Mainframe Assessment Tool :
    • Sur une instance de VM Compute Engine, vous devez disposer de l'autorisation de définir des métadonnées personnalisées sur l'instance. Pour en savoir plus sur les rôles requis, consultez Définir et supprimer des métadonnées personnalisées.
    • Sur un cluster GKE, vous devez disposer de l'autorisation de mettre à jour les déploiements dans le cluster et configurer l'outil de ligne de commande kubectl pour vous connecter au cluster. Pour en savoir plus, consultez Configurer l'accès au cluster pour kubectl.
  • Fournir l'accès au projet cible. Accordez au compte de service utilisé par Mainframe Assessment Tool les rôles requis dans le projet cible.

Remplacer le projet sur une instance de VM Compute Engine

Pour remplacer le Google Cloud projet sur une instance de VM Compute Engine, ajoutez la clé de métadonnées MAT_GCP_PROJECT_OVERRIDE et définissez sa valeur sur l'ID de votre projet cible en exécutant la commande gcloud suivante :

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

Pour supprimer le remplacement, supprimez la clé de métadonnées en exécutant la commande gcloud suivante :

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de votre instance de VM.
  • PROJECT_ID: ID du projet cible Google Cloud .
  • ZONE : zone où se trouve votre instance de VM.

Mainframe Assessment Tool revient ensuite à l'ID de projet enregistré, le cas échéant, ou au projet dans lequel l'instance est déployée. Si vous définissez ou supprimez la clé de métadonnées sur une VM en cours d'exécution, vous devez redémarrer la VM pour que les modifications prennent effet.

Remplacer le projet sur un cluster GKE

Pour remplacer le Google Cloud projet sur un déploiement GKE, définissez la variable d'environnement MAT_GCP_PROJECT_OVERRIDE sur le backend conteneur :

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

Pour supprimer le remplacement, supprimez la variable d'environnement en ajoutant un trait d'union (-) :

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

Remplacez les éléments suivants :

  • PROJECT_ID: ID du projet cible Google Cloud .
  • VERSION: version de Mainframe Assessment Tool déployée sur le cluster (par exemple, mainframe-assessment-3-5-0).

Mainframe Assessment Tool revient ensuite à l'ID de projet enregistré, le cas échéant, ou au projet dans lequel l'instance est déployée. La mise à jour de la variable d'environnement redémarre le pod avec le remplacement de projet appliqué. Étant donné que Mainframe Assessment Tool s'exécute en tant que pod unique, il est brièvement indisponible pendant le démarrage du nouveau pod.

Configurer les fonctionnalités d'IA par défaut pour les nouvelles évaluations

Mainframe Assessment Tool vous permet de personnaliser les paramètres par défaut des insights d'IA dans vos évaluations. Par défaut, les insights d'IA sont activés.

Pour configurer les fonctionnalités d'IA dans les nouvelles évaluations, procédez comme suit :

  1. Cliquez sur l' icône Paramètressettings.

  2. Pour générer des résumés au niveau du paragraphe pour le code COBOL, sélectionnez Résumés détaillés.

    Par défaut, cette option est sélectionnée lorsque l'analyse de l'IA est activée.

  3. Pour générer des scénarios de test pour les spécifications d'évaluation générées par Gemini, sélectionnez Scénarios de test.

    Par défaut, cette option n'est pas sélectionnée lorsque l'analyse de l'IA est activée.

  4. Pour Conseils de génération supplémentaires, saisissez du texte à ajouter aux requêtes Gemini lors de la génération par IA.

  5. Cliquez sur Enregistrer les paramètres.

Vérifier l'état du système

Mainframe Assessment Tool vérifie si votre projet peut exécuter des évaluations. La vérification confirme que le compte de service contient les rôles IAM requis et que chaque modèle Gemini répond à chaque point de terminaison qu'une évaluation peut utiliser. Mainframe Assessment Tool exécute la vérification au démarrage. La vérification ne bloque pas les évaluations.

Pour examiner les résultats de la vérification, procédez comme suit :

  1. Cliquez sur l' icône Paramètressettings.

  2. Dans la section État du système, examinez les éléments suivants :

    • Identité vérifiée : compte de service sous lequel la vérification a été exécutée.

    • Autorisations IAM : indique si ce compte de service contient chaque rôle requis.

    • Modèles : points de terminaison auxquels chaque modèle répond. Pour un modèle qui ne répond pas, Mainframe Assessment Tool indique le point de terminaison, la cause et l'action à entreprendre.

  3. Facultatif : Pour exécuter à nouveau la vérification, par exemple après avoir accordé un rôle ou modifié la configuration de votre réseau, cliquez sur Vérifier à nouveau.

Si la vérification détecte un problème, Mainframe Assessment Tool affiche une notification sur chaque page jusqu'à ce que vous résolviez ou ignoriez le problème.

Si l'API Cloud Resource Manager n'est pas activée dans votre projet, Mainframe Assessment Tool ne peut pas vérifier les autorisations IAM et le signale dans la section État du système. Pour activer l'API, consultez Activer des API.

Facultatif : Effectuer des actions

Cette section explique comment effectuer des actions, telles que vider le cache Gemini et télécharger vos journaux.

Pour effectuer des actions, procédez comme suit :

  1. Cliquez sur l' icône Paramètressettings.

  2. Pour vider le cache Gemini, cliquez sur Vider le cache du modèle.

  3. Pour télécharger vos journaux Mainframe Assessment Tool, cliquez sur Télécharger le bundle d'assistance.

    Le bundle d'assistance contient les journaux Mainframe Assessment Tool sous forme de fichier zip, que vous pouvez partager avec Google Cloud l'assistance pour résoudre les problèmes.

Désactiver les insights d'IA pour les évaluations

Vous pouvez désactiver l'analyse de l'IA pour empêcher les insights d'IA de s'afficher sur la page Évaluations.

Pour désactiver l'analyse de l'IA pour les évaluations, procédez comme suit :

  1. Dans la section Fonctionnalités d'IA par défaut dans les nouvelles évaluations, décochez Activer les insights d'IA.

  2. Cliquez sur Enregistrer les paramètres.

Suivre les coûts d'Agent Platform à l'aide de libellés de métadonnées personnalisés

Mainframe Assessment Tool ajoute automatiquement des libellés de métadonnées personnalisés à toutes les requêtes Agent Platform pour vous aider à suivre et à analyser les coûts. Dans votre rapport de facturation, vous pouvez utiliser ces libellés pour filtrer les coûts afin de mieux comprendre et optimiser votre utilisation d'Agent Platform. Les coûts sont mis à jour dans le rapport de facturation dans les 24 heures suivant l'utilisation, mais cela peut parfois prendre plus de temps.

Filtrez les coûts dans votre rapport sur la facturation avec les libellés suivants :

  • mat-version : version de Mainframe Assessment Tool.
  • mat-host : environnement hôte de l'instance Mainframe Assessment Tool. Par exemple, VM Compute Engine ou Google Kubernetes Engine.
  • mat-action-type : type d'action effectuée par Mainframe Assessment Tool.
  • mat-schema : type d'asset traité. Par exemple, COBOL ou JCL.
  • mat-target : cible de déploiement de l'instance Mainframe Assessment Tool.
  • mat-run-id : ID unique de l'évaluation.

Pour suivre l'utilisation à l'aide d'un ou de plusieurs de ces filtres dans le rapport de facturation, consultez Utiliser des filtres pour affiner les données.

Pour en savoir plus sur les libellés dans Agent Platform, consultez Libellés de métadonnées personnalisés.

Étape suivante