Estudo de Caso T2E3: Solução de Problema com IA e MASP - Instalação de Aplicativo

INTRODUÇÃO

Este é o episódio 3 da temporada 2 da série “Estudo de Caso”, com foco na solução de problema em instalação de aplicativo Desktop Java, utilizando Inteligência Artificial (IA) e o Método de Análise e Solução de Problemas (MASP).

O objetivo deste Post é mostrar um Prompt completo, elaborado com base no MASP, para pedir a um Chatbot de IA, um Plano de Ação para resolver um problema.

Clique aqui para ver um modelo de Prompt usando MASP.

Clique aqui para ver um exemplo de Prompt usando MASP.

Estudo de Caso

Para este estudo de caso foi criado o Prompt abaixo, que utiliza o MASP para especificar com clareza um problema, a fim de pedir ajuda a um Chatbot de IA na solução.

Objetivo

Solucionar um problema de Tecnologia da Informação (TI), usando o Método de Análise e Solução de Problema (MASP), no contexto abaixo.

Contexto

O contexto é a instalação de um aplicativo Java Desktop, que apresenta ao usuário opções de jogo com Flashplayer, no sistema operacional Windows.

Após a instalação, o usuário fez duplo clique no executável jar, e apareceu uma tela de aviso com mensagem de erro na inicialização.

Por outro lado, o roteiro de instalação funcionou normalmente em outras máquinas.

1 PERSONAGEM

1.1 Qual o papel do Chatbot de IA? Profissional da área de TI especialista em desenvolvimento de aplicativo Java Desktop que usa Flashplayer para apresentar jogos, no sistema operacional Windows.

2 IDENTIFICAÇÃO DO PROBLEMA

Definir claramente o problema (diferença entre o que é e o que deveria ser). Utilizar 5W1H.

2.1 [What?]  - O que aconteceu diferente do esperado?

Apareceu esta mensagem numa janela de alerta: "Erro inicializar o App ...”.

2.2 [Who?]   - Quem iniciou a execução? O usuário

2.3 [When?]  - Evento que iniciou a execução? Duplo clique no arquivo jar e, também, duplo clique no ícone do app na área de trabalho do Windows.

2.4 [Where?] - Onde a execução parou? Na classe InitTask.

2.5 [Why?]   - Por que a execução parou? Não sei, mas o fato é que este roteiro de instalação funcionou em outras máquinas. 

2.6 [How?]   - Como é o procedimento, passo a passo, para reproduzir o erro? 

Passo 1: Instalar WinRAR
Passo 2: Instalar o ambiente Java do link jdk-8u431-windows-i586.zip.
Passo 3: Baixar do Google Drive a pasta compactada com os recursos e código executável.
Passo 4: Extrair os arquivos da pasta compactada com a opção "Extract Here..." do WinRAR.
Passo 5: Copiar a pasta descompactada para o drive C.
Passo 6: Clicar com o botão direito no arquivo jar, no menu de contexto selecionar “Enviar para” e no submenu de contexto clicar na opção “Área de Trabalho (criar Atalho)”.
Passo 7: Para executar, dar duplo clique no arquivo jar, na pasta do drive C, ou duplo clique no ícone do aplicativo na Área de Trabalho.

3 OBSERVAÇÃO

Investigar as características específicas do problema com uma visão ampla e sob vários pontos de vista. Utilizar Diagrama de Ishikawa ou Causa e Efeito.

3.1 [Pessoas?] Como este item influencia no problema?

3.1.1 Falta de treinamento adequado da equipe? Não.

3.1.2 Problemas de comunicação entre membros da equipe? Não.

3.1.3 Ausência de revisões? Não

3.2 [Recurso?] Como este item influencia no problema?

3.2.1 Computador desatualizado? Não

3.2.2 Aplicativo desatualizado ou instável? Não

3.2.3 Configurações do ambiente incorretas ou inconsistentes? É possível, mas não tenho evidências.

3.2.4 Configuração incorreta das variáveis de ambiente? É possível, mas não tenho evidências.

3.2.5 Incompatibilidades no ambiente, ou seja, diferenças entre os ambientes onde o processo é executado? Não. 

3.2.6 Condições de rede, ou seja, problemas de conectividade que afetam a execução do processo? Não.

3.3 [Método?] Como este item influencia no problema?

3.3.1 Práticas de execução inadequadas? Não.

3.3.2 Falta de documentação do Procedimento Operacional Padrão? É possível, mas não tenho evidências.

3.3.3 Processo de verificação deficiente, com testes insuficientes ou mal planejados? Não.

3.4 [Entrada?] Como este item influencia no problema?

3.4.1 Informações de terceiros com falhas ou incompatíveis? Não

3.4.2 Informações de terceiros instáveis ou desatualizadas? Não

3.4.3 Dependências de Informações de terceiros inadequadas ou desatualizadas? Não.

3.5 [Saída?] Como este item influencia no problema?

3.5.1 Resultado incompleto, impreciso ou inválido? Não

3.5.2 Resultado indisponível no local esperado? Sim

3.5.3 Resultado rejeitado por quem vai utilizá-lo? Não

3.6 [Medição?] Como este item influencia no problema?

3.6.1 Falta de monitoramento adequado do desempenho? Não

3.6.2 Falta de métricas claras e consistentes para avaliar a qualidade do processo? Não

3.6.3 Ausência de ferramentas de análise para detectar problemas no processo? Não

4 ANÁLISE

Descobrir as causas fundamentais. Utilizar "5 Porquês".

4.1 Para cada problema encontrado no item 3 OBSERVAÇÃO, perguntar 5 vezes o porquê do problema ou defeito ter ocorrido, a fim de descobrir a sua real causa, ou seja, a causa raiz.

4.1.1 Pessoas: Por que a forma de executar o trabalho influencia no problema? Não influencia.

4.1.2 Recurso: Por que os recursos utilizados podem ter influência no problema? Porque em máquinas de outras pessoas, a instalação foi realizada com sucesso.

4.1.3 Método: Por que o método de instalação influencia no problema? Porque os mesmos passos funcionam em outras máquinas.

4.1.4 Entrada: Por que a qualidade da informação de entrada influencia no problema? Não influencia

4.1.5 Saída: Por que a qualidade da informação de saída influencia no problema? Não influencia

4.1.6 Medição: Por que o modo de medir o desenvolvimento de atividades influencia no problema? Não influencia

COMANDO PARA O CHATBOT DE IA

Crie um Plano de Ação para resolver o problema especificado acima e, se possível, ensine como executar as ações.

O Plano de Ação deve ter 5 etapas: Iniciação, Planejamento, Execução, Monitoramento e Controle e Encerramento.

Cada etapa do Plano de Ação deve ter 3 grupos de tarefas executáveis: Entrada, Passos, Saída.

Cada Entrada deve especificar, além de dados e recursos disponíveis, as pré-condições, que são os requisitos para iniciar a execução dos passos.

Cada Saída deve especificar, além de dados e recursos disponibilizados, as pós-condições, que são os requisitos para considerar a execução encerrada com sucesso.

Resposta do Chatbot de IA Google Gemini

Olá! Entendi a situação. Parece que você, um especialista em Java Desktop com experiência em Flashplayer, está enfrentando um erro específico ao tentar executar seu aplicativo em uma máquina Windows, mesmo seguindo um roteiro que funcionou em outros computadores. Vamos criar um plano de ação para tentar solucionar isso.

1 PERSONAGEM

1.1 O papel do Chatbot de IA neste contexto é o de um assistente virtual para auxiliar na resolução de problemas técnicos, fornecendo um plano de ação estruturado e, quando possível, orientações sobre como executar as etapas.

2 IDENTIFICAÇÃO DO PROBLEMA

O problema central é a falha na inicialização do aplicativo Java Desktop, manifestada pela mensagem de erro "Erro inicializar o App ...", ao tentar executá-lo no sistema operacional Windows, apesar do procedimento de instalação ter sido bem-sucedido em outras máquinas.

3 OBSERVAÇÃO

Analisando os pontos levantados, a questão das Configurações do ambiente incorretas ou inconsistentes (3.2.3) e a Configuração incorreta das variáveis de ambiente (3.2.4) parecem ser os pontos mais prováveis a serem investigados, já que o roteiro de instalação funcionou em outros computadores. A Falta de documentação do Procedimento Operacional Padrão (3.3.2) também pode ser um fator a ser considerado a longo prazo para evitar problemas futuros.

4 ANÁLISE

Aplicando os "5 Porquês" aos pontos mais relevantes:

• Por que a execução parou? Porque apareceu a mensagem "Erro inicializar o App ...".
• Por que essa mensagem apareceu? Possivelmente porque o ambiente de execução Java não foi configurado corretamente ou há algum problema específico com a instalação do seu aplicativo neste computador.
• Por que o ambiente Java pode não estar configurado corretamente? Talvez a instalação não tenha sido completa, alguma variável de ambiente não foi definida ou está incorreta, ou há alguma interferência de outro software.
• Por que pode haver um problema específico com a instalação do aplicativo neste computador? Pode haver alguma dependência não atendida, algum arquivo corrompido durante a cópia, ou alguma permissão inadequada.
• Por que essas questões não ocorreram em outras máquinas? Porque a configuração do sistema operacional, as versões de software instaladas e as permissões podem ser diferentes entre os computadores.

Plano de Ação para Resolver o Erro de Inicialização do Aplicativo Java Desktop

Link da conversa com o Chatbot de IA Gemini: https://g.co/gemini/share/a6504fb1d8e5

Este plano de ação visa resolver o erro de inicialização do seu aplicativo Java Desktop no sistema operacional Windows.

Etapa 1: Iniciação

• Entrada:
  • Descrição detalhada do problema (já fornecida).
  • Informações sobre o ambiente de desenvolvimento e as dependências do aplicativo (versão do Java utilizada no desenvolvimento, bibliotecas externas, etc.).
  • Acesso ao computador onde o erro ocorre.
  • Tempo disponível para diagnóstico e testes.
  • Pré-condições: O sistema operacional Windows está funcional e o usuário tem permissões administrativas no computador.
• Passos:
  1. Revisar a descrição do problema e o histórico de tentativas de solução (se houver).
  2. Documentar o ambiente atual do computador com o problema (versão do Windows, versão do Java instalada - executar java -version no prompt de comando).
  3. Definir as ferramentas que serão utilizadas para diagnóstico (Prompt de Comando, Gerenciador de Tarefas, etc.).
• Saída:
  • Documento inicial com o resumo do problema e informações do ambiente.
  • Lista de possíveis causas levantadas até o momento.
  • Pós-condições: Compreensão clara do problema e do ambiente em que ele ocorre, e ferramentas de diagnóstico prontas para uso.

Etapa 2: Planejamento

• Entrada:
  • Documento inicial com o resumo do problema e informações do ambiente (da Etapa 1).
  • Lista de possíveis causas levantadas.
  • Conhecimento do processo de instalação e execução do aplicativo.
  • Pré-condições: A Etapa 1 foi concluída e as informações necessárias foram coletadas.
• Passos:
  1. Priorizar as possíveis causas com base na probabilidade e no impacto.
  2. Definir as ações de investigação para cada causa prioritária (verificar variáveis de ambiente, reinstalar o Java, testar a execução diretamente do JAR, etc.).
  3. Estabelecer uma ordem para a execução das ações de investigação.
• Saída:
  • Plano de investigação detalhado com as ações a serem executadas em ordem de prioridade.
  • Lista de critérios para determinar se uma causa foi descartada ou confirmada.
  • Pós-condições: Plano de ação claro e estruturado para a fase de execução.

Etapa 3: Execução

• Entrada:
  • Plano de investigação detalhado (da Etapa 2).
  • Acesso ao computador com o problema.
  • Arquivos de instalação do Java (jdk-8u431-windows-i586.zip).
  • Pasta descompactada do aplicativo no drive C:.
  • Pré-condições: A Etapa 2 foi concluída e o plano de investigação está definido.
• Passos:
  1. Verificar as variáveis de ambiente do Java:
     • Pressione a tecla Windows, digite "variáveis de ambiente do sistema" e selecione a opção.
     • Na janela "Propriedades do Sistema", clique no botão "Variáveis de Ambiente...".
     • Na seção "Variáveis do usuário" e "Variáveis do sistema", procure por variáveis relacionadas ao Java (principalmente JAVA_HOME e a entrada do diretório bin do Java na variável Path).
     • Verifique se a variável JAVA_HOME está definida para o diretório de instalação do JDK (ex: C:\Program Files (x86)\Java\jdk1.8.0_431 ou C:\Program Files\Java\jdk1.8.0_431).
     • Verifique se o caminho para o diretório bin do Java (ex: %JAVA_HOME%\bin) está incluído na variável Path. Se não estiver, adicione-o.
     • Como executar: Abra o Prompt de Comando e execute echo %JAVA_HOME% e path. Verifique se a saída corresponde às configurações esperadas.
  2. Reinstalar o Java:
     • Desinstale completamente a versão atual do Java através do Painel de Controle ("Programas e Recursos").
     • Reinicie o computador.
     • Execute o instalador do JDK (jdk-8u431-windows-i586.exe, após extrair do ZIP) como administrador.
     • Siga as instruções do instalador.
     • Após a instalação, verifique novamente as variáveis de ambiente conforme o Passo 1.
  3. Testar a execução diretamente do JAR:
     • Abra o Prompt de Comando.
     • Navegue até a pasta onde o arquivo JAR do seu aplicativo está localizado (provavelmente em C:\<nome_da_pasta_descompactada>\).
     • Execute o comando: java -jar <nome_do_arquivo>.jar (substitua <nome_do_arquivo>.jar pelo nome real do seu arquivo JAR). Observe se alguma mensagem de erro é exibida no Prompt de Comando.
  4. Verificar permissões da pasta do aplicativo:
     • Clique com o botão direito na pasta do seu aplicativo em C:\.
     • Selecione "Propriedades".
     • Vá para a aba "Segurança".
     • Verifique se o seu usuário tem permissões de leitura e execução na pasta e nos arquivos. Se necessário, ajuste as permissões.
  5. Considerar a possibilidade de interferência de outro software: Desative temporariamente softwares de segurança (antivírus, firewall) para verificar se eles estão bloqueando a execução do aplicativo. Reative-os após o teste.
• Saída:
  • Registro das ações executadas e seus resultados (mensagens de erro, alterações nas configurações, etc.).
  • Identificação da causa raiz do problema (se encontrada).
  • Pós-condições: As ações de investigação planejadas foram executadas e os resultados foram documentados.

Etapa 4: Monitoramento e Controle

• Entrada:
  • Registro das ações executadas e seus resultados (da Etapa 3).
  • O aplicativo está sendo executado (ou não).
  • Pré-condições: A Etapa 3 foi concluída.
• Passos:
  1. Monitorar a execução do aplicativo após cada tentativa de correção.
  2. Comparar os resultados com os critérios de sucesso definidos no planejamento.
  3. Se o problema persistir, revisar o plano de investigação e considerar outras possíveis causas.
  4. Documentar quaisquer novas mensagens de erro ou comportamentos inesperados.
• Saída:
  • Relatório de status da resolução do problema.
  • Decisão sobre se o problema foi resolvido ou se são necessárias mais investigações.
  • Pós-condições: O status do problema é claramente definido e as próximas etapas (se houver) são identificadas.

Etapa 5: Encerramento

• Entrada:
  • Relatório de status da resolução do problema (da Etapa 4).
  • O aplicativo está funcionando corretamente no ambiente Windows.
  • Pré-condições: O problema foi resolvido e o aplicativo está funcionando como esperado.
• Passos:
  1. Confirmar com o usuário que o problema foi resolvido.
  2. Documentar a causa raiz do problema e a solução implementada.
  3. Revisar o procedimento de instalação original e identificar possíveis melhorias ou pontos de falha.
  4. Considerar a criação de um documento de solução de problemas para referência futura.
• Saída:
  • Registro final da resolução do problema, incluindo a causa raiz e a solução.
  • Lições aprendidas e possíveis melhorias no processo.
  • Pós-condições: O problema está resolvido, a solução está documentada e medidas preventivas futuras são consideradas.

Espero que este plano de ação detalhado ajude você a identificar e resolver o problema de inicialização do seu aplicativo Java Desktop! Boa sorte!

CONCLUSÃO

A utilização do MASP, com suas 42 perguntas, foi importante para o desenvolvedor relembrar, coletar e registrar no Prompt fatos e dados importantes para solicitar ajuda ao Chatbot de IA.

Assim que o plano de ação for executado com sucesso, a solução do problema será relatada no próximo tópico.

Solução do problema

O desenvolvedor está executando o plano de ação para solução do problema.

Demais Episódios da Temporada:

• Série Estudo de Caso:
• Temporada T2 Solução de Problema com IA e MASP:
• Episódio E1 Serviço de infraestrutura na nuvem
• Episódio E2 Aplicativo Web
• Episódio E4 Aplicativo Web
• Episódio E5 Correção T2E4
• Episódio E6 Correção T2E2