Criar e atualizar avaliações

Esta página descreve como fazer upload de aplicativos para a Mainframe Assessment Tool e realizar uma avaliação dos recursos que a ferramenta descobre na base de código enviada.

Você pode realizar uma descoberta de recursos por conta própria ou solicitar assistência de um engenheiro de clientes do Google.

Antes de começar

Para se preparar para a avaliação, conclua os seguintes pré-requisitos:

Fazer upload dos arquivos de aplicativos de mainframe para a Mainframe Assessment Tool

Para fazer upload dos arquivos de aplicativos para a Mainframe Assessment Tool, siga estas etapas:

  1. Crie um arquivo ZIP com todos os aplicativos que você quer migrar.

    A Mainframe Assessment Tool aceita apenas arquivos ZIP com um tamanho máximo de 400 MB. Se o arquivo ZIP do aplicativo for maior que 400 MB, divida-o em arquivos ZIP menores com base nos domínios de negócios e faça upload de um arquivo ZIP para cada domínio.

    Se os aplicativos contiverem referências a artefatos externos, como programas ou tabelas, recomendamos que você inclua essas dependências também. Se disponível, forneça o código-fonte dos seguintes tipos:

    • Programas COBOL (cob e cbl)
    • Copybooks COBOL (inc e cpy)
    • Programas Easytrieve (ezt)
    • Programas HLASM (asm)
    • Jobs JCL (jcl)
    • Procedimentos JCL (proc)
    • Inclui JCL
    • Dados de cartão JCL (ctl)
    • Programas PL/I (pli e pl1)
    • Programas RPG/RPGLE (rpg e rpgle)
    • Arquivos de inclusão RPG/RPGLE (rpginc e rpgleinc)
    • Configurações do programador para BMC Control-M

    Não inclua binários e outros arquivos não de origem no arquivo ZIP.

  2. Para fazer upload do arquivo ZIP para a Mainframe Assessment Tool, siga estas etapas:

    1. Para abrir a Mainframe Assessment Tool na máquina local, abra uma janela do navegador da Web e acesse http://localhost:PORT.

      Substitua PORT pelo número da porta usada na máquina local para a conexão em túnel com a Mainframe Assessment Tool.

    2. Na página Inicial, clique em Criar avaliação.

    3. Em "Nome", insira um nome.

    4. Opcional: em "Descrição", insira uma descrição para a avaliação.

    5. Para fazer upload de um arquivo ZIP, clique em Selecionar arquivo. O navegador de arquivos será aberto. Selecione um arquivo ZIP que você quer enviar por upload. Só é possível fazer upload de um arquivo por vez.

    6. Clique em Próxima.

  3. Para configurar insights gerados por IA, siga estas etapas:

    1. Para gerar resumos de parágrafos para o código COBOL, selecione Resumos detalhados. Essa opção fica selecionada por padrão.

    2. Para gerar casos de teste para as especificações de avaliação geradas pelo Gemini, selecione Casos de teste. Essa opção não fica selecionada por padrão.

    3. Em Orientação de geração adicional, insira o texto a ser adicionado aos comandos do Gemini durante a geração de IA.

    4. Clique em Próxima.

  4. Para configurar os modelos e o nível de qualidade do Gemini para a avaliação, configure a etapa Modelo e qualidade e clique em Próxima.

    Por padrão, a Mainframe Assessment Tool usa o nível de qualidade Equilibrado recomendado. Para mais informações sobre níveis de qualidade, como escolher um modelo específico e manter os dados na sua região, consulte Escolher modelos e qualidade.

  5. Opcional: para adicionar um ou mais domínios que representam uma área de funcionalidade distinta, clique em Adicionar domínio.

    Os domínios permitem filtrar e revisar os resultados com base em contextos específicos após a conclusão da avaliação.

  6. Clique em Próxima.

  7. Clique em Criar avaliação.

Depois de fazer upload do arquivo ZIP, a Mainframe Assessment Tool descompacta e processa o código-fonte. A página Avaliações mostra uma nova entrada na tabela para cada recurso descoberto, mostrando o status da avaliação.

  • Pendente:a avaliação está aguardando a vez.
  • Em andamento:a análise está em andamento.
  • Analisado:a avaliação foi concluída.
  • Falha:a avaliação não foi concluída.

Se você encontrar erros após importar o arquivo, revise a mensagem de erro diretamente na Mainframe Assessment Tool.

Para conferir mais detalhes sobre o progresso da avaliação de um item, clique no ID de referência ao lado dele na tabela. Isso abre uma página que mostra todas as etapas com o status.

Escolher modelos e qualidade

Configure os modelos do Gemini para uma avaliação durante a criação ou a edição de uma avaliação. Essas configurações se aplicam apenas a essa avaliação.

Por padrão, a Mainframe Assessment Tool otimiza os modelos para cada etapa de avaliação com base no nível de qualidade selecionado. A ferramenta encaminha etapas de raciocínio complexas para modelos mais pesados e etapas mais simples para modelos mais leves.

Selecionar um nível de qualidade

Em Otimizar para, selecione um dos seguintes níveis de qualidade:

  • Equilibrado (recomendado): equilibra a velocidade e a profundidade da maioria das avaliações. Esse é o nível padrão.
  • Rápido: retorna os resultados mais rápidos usando modelos mais leves.
  • Estendido: maximiza a profundidade da análise usando modelos mais pesados.

Cada nível de qualidade lista os modelos do Gemini usados para cada etapa.

Especificar um único modelo

Para executar todas as etapas de avaliação em um único modelo em vez de otimizar por nível, selecione Usar um modelo específico e escolha um modelo na lista. Cada modelo é rotulado como Disponibilidade geral ou Pré-lançamento.

A Mainframe Assessment Tool oferece suporte a todas as zonas nas regiões disponíveis da Agent Platform.

Aplicar residência de dados

Por padrão, a Mainframe Assessment Tool encaminha chamadas de modelo para o local ideal para os modelos selecionados, incluindo a região de avaliação, uma multirregião ou o endpoint global da Agent Platform.

Para restringir as chamadas de modelo à região de avaliação e à multirregião associada, ative a opção Manter os dados na minha região. Quando essa configuração está ativada, a Mainframe Assessment Tool realiza as seguintes ações:

  • Desativa os níveis de qualidade que exigem um modelo do Gemini que não está disponível na região de avaliação. Esses níveis são rotulados como Não disponível nesta região.
  • Oculta modelos da lista de modelos específicos que não estão disponíveis na região de avaliação.

Se nenhum modelo compatível estiver disponível na região de avaliação, a avaliação não poderá ser executada com a opção Manter os dados na minha região ativada. Para continuar com a avaliação, desative a opção Manter os dados na minha região para permitir chamadas de modelo fora da região.

Se a instância da Mainframe Assessment Tool não tiver um endereço IP externo e você ativar a opção Manter os dados na minha região, os modelos veiculados apenas em um endpoint multirregional poderão ficar indisponíveis. Isso acontece porque o Acesso privado do Google não pode alcançar endpoints multirregionais. Para disponibilizar esses modelos e obedecer aos requisitos de residência de dados, configure a conectividade privada para o endpoint multirregional. Para instruções, consulte Configurar a conectividade privada para residência de dados.

Adicionar arquivos a uma avaliação atual

Depois de criar uma avaliação, você pode adicionar outros arquivos ZIP a ela. Os arquivos do novo arquivo ZIP são mesclados com os arquivos atuais na avaliação. Se você quiser substituir arquivos atuais, o novo arquivo ZIP precisará incluir os arquivos que você está substituindo com a mesma estrutura de caminho.

Para adicionar arquivos a uma avaliação atual, siga estas etapas:

  1. Abra a Mainframe Assessment Tool em um navegador da Web.
  2. No menu de navegação, clique em Avaliações.
  3. Na página Avaliações, encontre a avaliação que você quer modificar, e clique em Abrir avaliação.
  4. Clique em Adicionar um arquivo.
  5. Clique em Selecionar arquivo e selecione um arquivo ZIP que você quer enviar por upload. Só é possível fazer upload de um arquivo por vez.
  6. Clique em Adicionar.

Depois de fazer upload dos arquivos, a Mainframe Assessment Tool inicia a análise novamente. Se você substituir arquivos, eles serão totalmente reavaliados, e qualquer análise atual desses arquivos poderá mudar. Durante o reprocessamento, um indicador desatualizado aparece ao lado dos arquivos que estão sendo reprocessados.

Atualizar detalhes e configurações da avaliação

Depois de criar uma avaliação, você pode atualizar o nome e a descrição dela e modificar as configurações de insights gerados por IA.

Para atualizar os detalhes ou as configurações da avaliação, siga estas etapas:

  1. Abra a Mainframe Assessment Tool em um navegador da Web.
  2. No menu de navegação, clique em Avaliações.
  3. Na página Avaliações, encontre a avaliação que você quer modificar, e clique em Abrir avaliação.
  4. Clique em settingsEditar configurações de avaliação.
  5. Opcional: na etapa Detalhes da avaliação, edite o nome e a descrição e clique em Próxima.
  6. Opcional: na etapa Configurações de IA , modifique as configurações de IA conforme necessário e clique em Próxima.
  7. Opcional: na etapa Modelo e qualidade , configure os modelos ou o nível de qualidade e clique em Próxima. Para mais informações, consulte Escolher modelos e qualidade.
  8. Na etapa Domínios, clique em Próxima. Não é possível editar domínios depois de criar uma avaliação.
  9. Clique em Atualizar avaliação.

Depois de atualizar as configurações, a Mainframe Assessment Tool inicia a análise novamente.

A seguir