Criar e atualizar avaliações

Nesta página, descrevemos como fazer upload dos arquivos do aplicativo de mainframe para a Mainframe Assessment Tool e criar uma avaliação.

Você pode realizar uma avaliação por conta própria usando fluxos de trabalho de autoatendimento ou pedir ajuda ao Google. Se a avaliação envolver estruturas de base de código complexas (como pré-processadores personalizados ou formatos proprietários), mapeamento de domínio em grande escala, requisitos de implantação personalizados ou estratégia de modernização de ponta a ponta, considere solicitar assistência do Google.

Para receber ajuda, entre em contato com sua equipe de conta ou engenheiro de clientes do Google Cloud ou envie um e-mail para a equipe do Google Mainframe em mainframe@google.com.

Antes de começar

Para se preparar para a avaliação, verifique se você concluiu os seguintes pré-requisitos:

  1. Configure seu projeto do Google Cloud para a Mainframe Assessment Tool.
  2. Configurar e acessar a Mainframe Assessment Tool.
  3. Crie um arquivo ZIP com todos os aplicativos que você quer migrar:
    • A Mainframe Assessment Tool só aceita arquivos ZIP com 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 em domínios de negócios e faça upload de um arquivo ZIP para cada domínio.
    • Se os aplicativos tiverem referências a artefatos externos, como programas ou tabelas, recomendamos que você também inclua essas dependências. Para ver a lista de linguagens, bancos de dados, monitores de transações e configurações de agendador compatíveis, consulte Linguagens compatíveis.
    • Não inclua binários e outros arquivos que não sejam de origem no arquivo ZIP.

Criar uma avaliação

Para fazer upload do arquivo ZIP e criar uma avaliação na Mainframe Assessment Tool, siga estas etapas:

Detalhes da avaliação

  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 que você usou na máquina local para a conexão em túnel com o Mainframe Assessment Tool.

  2. Na página Início, clique em Criar avaliação.

  3. Em Nome, insira um nome para a avaliação.

  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 para fazer upload. Você só pode fazer upload de um arquivo por vez.

  6. Clique em Próxima.

Insights de IA

  1. Opcional: para ativar os insights de IA na avaliação, selecione Ativar insights de IA.
  2. Para gerar resumos de parágrafos para o código COBOL, selecione Resumos detalhados. Essa opção fica selecionada por padrão.
  3. Para gerar casos de teste para as especificações de avaliação geradas pelo Gemini, selecione Casos de teste. Por padrão, essa opção não é selecionada.
  4. Para extrair informações sobre bancos de dados e arquivos acessados pelo aplicativo, selecione Fontes de dados.

  5. Opcional: em Orientações adicionais de geração, insira orientações em texto livre para adicionar aos comandos do Gemini durante a geração de IA.

  6. Clique em Próxima.

Modelo e qualidade

Configure os modelos do Gemini para a avaliação. Essas configurações se aplicam apenas a esta avaliação.

  1. Selecione como a Mainframe Assessment Tool encaminha as etapas de avaliação para os modelos do Gemini:

    • Rápido: retorna os resultados mais rápidos usando modelos mais leves.
    • Equilibrado (recomendado): equilibra velocidade e profundidade para a maioria das avaliações, encaminhando etapas de raciocínio complexas para modelos mais pesados e etapas mais simples para modelos mais leves. Essa é a opção padrão.
    • Estendida: maximiza a profundidade da análise usando modelos mais pesados.

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

    Cada nível de qualidade lista os modelos do Gemini usados para cada etapa. A Mainframe Assessment Tool é compatível com todas as zonas nas regiões da Plataforma de Agentes disponíveis.

  2. Opcional: para restringir as chamadas de modelo à região de avaliação e à multirregião associada, ative Manter dados na minha região.

    Por padrão, o Mainframe Assessment Tool encaminha as 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 do Agent Platform. 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 os 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 dados na minha região ativada. Para continuar com a avaliação, desative a opção Manter dados na minha região para permitir chamadas de modelo fora da região.

    Se a instância da ferramenta de avaliação de mainframe não tiver um endereço IP externo e você ativar a opção Manter dados na minha região, os modelos disponibilizados apenas em um endpoint multirregional poderão ficar indisponíveis. Isso acontece porque o Acesso privado do Google não consegue acessar endpoints multirregionais. Para disponibilizar esses modelos e aderir aos requisitos de residência de dados, configure a conectividade privada com o endpoint multirregional. Para instruções, consulte Configurar a conectividade privada para residência de dados.

  3. Clique em Próxima.

Opcional: domínios

  1. 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 analisar os resultados com base em contextos específicos após a conclusão da avaliação.

  2. Clique em Próxima.

Criar avaliação

  1. Clique em Criar avaliação.

Depois que você faz upload do arquivo ZIP, a Mainframe Assessment Tool descompacta e processa o código-fonte. A página Avaliações exibe 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 depois de importar o arquivo, consulte a mensagem de erro diretamente no Mainframe Assessment Tool.

Para ver 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.

Adicionar arquivos a uma avaliação

Depois de criar uma avaliação, é possível 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, 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, 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 escolha um arquivo ZIP para fazer upload. Você só pode fazer upload de um arquivo por vez.
  6. Clique em Adicionar.

Depois que você fizer o upload dos arquivos, a Mainframe Assessment Tool vai iniciar a análise novamente. Se você substituir arquivos, eles serão totalmente reavaliados, e qualquer análise existente para esses 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, é possível atualizar o nome e a descrição dela, além de modificar as configurações de insights gerados com 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 Configurações Editar 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 Insights 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.
  8. Na etapa Domínios (opcional), clique em Próxima. Não é possível editar domínios depois de criar uma avaliação.
  9. Clique em Atualizar avaliação.

Depois que você atualizar as configurações, a Mainframe Assessment Tool vai reiniciar a análise.

A seguir