Do Caos ao Prompt T1E3: Transformando Problemas Simples em Soluções Inteligentes com IA – Instalação de App Windows

INTRODUÇÃO

Posts anteriores: 

• Do Caos ao Prompt T1E1: Transformando Problemas Simples em Soluções Inteligentes com IA - Melhoria em App
• Do Caos ao Prompt T1E2: Transformando Problemas Simples em Soluções Inteligentes com IA – Teste de App Web

Contexto

Home Office de qualquer especialidade, que tenha interesse na utilização do MASP (Método de Análise e Solução de Problemas) com IA (Inteligência Artificial).

Objetivo

O objetivo deste post é apresentar outro exemplo de uso das 3 etapas iniciais do MASP, para especificação de um problema, com o propósito de criar Prompt de IA.

É importante ressaltar que a transformação da especificação no MASP em Prompt de IA, será feita por um Chatbot de IA.

Especificação do problema: Usando as 42 perguntas de ouro

Identificação do Especialista de IA

O Chatbot de IA é um profissional da área de TI, especialista no sistema operacional Windows e no Microsoft Windows Installer.

ETAPA 1 - IDENTIFICAÇÃO DO PROBLEMA: 

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

1.1 [What?]  - O que aconteceu diferente do esperado?
A instalação de um aplicativo Java Desktop no Windows está confundindo a maioria dos usuários, pois eles não têm familiaridade com instalação de aplicativo.
A instalação deveria ser feita automaticamente, com apenas um clique no arquivo msi (Microsoft Windows Installer) e fornecendo o nome da pasta de instalação, com opção para alterar esse nome, se já existir uma com o mesmo nome.

1.2 [Who?]   - Quem solicitou a mudança?
O fornecedor do aplicativo.

1.3 [When?]  - Evento que inicia a instalação?
Quando o fornecedor entrega o aplicativo ao usuário final.

1.4 [Where?] - Onde o usuário se confundiu?
Na própria instalação manual do aplicativo e dos arquivos.

1.5 [Why?] - Por que o usuário se confundiu?
Porque ele tem pouca experiência em instalação de aplicativo Java.

1.6 [How?] - Como é o procedimento, passo a passo, para instalação manual do aplicativo Java?

1.6.1 Passo 1: O usuário recebe um pendrive com o arquivo compactado do aplicativo, identificado por CaixaDoSaber.zip, que contém uma pasta CaixaDoSaber e um arquivo do Ambiente de Execução Java, identificado por jre-8u431-windows-x64. 

1.6.2 Passo 2: O usuário descompacta o arquivo CaixaDoSaber.zip na pasta Downloads.

1.6.3 Passo 3: O usuário copia a pasta CaixaDoSaber para C:\CaixaDoSaber.

1.6.4 Passo 4: O usuário instala o Ambiente de Execução Java.

1.6.5 Passo 5: O usuário abre a pasta C:\CaixaDoSaber, clica com o botão direito no arquivo CaixaDoSaber.jar, na janela aberta clica em propriedades, na outra janela aberta clica em Alterar, na outra janela aberta clica em “Java ™ Platform SE binary”, clica em OK, clica em OK na outra janela, seleciona o arquivo CaixaDoSaber.jar, clica com o botão direito, seleciona “Enviar para”, seleciona “Área de Trabalho”.

1.6.6 Passo 6: O ícone do aplicativo CaixaDoSaber vai para a Área de Trabalho.

1.6.7 Passo 7: O usuário clica no ícone do aplicativo CaixaDoSaber e a execução é iniciada.

ETAPA 2 - 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.

2.1 [Mão de Obra?] A Mão de Obra (exemplo: os usuários do aplicativo) podem ser causa do problema? Sim. 

2.2 [Máquina?] A Máquina (exemplo: Hardware, Sistema Operacional, Softwares básicos) podem ser causa do problema? Não.

2.3 [Métodos?] Os Métodos (exemplo: Componentes do aplicativo) podem ser causa do problema? Não

2.4 [Materiais?] Os Materiais (exemplo: os Dados das Entradas)  podem ser causa do problema? Não

2.5 [Meio Ambiente?] O Meio Ambiente (exemplo: os Dados das Saídas) podem ser causa do problema? Não

2.6 [Medições?] As Medições (exemplo: os Indicadores de Desempenho) podem ser causa do problema? Não

ETAPA 3 - ANÁLISE: 

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

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.

3.1 Mão de Obra: Por quê? Porque o usuário do aplicativo CaixaDoSaber não tem familiaridade com instalação de aplicativo.

3.2 Máquina: Por quê? Por quê? Por quê? Por quê? Por quê? Não se aplica.

3.3 Métodos: Por quê? Por quê? Por quê? Por quê? Por quê? Não se aplica.

3.4 Materiais: Por quê? Por quê? Por quê? Por quê? Por quê? Não se aplica.

3.5 Meio Ambiente: Por quê? Por quê? Por quê? Por quê? Por quê? Não se aplica.

3.6 Medições: Por quê? Por quê? Por quê? Por quê? Por quê? Não se aplica.

Comando para IA: 

Criar a "ETAPA 4 - PLANO DE AÇÃO" a fim de resolver o problema especificado acima e, se possível, escrever o código necessário para implementação. As ações a executar devem ser agrupadas em 5 etapas, a saber: 

Etapa 1: Verificação das Pré-condições

Etapa 2: Execução

Etapa 3: Revisão e Teste

Etapa 4: Encerramento

Etapa 5: Verificação das Pós-condições

Do Problema ao Prompt criado pela IA

Fonte: Copilot

Aqui está o Prompt transformado e refinado, contendo apenas o essencial:

Prompt conciso para IA:

Você é um especialista em TI, focado no sistema operacional Windows e no Microsoft Windows Installer. O objetivo é solucionar o problema de confusão dos usuários ao instalar o aplicativo Java Desktop "CaixaDoSaber" no Windows. A instalação ideal deve ser automática, via arquivo MSI, com opção para alterar o nome da pasta, se necessário.

Etapas:

1.Identifique o problema usando 5W1H:

O que? Instalação manual complexa confunde usuários com pouca experiência.

Quem? Fornecedor solicitou a mudança.

Quando? Ao entregar o aplicativo ao usuário final.

Onde? Durante a instalação manual no Windows.

Por quê? Falta de familiaridade dos usuários.

Como? Instalando o Java Runtime e configurando o arquivo .jar manualmente.

2.Observação com Diagrama de Ishikawa: 

A causa principal é a falta de conhecimento técnico dos usuários.

3.Analise a causa raiz com os "5 Porquês": Usuários não têm experiência em instalação.

4.Desenvolva um Plano de Ação em 5 etapas:

Pré-condições: Verificar dependências (Java Runtime, etc.).

Execução: Criar um instalador MSI automatizado para descompactar arquivos, instalar dependências e configurar o aplicativo.

Revisão e Teste: Validar o instalador com usuários típicos.

Encerramento: Documentar o processo.

Pós-condições: Verificar funcionalidade e acessibilidade do aplicativo.

Sua tarefa é implementar essas soluções e fornecer o código para automatizar a instalação, se possível.

Do Prompt à Solução do Problema pela IA

Solução:

Para solucionar o problema e criar um instalador automatizado para o aplicativo "CaixaDoSaber", vamos implementar um processo detalhado com base no plano de ação fornecido. 

Seguem as etapas e um exemplo de código para criar um arquivo MSI utilizando a ferramenta WiX Toolset, que é popular para criar instaladores no Windows.

Plano de Ação

1. Pré-condições:

Verificar se o Ambiente de Execução Java (JRE) está disponível.

Garantir que o WiX Toolset esteja instalado para criar o instalador MSI. Faça o download em: WiX Toolset.

Validar os arquivos do aplicativo: CaixaDoSaber.zip e jre-8u431-windows-x64.

2. Execução: 

Criar o instalador MSI automatizado.

O código abaixo demonstra como criar um instalador MSI que descompacta arquivos, instala o JRE e configura o aplicativo.

Exemplo: Arquivo Product.wxs para o WiX Toolset

xml

<?xml version="1.0" encoding="UTF-8"?>

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">

  <Product Id="*" Name="CaixaDoSaber" Language="1033" Version="1.0.0.0" Manufacturer="SeuNome" UpgradeCode="PUT-GUID-HERE">

    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

    <MediaTemplate />

    <Feature Id="ProductFeature" Title="CaixaDoSaber" Level="1">

      <ComponentGroupRef Id="ProductComponents" />

    </Feature>

    <!-- Pasta de instalação -->

    <Directory Id="TARGETDIR" Name="SourceDir">

      <Directory Id="ProgramFilesFolder">

        <Directory Id="INSTALLFOLDER" Name="CaixaDoSaber">

          <Component Id="MainExecutable" Guid="PUT-GUID-HERE">

            <File Source="C:\Caminho\Para\CaixaDoSaber.jar" KeyPath="yes" />

          </Component>

        </Directory>

      </Directory>

    </Directory>

    <MajorUpgrade DowngradeErrorMessage="A versão mais recente já está instalada." />

    <UIRef Id="WixUI_Minimal" />

  </Product>

  <Fragment>

    <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">

      <!-- Adicionar outros arquivos necessários -->

    </ComponentGroup>

  </Fragment>

</Wix>

3. Revisão e Teste

Compile o arquivo .wxs para gerar o instalador MSI:

bash

candle Product.wxs

light Product.wixobj -o CaixaDoSaberInstaller.msi

Execute o arquivo CaixaDoSaberInstaller.msi para testar o processo de instalação.

4. Encerramento

Documente o processo de instalação automática com instruções claras para o usuário final.

5. Pós-condições

Confirme que o aplicativo funciona corretamente após a instalação.

Certifique-se de que o ícone do aplicativo aparece na área de trabalho e inicia o programa com um clique.

Considerações Finais

Esse exemplo é um ponto de partida. É possível adicionar mais funcionalidades ao instalador, como instalar o JRE automaticamente ou permitir a personalização do diretório de instalação pelo usuário. Se precisar de ajuda para ajustar o código ou expandir o instalador, estou à disposição! 😊

Interação adicional para melhorar o Prompt

Vamos ajustar o instalador para incluir as funcionalidades de instalação automática do JRE e permitir que o usuário personalize o diretório de instalação. 

O código atualizado no WiX Toolset reflete essas mudanças.

Atualização do Código WiX

Instalação Automática do JRE:

Adicionaremos o JRE como uma dependência no instalador. Ele será executado automaticamente durante a instalação.

Personalização do Diretório:

Permitiremos que o usuário selecione o diretório de instalação por meio de uma interface amigável.

Abaixo está o código atualizado do arquivo Product.wxs:

xml

<?xml version="1.0" encoding="UTF-8"?>

<Wix xmlns="http://schemas.microsoft.com/wix/2006/wi">

  <Product Id="*" Name="CaixaDoSaber" Language="1033" Version="1.0.0.0" Manufacturer="SeuNome" UpgradeCode="PUT-GUID-HERE">

    <Package InstallerVersion="200" Compressed="yes" InstallScope="perMachine" />

    <MediaTemplate />

    <!-- Configuração de Diretório Personalizado -->

    <Property Id="INSTALLFOLDER" Value="C:\Program Files\CaixaDoSaber" />

    <UIRef Id="WixUI_InstallDir" />

    <Feature Id="ProductFeature" Title="CaixaDoSaber" Level="1">

      <ComponentGroupRef Id="ProductComponents" />

    </Feature>

    <!-- Diretórios -->

    <Directory Id="TARGETDIR" Name="SourceDir">

      <Directory Id="ProgramFilesFolder">

        <Directory Id="INSTALLFOLDER" Name="CaixaDoSaber">

          <Component Id="MainExecutable" Guid="PUT-GUID-HERE">

            <File Source="C:\Caminho\Para\CaixaDoSaber.jar" KeyPath="yes" />

          </Component>

        </Directory>

      </Directory>

    </Directory>

    <!-- Instalação Automática do JRE -->

    <CustomAction Id="InstallJRE" FileKey="JREInstaller" ExeCommand="/s" Return="check" />

    <InstallExecuteSequence>

      <Custom Action="InstallJRE" After="InstallInitialize">NOT Installed</Custom>

    </InstallExecuteSequence>

    <!-- Arquivo JRE -->

    <DirectoryRef Id="TARGETDIR">

      <Component Id="JREInstallerComponent" Guid="PUT-GUID-HERE">

        <File Id="JREInstaller" Source="C:\Caminho\Para\jre-8u431-windows-x64.exe" KeyPath="yes" />

      </Component>

    </DirectoryRef>

    <MajorUpgrade DowngradeErrorMessage="A versão mais recente já está instalada." />

  </Product>

  <Fragment>

    <ComponentGroup Id="ProductComponents" Directory="INSTALLFOLDER">

      <!-- Componentes adicionais -->

    </ComponentGroup>

  </Fragment>

</Wix>

O que foi alterado:

1.Instalação Automática do JRE:

Adicionei o JRE como dependência no <CustomAction> para ser instalado automaticamente com o comando silencioso (/s).

2.Diretório Personalizado:

O usuário pode personalizar o diretório de instalação através da interface gráfica ativada pelo <UIRef Id="WixUI_InstallDir" />.

Passos Adicionais:

1.Compile o instalador com o WiX Toolset:

bash

candle Product.wxs

light Product.wixobj -o CaixaDoSaberInstaller.msi

candle Product.wxs

light Product.wixobj -o CaixaDoSaberInstaller.msi -ext WixUIExtension

2.Execute o arquivo MSI gerado e teste as funcionalidades:

Escolha do diretório de instalação.

Instalação automática do JRE.

Com essas melhorias, o instalador agora facilita a experiência do usuário e automatiza processos essenciais. Se precisar de mais ajuda ou ajustes, estou aqui! 😊

CONCLUSÃO

O código xml gerado automaticamente pelo Chatbot de IA teve que ser complementado e, para isso, foram necessárias várias interações com a IA, mas, desta vez, as perguntas ao Chatbot foram bem objetivas e baseadas nas mensagens de erro emitidas. 

Próximo Post: Do Caos ao Prompt T1E4: Transformando Problemas Simples em Soluções Inteligentes com IA – Instalação de App Android (Wi-Fi)

Demais Episódios da Temporada

• Série Do Caos ao Prompt
• Temporada T1Transformando Problemas Simples em Soluções Inteligentes com IA
• Episódio E1 Melhoria em App Web
• Episódio E2 Teste de App Web
• Episódio E4 Instalação de App Android (Wi-Fi)