AI Shell è uno strumento progettato per portare la potenza dell'intelligenza artificiale direttamente sulla tua interfaccia della riga di comando. Ti consente di interagire con vari modelli di intelligenza artificiale attraverso un'interfaccia conversazionale, fornendo aiuto con la sintassi dei comandi, la risoluzione degli errori e persino la generazione di codice. Questo articolo ti guida attraverso l'installazione e l'utilizzo di base di AI Shell su Windows.
AI Shell offre due modi principali per installarlo: utilizzando un comodo script di installazione o tramite l'installazione manuale. Per la maggior parte degli utenti, lo script di installazione rappresenta il percorso più semplice ed è pertanto l'approccio consigliato.
Aggiorna PowerShell alla versione più recente
È necessaria la versione 7.4.6 o successiva di PowerShell per poter installare AI Shell. Di seguito sono riportate le istruzioni per installare e aggiornare PowerShell sul tuo PC Windows 10 o Windows 11.
Passaggio 1: PremereWin + Xe selezionaWindows PowerShell (amministratore).
Passaggio 2: consente temporaneamente l'esecuzione degli script eseguendo:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass
Passaggio 3: eseguire i seguenti comandi:
Invoke-RestMethod -Uri "https://aka.ms/install-powershell.ps1" -OutFile "install-powershell.ps1"
.install-powershell.ps1
Passaggio 4: aggiungi PowerShell al PERCORSO del sistema:
- Premere
Win + R, tipoSystemPropertiesAdvancede premere Invio. - ClicVariabili d'ambiente.
- Nella sezione "Variabili di sistema", selezionaSentieroe fare clicModificare.
- ClicNuovoe aggiungi il seguente percorso:
C:Users<YourUsername>AppDataLocalMicrosoftpowershell
Sostituire<YourUsername>con il tuo nome utente Windows.
- ClicOKper salvare le modifiche e chiudere tutte le finestre di dialogo.
Passaggio 5: Dopo l'installazione, apri la nuova versione di PowerShell utilizzando:
pwsh
Passaggio 6: Verificare la versione installata con:
$PSVersionTable
Passaggio 7 (facoltativo): Ripristina la policy di esecuzione predefinita, se necessario:
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted
Questo processo garantisce che PowerShell venga aggiornato alla versione 7.4.6 o successiva e sia accessibile a livello globale.
Installazione di AI Shell utilizzando lo script di installazione
Lo script di installazione semplifica il processo di installazione sia dell'eseguibile AI Shell che del modulo PowerShell. Questo metodo configura automaticamente i percorsi necessari e installa il modulo AI Shell.
Passaggio 1:Apri Terminale come amministratore. Puoi farlo premendo il tastoWinchiave, digitando "Terminale", facendo clic con il tasto destro su "Terminale" e selezionando "Esegui come amministratore".
Passaggio 2:Se Terminale non si apre con PowerShell per impostazione predefinita, fai clic sull'icona del menu a discesa nella barra delle schede e seleziona "Windows PowerShell".
Passaggio 3:Esegui il comando seguente per utilizzare PowerShell v7.4.6 (o versione successiva) installato in precedenza.
pwshPassaggio 4:Esegui lo script di installazione. Copia e incolla il seguente comando nella finestra di PowerShell e premiEnter:
Invoke-Expression "& { $(Invoke-RestMethod 'https://aka.ms/install-aishell.ps1') }"Questo script viene scaricato e installatoaish.exeA$env:LOCALAPPDATAProgramsAIShell, lo aggiunge alla variabile di ambiente PATH e installa il fileAIShellmodule nel percorso del modulo. Questo processo ti consentirà di eseguire AI Shell dalla riga di comando o direttamente da PowerShell.
Passaggio 5:Al termine dell'installazione, è possibile avviare AI Shell utilizzando il comandoStart-AIShellnella finestra di PowerShell. Questo comando aprirà un riquadro diviso nel terminale di Windows, con AI Shell in esecuzione nel riquadro di destra. Ti verrà richiesto di scegliere un agente AI, la selezione iniziale verrà effettuata tramite un prompt dopo l'esecuzioneStart-AIShellcomando.
Installazione manuale di AI Shell
Se non puoi utilizzare lo script di installazione o preferisci il controllo manuale, puoi seguire questi passaggi per installare AI Shell. Questo metodo prevede il download dei file necessari, la loro estrazione e l'aggiunta della loro posizione alla variabile PATH del sistema.
Passaggio 1:Scarica l'ultima versione di AI Shell per Windows. Visita la fonte ufficiale, scarica il file ZIP appropriato che corrisponde all'architettura del tuo sistema comeAIShell-1.0.0-preview.1-win-x64.zip.
Passaggio 2:Estrai il file ZIP scaricato in una posizione adatta sul tuo sistema comeC:AIShell. Questa cartella conterrà il fileaish.exeeseguibile.
Passaggio 3:Aggiungi la cartella estratta alla variabile d'ambiente PATH del tuo sistema. Questo ti permette di correreaish.exeda qualsiasi prompt dei comandi.
Per fare ciò, cerca "variabili di ambiente" nella barra di ricerca di Windows, fai clic su "Modifica le variabili di ambiente di sistema", quindi seleziona "Variabili di ambiente". In "Variabili di sistema", seleziona "Percorso", fai clic su "Modifica", fai clic su "Nuovo" e aggiungi il percorso completo alla cartella estratta (ad esempio,C:AIShell), quindi salvarlo.
Passaggio 4:Installa ilAIShellModulo PowerShell. Apri Terminale come amministratore ed esegui il comando seguente nella scheda Windows PowerShell in Terminale:
Install-PSResource -Name AIShellQuesto comando scarica e installa il modulo AI Shell da PowerShell Gallery, fornendo una perfetta integrazione con l'ambiente PowerShell.
Configurazione e utilizzo di AI Shell
Una volta installata AI Shell, dovrai configurare l'agente AI che desideri utilizzare. Per impostazione predefinita, AI Shell offre due agenti: Azure OpenAI Agent e Copilot in Azure. L'agente Azure OpenAI richiede una configurazione aggiuntiva che prevede la fornitura dell'endpoint, delle chiavi API e potenzialmente di un prompt di sistema, che fonda il modello di intelligenza artificiale per casi d'uso specifici. L'agente Copilot in Azure è progettato per attività specifiche di Azure e richiede l'accesso ad Azure.
Seleziona un agente dal pannello a destra per configurarlo.
Per configurare un agente, eseguire il comando/agent confignel riquadro AI Shell.
Si aprirà un file di configurazione JSON in cui potrai aggiungere le tue impostazioni, incluse le chiavi API o altre credenziali di accesso.
Ad esempio, se stai configurando il modello openai-gpt, incolla il contenuto del blocco di codice riportato di seguito nel file di configurazione, sostituisci<your-openai-api-key-here>con la tua chiave API e salva il file di configurazione:
Altre letture:Scarica e installa Windows Media Center per Windows 11
{
// Declare GPT instances.
"GPTs": [
/* --- uncomment the examples below and update as appropriate ---
//
// To use the Azure OpenAI service:
// - Set `Endpoint` to the endpoint of your Azure OpenAI service,
// or the endpoint to the Azure API Management service if you are using it as a gateway.
// - Set `Deployment` to the deployment name of your Azure OpenAI service.
// - Set `ModelName` to the name of the model used for your deployment, e.g. "gpt-4-0613".
// - Set `Key` to the access key of your Azure OpenAI service,
// or the key of the Azure API Management service if you are using it as a gateway.
// For example:
{
"Name": "ps-az-gpt4",
"Description": "A GPT instance with expertise in PowerShell scripting and command line utilities. Use gpt-4 running in Azure.",
"Endpoint": "<insert your Azure OpenAI endpoint>",
"Deployment": "<insert your deployment name>",
"ModelName": "<insert the model name>", // required field to infer properties of the service, such as token limit.
"Key": "<insert your key>",
"SystemPrompt": "1. You are a helpful and friendly assistant with expertise in PowerShell scripting and command line.n2. Assume user is using the operating system `win` unless otherwise specified.n3. Use the `code block` syntax in markdown to encapsulate any part in responses that is code, YAML, JSON or XML, but not table.n4. When encapsulating command line code, use '```powershell' if it's PowerShell command; use '```sh' if it's non-PowerShell CLI command.n5. When generating CLI commands, never ever break a command into multiple lines. Instead, always list all parameters and arguments of the command on the same line.n6. Please keep the response concise but to the point. Do not overexplain."
},
// To use the public OpenAI service:
// - Ignore the `Endpoint` and `Deployment` keys.
// - Set `ModelName` to the name of the model to be used.
// - Set `Key` to be the OpenAI access token.
// For example:*/
{
"Name": "ps-gpt4o",
"Description": "A GPT instance with expertise in PowerShell scripting and command line utilities. Use gpt-4o running in OpenAI.",
"ModelName": "gpt-4o",
"Key": "<your-openai-api-key-here>",
"SystemPrompt": "1. You are a helpful and friendly assistant with expertise in PowerShell scripting and command line.n2. Assume user is using the operating system `Windows 11` unless otherwise specified.n3. Use the `code block` syntax in markdown to encapsulate any part in responses that is code, YAML, JSON or XML, but not table.n4. When encapsulating command line code, use '```powershell' if it's PowerShell command; use '```sh' if it's non-PowerShell CLI command.n5. When generating CLI commands, never ever break a command into multiple lines. Instead, always list all parameters and arguments of the command on the same line.n6. Please keep the response concise but to the point. Do not overexplain."
}
],
// Specify the default GPT instance to use for user query.
// For example: "ps-az-gpt4"
"Active": null
}Quindi, digita/refreshnel riquadro AI Shell per applicare le modifiche.
Puoi interagire con AI Shell digitando domande o comandi nel riquadro AI Shell. Per indirizzare un comando a un agente specifico, utilizzare la sintassi@<agentName>seguito dalla tua domanda. Ad esempio,@openai-gpt "How do I list files in a directory?"invierà la domanda all'agente Azure OpenAI. La selezione iniziale dell'agente verrà effettuata dal prompt quando si esegue il comandoStart-AIShell.
AI Shell offre diversi comandi integrati e scorciatoie da tastiera per accelerare il flusso di lavoro:
- Usa il
/code postcomando o ilCtrl+d, Ctrl+dscorciatoia da tastiera per inserire il codice generato nella sessione di PowerShell. - Usa il
/code copycomando oCtrl+d, Ctrl+cper copiare il codice generato negli appunti.Ctrl+<n>copierà lo snippet di codice _n-esimo_. - Utilizzo
Alt+RightArrowEAlt+LeftArrowper spostare il cursore tra i riquadri AI Shell e PowerShell. - Usa il
Resolve-Errorcmdlet per inviare messaggi di errore ad AI Shell per assistenza. - Usa il
Invoke-AIShellcmdlet per inviare query all'agente attualmente selezionato nella finestra AI Shell aperta. Questo comando consente inoltre di passare l'output del comando attraverso la pipeline nell'agente AI per ulteriore contesto. - Tipo
/helpper visualizzare un elenco di tutti i comandi disponibili.
Utilizzando il/code postcomando, il codice generato da AI Shell può essere facilmente pubblicato nella sessione di PowerShell. Se è necessario copiare tutti o alcuni frammenti di codice dalla shell AI per un utilizzo successivo, il file/code copyIl comando è utile per copiare il codice generato negli appunti per un uso successivo.
Se riscontri un errore nel tuo terminale funzionante, puoi utilizzare il fileResolve-Errorcomando per inviare l'errore alla finestra AI Shell per assistenza.
AI ShellInvoke-AIShellIl comando consente di inviare query all'agente attualmente selezionato. Questo può essere fatto con o senza codice.
AI Shell può essere installata utilizzando un semplice script o manualmente, ciascun metodo soddisfa le diverse preferenze dell'utente. Lo script è più intuitivo e automatizza diversi passaggi, rendendo più semplice il processo complessivo, mentre l'installazione manuale consente un maggiore controllo su configurazioni specifiche. Con la sua interfaccia intuitiva e un robusto set di comandi, AI Shell è un'ottima aggiunta per chiunque desideri aumentare la propria produttività.
