Opciones de configuración

En esta página, se describe cómo configurar los parámetros generales de Mainframe Assessment Tool y modificar las funciones predeterminadas de IA para las evaluaciones nuevas.

Los parámetros modificados no se aplican a las evaluaciones existentes. Para usar los parámetros modificados, crea una evaluación nueva.

Configura los parámetros generales

Para configurar los parámetros generales de tu evaluación, sigue estos pasos:

  1. Haz clic en el ícono de configuraciónConfiguración.

  2. Para editar tus preferencias de Cloud Logging y Google Analytics, en la sección Parámetros generales, haz lo siguiente:

    • Para desactivar Logging, haz clic en el botón de activación Habilitar Cloud Logging y colócalo en la posición de apagado. Este parámetro está habilitado de forma predeterminada.

      Para obtener más información, consulta la documentación de Cloud Logging.

    • Para desactivar Google Analytics, haz clic en el botón de activación Habilitar Google Analytics y colócalo en la posición de apagado. De forma predeterminada, Google Analytics está habilitado. Los cambios en este parámetro solo se aplican después de que vuelves a cargar la página.

  3. Consulta el campo Proyecto de Google Cloud para ver el Google Cloud ID del proyecto que usa Mainframe Assessment Tool. No puedes editar este campo en la IU. Para usar un proyecto diferente, consulta Anula el Google Cloud proyecto.

  4. En Nivel de servicio, selecciona un nivel de servicio de Gemini Enterprise Agent Platform. El valor predeterminado es Estándar.

    El parámetro de nivel de servicio determina el modelo de inferencia y consumo que se aplica a las llamadas al modelo de Gemini durante las evaluaciones de mainframe. Para obtener más información sobre los niveles de servicio de Gemini Enterprise Agent Platform consulta PayGo.

  5. Haz clic en Guardar configuración.

Anula el Google Cloud proyecto

De forma predeterminada, Mainframe Assessment Tool usa el Google Cloud proyecto en el que se implementa tu instancia. Para anular el proyecto que se usa para tus evaluaciones, sigue las instrucciones de tu entorno de implementación.

Antes de comenzar

Para prepararte para anular el Google Cloud proyecto, completa las siguientes tareas:

  • Otorga los permisos necesarios. Los permisos que necesitas dependen de cómo implementaste Mainframe Assessment Tool:
    • En una instancia de VM de Compute Engine, necesitas permiso para configurar metadatos personalizados en la instancia. Para obtener detalles sobre las funciones necesarias, consulta Configura y quita metadatos personalizados.
    • En un clúster de GKE, necesitas permiso para actualizar las implementaciones en el clúster y debes configurar la herramienta de línea de comandos de kubectl para conectarte al clúster. Si deseas obtener más información, consulta Configura el acceso al clúster para kubectl.
  • Proporciona acceso al proyecto de destino. Otorga a la cuenta de servicio que usa Mainframe Assessment Tool las funciones necesarias en el proyecto de destino.

Anula el proyecto en una instancia de VM de Compute Engine

Para anular el Google Cloud proyecto en una instancia de VM de Compute Engine, agrega la clave de metadatos MAT_GCP_PROJECT_OVERRIDE y establece su valor en el ID de tu proyecto de destino ejecutando el siguiente comando gcloud:

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

Para quitar la anulación, quita la clave de metadatos ejecutando el siguiente comando gcloud:

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

Reemplaza lo siguiente:

  • INSTANCE_NAME: el nombre de tu instancia de VM.
  • PROJECT_ID: el ID del proyecto de destino Google Cloud .
  • ZONE: la zona en la que se encuentra la instancia.

Luego, Mainframe Assessment Tool vuelve a tu ID del proyecto guardado, si tienes uno, o al proyecto en el que se implementa la instancia. Si estableces o quitas la clave de metadatos en una VM en ejecución, debes reiniciar la VM para que los cambios surtan efecto.

Anula el proyecto en un clúster de GKE

Para anular el Google Cloud proyecto en una implementación de GKE, establece la variable de entorno MAT_GCP_PROJECT_OVERRIDE en el backend contenedor:

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

Para quitar la anulación, anula la variable de entorno agregando un guion (-):

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

Reemplaza lo siguiente:

  • PROJECT_ID: el ID del proyecto de destino Google Cloud .
  • VERSION: la versión de Mainframe Assessment Tool implementada en el clúster (por ejemplo, mainframe-assessment-3-5-0).

Luego, Mainframe Assessment Tool vuelve a tu ID del proyecto guardado, si tienes uno, o al proyecto en el que se implementa la instancia. La actualización de la variable de entorno reinicia el pod con la anulación del proyecto aplicada. Debido a que Mainframe Assessment Tool se ejecuta como un solo pod, no está disponible brevemente mientras se inicia el pod nuevo.

Configura las funciones predeterminadas de IA para las evaluaciones nuevas

Mainframe Assessment Tool te permite personalizar los parámetros predeterminados de las estadísticas de IA en tus evaluaciones. De forma predeterminada, las estadísticas de IA están habilitadas.

Para configurar las funciones de IA en las evaluaciones nuevas, sigue estos pasos:

  1. Haz clic en el ícono de configuraciónConfiguración.

  2. Para generar resúmenes a nivel de párrafo para el código COBOL, selecciona Resúmenes detallados.

    De forma predeterminada, esta opción está seleccionada cuando se habilita el análisis de IA.

  3. Para generar casos de prueba para las especificaciones de evaluación generadas por Gemini, selecciona Casos de prueba.

    De forma predeterminada, esta opción no está seleccionada cuando se habilita el análisis de IA.

  4. En Orientación adicional para la generación, ingresa el texto que se agregará a las instrucciones de Gemini durante la generación de IA.

  5. Haz clic en Guardar configuración.

Verifica el estado del sistema

Mainframe Assessment Tool verifica si tu proyecto puede ejecutar evaluaciones. La verificación confirma que la cuenta de servicio tiene las funciones de IAM necesarias y que cada modelo de Gemini responde en cada extremo que puede usar una evaluación. Mainframe Assessment Tool ejecuta la verificación al inicio. La verificación no bloquea las evaluaciones.

Para revisar los resultados de la verificación, sigue estos pasos:

  1. Haz clic en el ícono de configuraciónConfiguración.

  2. En la sección Estado del sistema, revisa lo siguiente:

    • Identidad verificada: La cuenta de servicio con la que se ejecutó la verificación.

    • Permisos de IAM: Si esa cuenta de servicio tiene cada función necesaria.

    • Modelos: Los extremos en los que responde cada modelo. En el caso de un modelo que no responde, Mainframe Assessment Tool nombra el extremo, la causa y la acción que se debe realizar.

  3. Opcional: Para volver a ejecutar la verificación, por ejemplo, después de otorgar una función o cambiar la configuración de red, haz clic en Volver a verificar.

Si la verificación encuentra un problema, Mainframe Assessment Tool muestra una notificación en cada página hasta que lo corrijas o lo descartes.

Si la API de Cloud Resource Manager no está habilitada en tu proyecto, Mainframe Assessment Tool no puede verificar los permisos de IAM y lo informa en la sección Estado del sistema. Para habilitar la API, consulta Habilita las APIs.

Opcional: Realiza acciones

En esta sección, se describe cómo realizar acciones, como borrar la caché de Gemini y descargar tus registros.

Para realizar acciones, sigue estos pasos:

  1. Haz clic en el ícono de configuraciónConfiguración.

  2. Para borrar la caché de Gemini, haz clic en Borrar caché del modelo.

  3. Para descargar tus registros de Mainframe Assessment Tool, haz clic en Descargar paquete de asistencia.

    El paquete de asistencia contiene los registros de Mainframe Assessment Tool como un archivo ZIP, que puedes compartir con Google Cloud el equipo de asistencia para solucionar problemas.

Inhabilita las estadísticas de IA para las evaluaciones

Puedes inhabilitar el análisis de IA para evitar que aparezcan estadísticas de IA en la página Evaluaciones.

Para inhabilitar el análisis de IA para las evaluaciones, sigue estos pasos:

  1. En la sección Funciones predeterminadas de IA en las evaluaciones nuevas, desmarca Habilitar estadísticas de IA.

  2. Haz clic en Guardar configuración.

Haz un seguimiento de los costos de Agent Platform con etiquetas de metadatos personalizadas

Mainframe Assessment Tool agrega automáticamente etiquetas de metadatos personalizadas a todas las solicitudes de Agent Platform para ayudarte a hacer un seguimiento y analizar los costos. En tu informe de facturación, puedes usar estas etiquetas para filtrar los costos y comprender y optimizar mejor el uso de Agent Platform. Los costos se actualizan en el informe de facturación en un plazo de 24 horas después del uso, pero, en algunos casos, pueden tardar más.

Filtra los costos en tu informe de facturación con las siguientes etiquetas:

  • mat-version: Versión de Mainframe Assessment Tool.
  • mat-host: Entorno host de la instancia de Mainframe Assessment Tool. Por ejemplo, VM de Compute Engine o Google Kubernetes Engine.
  • mat-action-type: Tipo de acción que realiza Mainframe Assessment Tool.
  • mat-schema: Tipo de recurso procesado. Por ejemplo, COBOL o JCL.
  • mat-target: Destino de implementación de la instancia de Mainframe Assessment Tool.
  • mat-run-id: ID único de la evaluación.

Para hacer un seguimiento del uso con uno o más de estos filtros en el informe de facturación, consulta Usa filtros para definir mejor los datos.

Para obtener más información sobre las etiquetas en Agent Platform, consulta Etiquetas de metadatos personalizadas.

¿Qué sigue?