Guía paso a paso para instalar y utilizar AI Shell en Windows

Cómo dominar la instalación y el uso de AI Shell en Windows

AI Shell permite a los usuarios integrar funciones avanzadas de inteligencia artificial directamente en la interfaz de línea de comandos (CLI). Esta herramienta ofrece un entorno conversacional para interactuar con varios modelos de IA, lo que mejora la productividad mediante una sintaxis de comandos sencilla, resolución de errores e incluso generación de código. Esta guía completa le guiará paso a paso a través de la instalación y el uso eficaz de AI Shell en su sistema Windows.

Requisitos previos para instalar AI Shell

Antes de comenzar la instalación, asegúrese de tener:

Sistema operativo Windows 10 o Windows 11.
Versión 7.4.6 o superior de PowerShell instalada en su sistema.
Acceso administrativo para instalar software y modificar variables de entorno.

Tener estos requisitos previos garantiza un proceso de instalación más fluido y minimiza posibles problemas.

Actualización de PowerShell a la última versión

Para instalar correctamente AI Shell, debe tener PowerShell actualizado a la versión 7.4.6 o superior. Siga estos pasos para realizar una actualización sin problemas:

Presione Win + Xy seleccione Windows PowerShell (Administrador) .
Permitir que los scripts se ejecuten temporalmente ejecutando:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

Ejecute los siguientes comandos para descargar e instalar la última versión de PowerShell:

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

Agregue PowerShell a su sistema RUTA:

Presione Win + R, escriba SystemPropertiesAdvancedy presione Enter.
Haga clic en Variables de entorno .
En la sección Variables del sistema , busque Ruta y seleccione Editar .
Haga clic en Nuevo y agregue la ruta:
C:\Users\\AppData\Local\Microsoft\powershell

Recuerde reemplazarlo <YourUsername>con su nombre de usuario real de Windows.

Haga clic en Aceptar para guardar los cambios.

Abra la nueva versión de PowerShell usando:

pwsh

Verifique su instalación ejecutando:

$PSVersionTable

Verificación de la versión de PowerShell

(Opcional) Restaure la política de ejecución predeterminada si es necesario:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Restricted

Seguir estos pasos garantiza que PowerShell esté actualizado al menos a la versión 7.4.6 y sea accesible globalmente, lo que prepara el escenario para una instalación exitosa de AI Shell.

Instalación de AI Shell mediante el script de instalación

El método más rápido para instalar AI Shell es mediante un script de instalación automatizado que configura todo por ti. A continuación, te indicamos cómo hacerlo:

Abra la Terminal como administrador presionando la Wintecla , escribiendo “Terminal”, haciendo clic derecho en “Terminal” y eligiendo “Ejecutar como administrador”.
Si la Terminal no se abre con PowerShell de forma predeterminada, seleccione “Windows PowerShell” en el menú desplegable de la barra de pestañas.
Inicie la instancia de PowerShell actualizada ingresando lo siguiente:

pwsh

Ejecute el script de instalación con el siguiente comando:

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

Este comando aish.exelo descarga $env:LOCALAPPDATA\Programs\AIShelly lo agrega a la RUTA de su sistema, lo que permite el acceso desde cualquier símbolo del sistema.

Después de la instalación, inicie AI Shell ingresando el comando Start-AIShellen PowerShell. Esto abrirá un panel dividido en Windows Terminal con AI Shell listo para usar. Se le solicitará que seleccione un agente de IA tan pronto como lo inicie.

Instalación manual de AI Shell

Para quienes prefieren un método de instalación práctico, pueden instalar AI Shell manualmente. A continuación, se muestra un método paso a paso:

Descargue el último archivo ZIP de AI Shell de la fuente oficial que coincida con la arquitectura de su sistema (por ejemplo, AIShell-1.0.0-preview.1-win-x64.zip).
Extraiga el archivo ZIP a una carpeta designada en su sistema, como C:\AIShell.
Agregue la carpeta a la variable PATH de su sistema, lo que le permitirá ejecutarla aish.exeglobalmente.

Para ello, busque “variables de entorno” en la Búsqueda de Windows, seleccione “Editar las variables de entorno del sistema” y abra “Variables de entorno”. En el área Variables del sistema , busque y edite Ruta , agregando la ruta completa a la carpeta extraída (por ejemplo, C:\AIShell).

Abra PowerShell como administrador e instale el módulo AI Shell PowerShell ejecutando:

Install-PSResource -Name AIShell

Este comando recupera e instala el módulo requerido de la Galería de PowerShell, lo que permite una integración perfecta en su entorno CLI.

Configuración y uso de AI Shell

Una vez que se instala AI Shell, el siguiente paso es configurarlo para el agente de IA elegido. De forma predeterminada, AI Shell proporciona dos agentes: Azure OpenAI Agent y Copilot en Azure. El agente de Azure OpenAI requiere una configuración adicional, ya que se debe proporcionar el punto de conexión, las claves de API y, posiblemente, un mensaje del sistema para adaptar el modelo de IA a sus necesidades específicas. El agente de Copilot en Azure se centra en las tareas relacionadas con Azure, por lo que es necesario que inicie sesión en Azure para usarlo.

Seleccione un agente del panel de configuración para iniciar el proceso de configuración.

Configure el agente seleccionado ejecutando el comando /agent configen el panel AI Shell. Se abrirá un archivo de configuración en formato JSON, que le permitirá ingresar configuraciones esenciales, como credenciales de acceso a la 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 }

Reemplace los marcadores de posición con sus claves API reales y guarde el archivo de configuración. Luego, actualice escribiendo /refreshen el panel AI Shell para aplicar los cambios.

Interactuar con AI Shell es sencillo: escriba sus consultas en el panel. Para dirigir un comando a un agente específico, utilice la sintaxis @<agentName>que precede a su consulta, como @openai-gpt "How do I list files in a directory?".

Cómo mejorar su flujo de trabajo con comandos de AI Shell

AI Shell incluye una variedad de comandos integrados y atajos de teclado que pueden mejorar su productividad:

Utilice el /code postcomando o Ctrl + D, Ctrl + Dacceso directo para insertar el código generado en la sesión actual de PowerShell.
Utilice /code copyo Ctrl + D, Ctrl + Ccopie fragmentos de código generados en su portapapeles para usarlos más adelante.
Navegue entre los paneles de AI Shell y PowerShell con Alt + RightArrowy Alt + LeftArrow.
Envía mensajes de error a AI Shell para obtener ayuda usando el Resolve-Errorcmdlet.
Para consultas complejas, aproveche el Invoke-AIShellcomando para interactuar con el agente seleccionado.
Escriba /helppara mostrar todos los comandos disponibles.

El /code postcomando simplifica la publicación de código desde AI Shell en su sesión y, al mismo tiempo, /code copyayuda a guardar fragmentos de código para futuras referencias. Con el Resolve-Errorcomando, puede recibir asistencia en tiempo real para solucionar problemas directamente a través de AI Shell.

Conclusión

AI Shell mejora la interacción con los modelos de IA mediante una interfaz de línea de comandos, ideal tanto para desarrolladores como para profesionales de TI. Ya sea que opte por el script de instalación automatizado o elija instalarlo manualmente para tener más control, AI Shell simplifica la experiencia de interacción con IA. Aprovecha una interfaz intuitiva, comandos sólidos y una integración perfecta para aumentar significativamente la productividad en las tareas diarias.

Información adicional

1. ¿Cuáles son los requisitos del sistema para AI Shell?

AI Shell requiere Windows 10 o Windows 11 y PowerShell versión 7.4.6 o superior. Asegúrese de tener acceso administrativo para la instalación y configuración.

2. ¿Puedo usar AI Shell sin una conexión a Internet?

AI Shell requiere una conexión a Internet para interactuar con los modelos de IA alojados en línea, especialmente cuando se usa el agente de Azure OpenAI o se accede a API públicas.

3. ¿Cómo puedo solucionar problemas de instalación con AI Shell?

Si encuentra problemas, asegúrese de que su PowerShell esté actualizado, vuelva a verificar la configuración de la variable PATH y use el Resolve-Errorcomando para obtener ayuda durante el tiempo de ejecución.

Fuente e imágenes