Criar e atualizar avaliações

Esta página descreve como fazer upload dos arquivos de aplicativos de mainframe para a Mainframe Assessment Tool e criar uma avaliação.

Você pode realizar uma descoberta de ativos 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:

  1. Configure seu Google Cloud projeto para a Mainframe Assessment Tool.
  2. Configure e acesse a Mainframe Assessment Tool.
  3. 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, considere dividir o arquivo em arquivos ZIP menores com base nos domínios de negócios e fazer 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. Para conferir a lista de idiomas, bancos de dados, monitores de transação e configurações de agendador com suporte, consulte Idiomas compatíveis.
    • Não inclua binários e outros arquivos não 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 sua máquina local, abra uma janela do navegador da Web e acesse http://localhost:PORT.

    Substitua PORT pelo número da porta usada na sua 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 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 que você quer enviar por upload. Só é possível fazer upload de um arquivo por vez.

  6. Clique em Próxima.

Insights de IA

  1. Opcional: para ativar os insights de IA para a 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. Essa opção não fica selecionada por padrão.

  4. Para extrair informações sobre bancos de dados e arquivos acessados pelo aplicativo, selecione Fontes de dados.

  5. Opcional: em Orientação de geração adicional, insira orientações de 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 essa 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 a velocidade e a profundidade da 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.

    • Estendido: 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évia.

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

  2. Opcional: 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.

    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 Plataforma de Agentes. 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 com suporte 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 disponibilizados apenas em um endpoint multirregional poderão não estar disponíveis. Isso acontece porque o Acesso privado do Google não consegue alcançar endpoints multirregionais. Para disponibilizar esses modelos e obedecer aos requisitos de residência de dados, configure a conectividade particular com o endpoint multirregional. Para instruções, consulte Configurar a conectividade particular 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 distinta de funcionalidade, 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.

  2. Clique em Próxima.

Criar avaliação

  1. 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.
  • Com falha:a avaliação não foi concluída.

Se você encontrar erros após importar o arquivo, poderá revisar 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 junto com o status.

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 aos 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 Obsoleto 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 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 settings 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 de atualizar as configurações, a Mainframe Assessment Tool inicia a análise novamente.

A seguir