Guida passo passo per installare e utilizzare AI Shell su Windows

Padroneggiare l’installazione e l’utilizzo di AI Shell su Windows

AI Shell potenzia gli utenti integrando funzionalità avanzate di intelligenza artificiale direttamente nell’interfaccia a riga di comando (CLI). Questo strumento offre un ambiente conversazionale per interagire con vari modelli di IA, migliorando la produttività tramite una semplice sintassi dei comandi, risoluzione degli errori e persino generazione di codice. Questa guida completa ti guiderà attraverso l’installazione passo dopo passo e l’uso efficace di AI Shell sul tuo sistema Windows.

Prerequisiti per l’installazione di AI Shell

Prima di iniziare l’installazione, assicurati di avere:

Sistema operativo Windows 10 o Windows 11.
Sul sistema deve essere installata la versione 7.4.6 o successiva di PowerShell.
Accesso amministrativo per installare software e modificare variabili ambientali.

La presenza di questi prerequisiti garantisce un processo di installazione più fluido e riduce al minimo i potenziali problemi.

Aggiornamento di PowerShell all’ultima versione

Per installare correttamente AI Shell, devi avere PowerShell aggiornato alla versione 7.4.6 o superiore. Segui questi passaggi per un aggiornamento senza problemi:

Premere Win + Xe selezionare Windows PowerShell (amministratore) .
Consentire l’esecuzione temporanea degli script eseguendo:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Eseguire i seguenti comandi per scaricare e installare la versione più recente di PowerShell:

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

Aggiungi PowerShell al tuo sistema PATH:

Premere Win + R, digitare SystemPropertiesAdvancede premere Invio.
Fare clic su Variabili d’ambiente .
Nella sezione Variabili di sistema , trova Percorso e seleziona Modifica .
Fare clic su Nuovo e aggiungere il percorso:
C:\Users\\AppData\Local\Microsoft\powershell

Ricordati di sostituire <YourUsername>con il tuo vero nome utente Windows.

Fare clic su OK per salvare le modifiche.

Aprire la nuova versione di PowerShell utilizzando:

pwsh

Verifica l’installazione eseguendo:

$PSVersionTable

(Facoltativo) Ripristinare la policy di esecuzione predefinita, se necessario:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

Seguendo questi passaggi si garantisce che PowerShell sia aggiornato almeno alla versione 7.4.6 e accessibile a livello globale, preparando il terreno per un’installazione corretta di AI Shell.

Installazione di AI Shell tramite lo script di installazione

Il metodo più veloce per installare AI Shell è tramite uno script di installazione automatizzato che configura tutto per te. Ecco come fare:

Aprire il Terminale come amministratore premendo il Wintasto , digitando “Terminale”, facendo clic con il pulsante destro del mouse su “Terminale” e scegliendo “Esegui come amministratore”.
Se il Terminale non si apre con PowerShell per impostazione predefinita, selezionare “Windows PowerShell” dal menu a discesa nella barra delle schede.
Avviare l’istanza di PowerShell aggiornata immettendo:

pwsh

Eseguire lo script di installazione con il seguente comando:

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

Questo comando scarica aish.exee $env:LOCALAPPDATA\Programs\AIShellaggiunge il file al PATH del sistema, consentendo l’accesso da qualsiasi prompt dei comandi.

Dopo l’installazione, avvia AI Shell immettendo il comando Start-AIShellin PowerShell. Questo aprirà un riquadro diviso in Windows Terminal con AI Shell pronto all’uso. Ti verrà chiesto di selezionare un agente AI non appena lo avvii.

Installazione manuale di AI Shell

Per coloro che preferiscono un approccio pratico all’installazione, è possibile installare AI Shell manualmente. Ecco un metodo passo dopo passo:

Scarica l’ultimo file ZIP di AI Shell dalla fonte ufficiale che corrisponde all’architettura del tuo sistema (ad esempio, AIShell-1.0.0-preview.1-win-x64.zip).
Estrarre il file ZIP in una cartella designata sul sistema, ad esempio C:\AIShell.
Aggiungi la cartella alla variabile PATH del tuo sistema, consentendo l’esecuzione aish.exeglobale.

Per fare ciò, cerca “variabili di ambiente” nella Ricerca di Windows, seleziona “Modifica le variabili di ambiente di sistema” e apri “Variabili di ambiente”. Nell’area Variabili di sistema , individua e modifica Percorso , aggiungendo il percorso completo alla cartella estratta (ad esempio, C:\AIShell).

Aprire PowerShell come amministratore e installare il modulo AI Shell PowerShell eseguendo:

Install-PSResource -Name AIShell

Questo comando recupera e installa il modulo richiesto dalla PowerShell Gallery, consentendo un’integrazione perfetta nell’ambiente CLI.

Configurazione e utilizzo di AI Shell

Una volta installata AI Shell, il passaggio successivo è configurarla per l’agente AI scelto. Per impostazione predefinita, AI Shell fornisce due agenti: Azure OpenAI Agent e Copilot in Azure. L’agente Azure OpenAI richiede una configurazione aggiuntiva, fornendo l’endpoint, le chiavi API e, possibilmente, un prompt di sistema per adattare il modello AI alle tue esigenze specifiche. L’agente Copilot in Azure si concentra sulle attività correlate ad Azure, il che richiede che tu abbia effettuato l’accesso ad Azure per utilizzarlo.

Selezionare un agente dal pannello di configurazione per avviare il processo di installazione.

Configura l’agente selezionato eseguendo il comando /agent confignel riquadro AI Shell. Si aprirà un file di configurazione in formato JSON, che ti consentirà di immettere impostazioni essenziali come le credenziali di accesso 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 }

Sostituisci i segnaposto con le tue chiavi API effettive e salva il file di configurazione. Quindi, aggiorna digitando /refreshnel riquadro AI Shell per applicare le modifiche.

Interagire con AI Shell è semplice: digita le tue query nel riquadro. Per indirizzare un comando a un agente specifico, usa la sintassi @<agentName>che precede la tua query, come @openai-gpt "How do I list files in a directory?".

Potenzia il tuo flusso di lavoro con i comandi AI Shell

AI Shell include una varietà di comandi integrati e scorciatoie da tastiera che possono migliorare la tua produttività:

Utilizzare il /code postcomando o Ctrl + D, Ctrl + Dla scorciatoia per inserire il codice generato nella sessione corrente di PowerShell.
Utilizza /code copyo Ctrl + D, Ctrl + Cper copiare i frammenti di codice generati negli appunti per un uso successivo.
Per spostarsi tra i riquadri di AI Shell e PowerShell, utilizzare Alt + RightArrowe Alt + LeftArrow.
Inviare messaggi di errore ad AI Shell per ricevere assistenza sull’utilizzo del Resolve-Errorcmdlet.
Per query complesse, utilizzare il Invoke-AIShellcomando per interagire con l’agente selezionato.
Digitare /helpper visualizzare tutti i comandi disponibili.

Il /code postcomando semplifica l’inserimento del codice da AI Shell nella tua sessione, mentre /code copyaiuta a salvare frammenti di codice per riferimento futuro. Con il Resolve-Errorcomando, puoi ricevere supporto in tempo reale per la risoluzione dei problemi direttamente tramite AI Shell.

Conclusione

AI Shell migliora l’interazione con i modelli AI tramite un’interfaccia a riga di comando, ideale sia per sviluppatori che per professionisti IT. Che tu scelga lo script di installazione automatizzato o che tu scelga di installarlo manualmente per un maggiore controllo, AI Shell semplifica l’esperienza di interazione AI. Sfrutta un’interfaccia intuitiva, comandi robusti e un’integrazione fluida per aumentare significativamente la produttività nelle attività quotidiane.

Ulteriori approfondimenti

1. Quali sono i requisiti di sistema per AI Shell?

AI Shell richiede Windows 10 o Windows 11 e PowerShell versione 7.4.6 o superiore. Assicurati di avere accesso amministrativo per l’installazione e la configurazione.

2. Posso usare AI Shell senza una connessione Internet?

AI Shell necessita di una connessione Internet per interagire con i modelli di intelligenza artificiale ospitati online, soprattutto quando si utilizza l’agente Azure OpenAI o si accede ad API pubbliche.

3. Come posso risolvere i problemi di installazione con AI Shell?

In caso di problemi, assicurarsi che PowerShell sia aggiornato, controllare attentamente la configurazione della variabile PATH e utilizzare il Resolve-Errorcomando per assistenza durante l’esecuzione.

Fonte e immagini