Guia passo a passo para instalar e usar o AI Shell no Windows

Dominando a instalação e o uso do AI Shell no Windows

O AI Shell capacita os usuários integrando recursos avançados de inteligência artificial diretamente na interface de linha de comando (CLI). Esta ferramenta oferece um ambiente de conversação para interagir com vários modelos de IA, aumentando a produtividade por meio de sintaxe de comando fácil, resolução de erros e até mesmo geração de código. Este guia abrangente o levará pela instalação passo a passo e uso eficaz do AI Shell em seu sistema Windows.

Pré-requisitos para instalar o AI Shell

Antes de iniciar a instalação, certifique-se de ter:

Sistema operacional Windows 10 ou Windows 11.
PowerShell versão 7.4.6 ou superior instalado no seu sistema.
Acesso administrativo para instalar software e modificar variáveis de ambiente.

Ter esses pré-requisitos garante um processo de instalação mais tranquilo e minimiza possíveis problemas.

Atualizando o PowerShell para a versão mais recente

Para instalar o AI Shell com sucesso, você precisa ter o PowerShell atualizado para a versão 7.4.6 ou superior. Siga estas etapas para uma atualização perfeita:

Pressione Win + Xe selecione Windows PowerShell (Admin) .
Permita que scripts sejam executados temporariamente executando:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Execute os seguintes comandos para baixar e instalar o PowerShell mais recente:

Invoke-RestMethod -Uri "https://aka.ms/install-powershell.ps1"-OutFile "install-powershell.ps1" .\install-powershell.ps1

Adicione o PowerShell ao PATH do seu sistema:

Pressione Win + R, digite SystemPropertiesAdvancede pressione Enter.
Clique em Variáveis de Ambiente .
Na seção Variáveis do sistema , encontre Caminho e selecione Editar .
Clique em Novo e adicione o caminho:
C:\Users\\AppData\Local\Microsoft\powershell

Lembre-se de substituir <YourUsername>pelo seu nome de usuário real do Windows.

Clique em OK para salvar as alterações.

Abra a nova versão do PowerShell usando:

pwsh

Verifique sua instalação executando:

$PSVersionTable

(Opcional) Restaure a política de execução padrão, se necessário:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

Seguir essas etapas garante que o PowerShell seja atualizado para pelo menos a versão 7.4.6 e acessível globalmente, preparando o cenário para uma instalação bem-sucedida do AI Shell.

Instalando o AI Shell usando o script de instalação

O método mais rápido para instalar o AI Shell é por meio de um script de instalação automatizado que configura tudo para você. Veja como fazer:

Abra o Terminal como administrador pressionando a Wintecla, digitando “Terminal”, clicando com o botão direito do mouse em “Terminal” e escolhendo “Executar como administrador”.
Se o Terminal não abrir com o PowerShell por padrão, selecione “Windows PowerShell” no menu suspenso na barra de guias.
Inicie a instância atualizada do PowerShell digitando:

pwsh

Execute o script de instalação com o seguinte comando:

Invoke-Expression "& { $(Invoke-RestMethod 'https://aka.ms/install-aishell.ps1') }"

Este comando faz o download aish.exee $env:LOCALAPPDATA\Programs\AIShelladiciona o arquivo ao PATH do seu sistema, permitindo acesso a partir de qualquer prompt de comando.

Após a instalação, inicie o AI Shell inserindo o comando Start-AIShellno PowerShell. Isso abrirá um painel dividido no Windows Terminal com o AI Shell pronto para uso. Você será solicitado a selecionar um agente de IA assim que iniciá-lo.

Instalando manualmente o AI Shell

Para aqueles que preferem uma abordagem prática para instalação, você pode instalar o AI Shell manualmente. Aqui está um método passo a passo:

Baixe o arquivo ZIP mais recente do AI Shell da fonte oficial que corresponde à arquitetura do seu sistema (por exemplo, AIShell-1.0.0-preview.1-win-x64.zip).
Extraia o arquivo ZIP para uma pasta designada no seu sistema, como C:\AIShell.
Adicione a pasta à variável PATH do seu sistema, permitindo que você execute aish.exeglobalmente.

Para fazer isso, pesquise por “variáveis de ambiente” na Pesquisa do Windows, selecione “Editar as variáveis de ambiente do sistema” e abra “Variáveis de ambiente”. Na área Variáveis do sistema , localize e edite Caminho , adicionando o caminho completo para a pasta extraída (por exemplo, C:\AIShell).

Abra o PowerShell como administrador e instale o módulo AI Shell PowerShell executando:

Install-PSResource -Name AIShell

Este comando recupera e instala o módulo necessário da PowerShell Gallery, permitindo integração perfeita ao seu ambiente CLI.

Configurando e usando o AI Shell

Depois que o AI Shell estiver instalado, configurá-lo para o agente de IA escolhido é o próximo passo. Por padrão, o AI Shell fornece dois agentes: Azure OpenAI Agent e Copilot no Azure. O agente do Azure OpenAI requer configuração adicional, fornecendo seu ponto de extremidade, chaves de API e, possivelmente, um prompt do sistema para adaptar o modelo de IA às suas necessidades específicas. O agente Copilot no Azure se concentra em tarefas relacionadas ao Azure, exigindo que você esteja conectado ao Azure para usá-lo.

Selecione um agente no painel de configuração para iniciar o processo de configuração.

Configure seu agente selecionado executando o comando /agent configno painel AI Shell. Um arquivo de configuração no formato JSON será aberto, permitindo que você insira configurações essenciais, como credenciais de acesso à API:

{ "GPTs": [ // Example configuration for Azure OpenAI { "Name": "ps-az-gpt4", "Description": "A GPT instance for PowerShell.", "Endpoint": "<insert your Azure OpenAI endpoint>", "Deployment": "<insert your deployment name>", "ModelName": "<insert the model name>", "Key": "<insert your key>", "SystemPrompt": "You are a helpful assistant for PowerShell scripting." } ], "Active": null }

Substitua os placeholders pelas suas chaves de API reais e salve o arquivo de configuração. Em seguida, atualize digitando /refreshno painel AI Shell para aplicar as alterações.

Interagir com o AI Shell é simples: digite suas consultas no painel. Para direcionar um comando a um agente específico, use a sintaxe @<agentName>que precede sua consulta, como @openai-gpt "How do I list files in a directory?".

Acelerando seu fluxo de trabalho com comandos de shell de IA

O AI Shell inclui uma variedade de comandos integrados e atalhos de teclado que podem aumentar sua produtividade:

Use o /code postcomando ou Ctrl + D, Ctrl + Datalho para inserir o código gerado na sessão atual do PowerShell.
Utilize /code copyou Ctrl + D, Ctrl + Ccopie trechos de código gerados para sua área de transferência para uso posterior.
Navegue entre os painéis do AI Shell e do PowerShell com Alt + RightArrowe Alt + LeftArrow.
Envie mensagens de erro ao AI Shell para obter assistência usando o Resolve-Errorcmdlet.
Para consultas complexas, utilize o Invoke-AIShellcomando para interagir com o agente selecionado.
Digite /helppara exibir todos os comandos disponíveis.

O /code postcomando simplifica a publicação de código do AI Shell na sua sessão, enquanto /code copyauxilia a salvar trechos de código para referência futura. Com o Resolve-Errorcomando, você pode receber suporte em tempo real para solução de problemas diretamente pelo AI Shell.

Conclusão

O AI Shell aprimora a interação com modelos de IA usando uma interface de linha de comando, ideal para desenvolvedores e profissionais de TI. Quer você opte pelo script de instalação automatizado ou escolha instalá-lo manualmente para mais controle, o AI Shell simplifica a experiência de interação com IA. Ele aproveita uma interface intuitiva, comandos robustos e integração perfeita para aumentar significativamente a produtividade nas tarefas diárias.

Insights adicionais

1. Quais são os requisitos de sistema do AI Shell?

O AI Shell requer Windows 10 ou Windows 11 e PowerShell versão 7.4.6 ou superior. Certifique-se de ter acesso administrativo para instalação e configuração.

2. Posso usar o AI Shell sem conexão com a internet?

O AI Shell requer uma conexão com a Internet para interagir com modelos de IA hospedados online, especialmente ao usar o agente do Azure OpenAI ou acessar APIs públicas.

3. Como posso solucionar problemas de instalação com o AI Shell?

Se você encontrar problemas, certifique-se de que seu PowerShell esteja atualizado, verifique novamente a configuração da variável PATH e use o Resolve-Errorcomando para obter assistência durante o tempo de execução.

Fonte e Imagens