Definir as configurações

Esta página descreve como configurar as definições gerais da Mainframe Assessment Tool e modificar os recursos de IA padrão para novas avaliações.

As configurações modificadas não se aplicam às avaliações atuais. Para usar as configurações modificadas, crie uma nova avaliação.

Configurar as definições gerais

Para configurar as definições gerais da avaliação, siga estas etapas:

  1. Clique no ícone de configuraçõesSettings.

  2. Para editar suas preferências do Cloud Logging e do Google Analytics, na seção General settings, faça o seguinte:

    • Para desativar o Logging, clique no botão Enable Cloud Logging para a posição "desativado". Por padrão, essa configuração está ativada.

      Para mais informações, consulte a documentação do Cloud Logging.

    • Para desativar o Google Analytics, clique no botão Enable Google Analytics para a posição "desativado". Por padrão, o Google Analytics está ativado. As mudanças nessa configuração só entram em vigor depois que você recarregar a página.

  3. Consulte o campo projeto na nuvem do Google Cloud para conferir o Google Cloud ID do projeto usado pela Mainframe Assessment Tool. Não é possível editar esse campo na UI. Para usar um projeto diferente, consulte Substituir o Google Cloud projeto.

  4. Em Serving tier, selecione um nível de serviço da Gemini Enterprise Agent Platform O padrão é "Standard".

    A configuração do nível de serviço determina o modelo de inferência e o modelo de consumo aplicado às chamadas do modelo do Gemini durante as avaliações de mainframe. Para mais informações sobre os níveis de serviço da Gemini Enterprise Agent Platform, consulte PayGo.

  5. Clique em Save settings.

Substituir o Google Cloud projeto

Por padrão, a Mainframe Assessment Tool usa o Google Cloud projeto em que a instância está implantada. Para substituir o projeto usado nas avaliações, siga as instruções do ambiente de implantação.

Antes de começar

Para se preparar para substituir o Google Cloud projeto, conclua as seguintes tarefas:

  • Conceder as permissões necessárias. As permissões necessárias dependem de como você implantou a Mainframe Assessment Tool:
    • Em uma instância de VM do Compute Engine, você precisa de permissão para definir metadados personalizados na instância. Para mais detalhes sobre os papéis necessários, consulte Definir e remover metadados personalizados.
    • Em um cluster do GKE, você precisa de permissão para atualizar implantações no cluster e configurar a ferramenta de linha de comando kubectl para se conectar ao cluster. Para mais informações, consulte Configurar o acesso ao cluster para o kubectl.
  • Fornecer acesso ao projeto de destino. Conceda à conta de serviço usada pela Mainframe Assessment Tool os papéis necessários no projeto de destino.

Substituir o projeto em uma instância de VM do Compute Engine

Para substituir o Google Cloud projeto em uma instância de VM do Compute Engine, adicione a chave de metadados MAT_GCP_PROJECT_OVERRIDE e defina o valor dela como o ID do projeto de destino executando o seguinte comando gcloud:

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

Para remover a substituição, remova a chave de metadados executando o seguinte comando gcloud:

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

Substitua:

  • INSTANCE_NAME: o nome da instância de VM.
  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • ZONE: a zona em que a instância de VM está localizada.

A Mainframe Assessment Tool vai retornar ao ID do projeto salvo, se houver, ou ao projeto em que a instância está implantada. Se você definir ou remover a chave de metadados em uma VM em execução, será necessário reiniciar a VM para que as mudanças entrem em vigor.

Substituir o projeto em um cluster do GKE

Para substituir o Google Cloud projeto em uma implantação do GKE, defina a variável de ambiente MAT_GCP_PROJECT_OVERRIDE no backend contêiner:

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

Para remover a substituição, desfaça a definição da variável de ambiente anexando um hífen (-):

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

Substitua:

  • PROJECT_ID: o ID do projeto Google Cloud de destino.
  • VERSION: a versão da Mainframe Assessment Tool implantada no cluster (por exemplo, mainframe-assessment-3-5-0).

A Mainframe Assessment Tool vai retornar ao ID do projeto salvo, se houver, ou ao projeto em que a instância está implantada. A atualização da variável de ambiente reinicia o pod com a substituição do projeto aplicada. Como a Mainframe Assessment Tool é executada como um único pod, ela fica brevemente indisponível enquanto o novo pod é iniciado.

Configurar recursos de IA padrão para novas avaliações

A Mainframe Assessment Tool permite personalizar os parâmetros padrão dos insights de IA nas avaliações. Por padrão, os insights de IA estão ativados.

Para configurar os recursos de IA em novas avaliações, siga estas etapas:

  1. Clique no ícone de configuraçõesSettings.

  2. Para gerar resumos de parágrafos para o código COBOL, selecione Detailed summaries.

    Por padrão, essa opção é selecionada quando a análise de IA está ativada.

  3. Para gerar casos de teste para as especificações de avaliação geradas pelo Gemini, selecione Test cases.

    Por padrão, essa opção não é selecionada quando a análise de IA está ativada.

  4. Em Additional generation guidance, insira o texto a ser adicionado aos comandos do Gemini durante a geração de IA.

  5. Clique em Save settings.

Verificar a integridade do sistema

A Mainframe Assessment Tool verifica se o projeto pode executar avaliações. A verificação confirma se a conta de serviço tem os papéis do IAM necessários e se cada modelo do Gemini responde em cada endpoint que uma avaliação pode usar. A Mainframe Assessment Tool executa a verificação na inicialização. A verificação não bloqueia as avaliações.

Para revisar os resultados da verificação, siga estas etapas:

  1. Clique no ícone de configuraçõesSettings.

  2. Na seção System health, revise o seguinte:

    • Identidade verificada: a conta de serviço em que a verificação foi executada.

    • Permissões IAM: se essa conta de serviço tem cada papel necessário.

    • Modelos: os endpoints em que cada modelo responde. Para um modelo que não responde, a Mainframe Assessment Tool nomeia o endpoint, a causa e a ação a ser tomada.

  3. Opcional: para executar a verificação novamente, por exemplo, depois de conceder um papel ou mudar a configuração de rede, clique em Re-check.

Se a verificação encontrar um problema, a Mainframe Assessment Tool vai mostrar uma notificação em todas as páginas até que você corrija ou descarte o problema.

Se a API Cloud Resource Manager não estiver ativada no seu projeto, a Mainframe Assessment Tool não poderá verificar as permissões do IAM e vai informar isso na seção System health. Para ativar a API, consulte Ativar APIs.

Opcional: realizar ações

Esta seção descreve como realizar ações, como limpar o cache do Gemini e fazer o download dos registros.

Para realizar ações, siga estas etapas:

  1. Clique no ícone de configuraçõesSettings.

  2. Para limpar o cache do Gemini, clique em Clear model cache.

  3. Para fazer o download dos registros da Mainframe Assessment Tool, clique em Download support bundle.

    O pacote de suporte contém os registros da Mainframe Assessment Tool como um arquivo ZIP, que você pode compartilhar com Google Cloud o suporte para resolver problemas.

Desativar insights de IA para avaliações

É possível desativar a análise de IA para impedir que os insights de IA apareçam na página Assessments.

Para desativar a análise de IA para avaliações, siga estas etapas:

  1. Na seção Default AI features in new assessments, desmarque Enable AI insights.

  2. Clique em Save settings.

Acompanhar os custos da Agent Platform usando rótulos de metadados personalizados

A Mainframe Assessment Tool adiciona automaticamente rótulos de metadados personalizados a todas as solicitações da Agent Platform para ajudar você a acompanhar e analisar os custos. No relatório de faturamento, é possível usar esses rótulos para filtrar os custos e entender e otimizar melhor o uso da Agent Platform. Os custos são atualizados no relatório de faturamento em até 24 horas após o uso, mas em alguns casos podem levar mais tempo.

Filtre os custos no relatório de faturamento com os seguintes rótulos:

  • mat-version: versão da Mainframe Assessment Tool.
  • mat-host: ambiente de host da instância da Mainframe Assessment Tool. Por exemplo, VM do Compute Engine ou Google Kubernetes Engine.
  • mat-action-type: tipo de ação realizada pela Mainframe Assessment Tool.
  • mat-schema: tipo de recurso processado. Por exemplo, COBOL ou JCL.
  • mat-target: destino de implantação da instância da Mainframe Assessment Tool.
  • mat-run-id: ID exclusivo da avaliação.

Para acompanhar o uso usando um ou mais desses filtros no relatório de faturamento, consulte Usar filtros para refinar dados.

Para mais informações sobre rótulos na Agent Platform, consulte Rótulos de metadados personalizados.

A seguir