Compartir a través de

Preparación del entorno de desarrollo (clásico)

Nota:

Este documento hace referencia al portal de Microsoft Foundry (clásico).

🔍 Consulte la documentación de Microsoft Foundry (nuevo) para obtener información sobre el nuevo portal.

Configure el entorno de desarrollo para usar el SDK de Microsoft Foundry. También necesita Azure CLI para la autenticación, de modo que el código pueda acceder a las credenciales de usuario.

En este artículo, instalará entornos de ejecución de lenguaje, Azure CLI, Azure CLI para desarrolladores, la extensión Foundry VS Code y Git.

Importante

En este artículo solo se tratan los requisitos previos generales , como los entornos de ejecución de lenguaje, las herramientas globales y la configuración de extensiones y VS Code.
No abarca los pasos específicos del escenario, como la instalación del SDK o la autenticación.
Cuando el entorno esté listo, continúe con el inicio rápido para esas instrucciones.

Prerrequisitos

  • Una cuenta de Azure con una suscripción activa. Si no tiene una, cree una cuenta de free Azure, que incluye una suscripción de evaluación gratuita.

  • Descargue, instale y configure Visual Studio Code o el IDE que prefiera. Para obtener más información, vea Download Visual Studio Code.

  • Para crear y administrar recursos de Foundry, es necesario uno de los siguientes roles de RBAC de Azure

    • Azure AI Project Manager (para administrar proyectos de Foundry)
    • Propietario (para permisos de nivel de suscripción). El propietario es necesario para las asignaciones de roles adicionales necesarias para otros escenarios de Foundry. Para asegurarse de que está desbloqueado para todos los escenarios de Foundry, "Propietario" es la asignación de rol necesaria.

  • Para usar el proyecto pero no crear nuevos recursos, necesita al menos:

    • Usuario de Azure AI en los proyectos que utilizas (rol de mínimos privilegios para el desarrollo)

    Para obtener más información sobre los permisos de cada rol, consulte Role-based access control for Microsoft Foundry.

Instalación del lenguaje de programación

En Visual Studio Code, cree una nueva carpeta para tu proyecto. Abra una ventana de terminal en esa carpeta.

En primer lugar, cree un nuevo entorno de Python. No instale paquetes en la instalación global de Python. Use siempre un entorno virtual o conda al instalar paquetes de Python. De lo contrario, puede interrumpir la instalación global de Python.

Si es necesario, instale Python.

Use Python 3.10 o posterior, pero se requiere al menos Python 3.9. Si no tiene instalada una versión adecuada de Python, siga las instrucciones del Tutorial de Python de VS Code para obtener la manera más fácil de instalar Python en el sistema operativo.

Creación de un entorno virtual

Si ya tiene Instalado Python 3.10 o superior, cree un entorno virtual mediante los siguientes comandos:

py -3 -m venv .venv
.venv\scripts\activate

Al activar el entorno de Python, ejecutar python o pip desde la línea de comandos usa el intérprete de Python en la carpeta .venv de tu aplicación.

Nota:

Use el deactivate comando para salir del entorno virtual de Python. Puede reactivarlo más adelante cuando sea necesario.

Instalación de la extensión de Python para Visual Studio Code

La extensión de Python para Visual Studio Code admite Python con IntelliSense, depuración, formato, linting, navegación de código, refactorización, explorador de variables, explorador de pruebas y administración del entorno.

Instalar la extensión de Python para Visual Studio Code.

Instalar:

  • Kit de desarrollo de Java (JDK) 17 o posterior

Instalación del paquete de extensiones de código Visual Studio para Java

El Paquete de extensiones para Java es una colección de extensiones populares que pueden ayudarle a escribir, probar y depurar aplicaciones Java en Visual Studio Código.

Instale el paquete de extensiones de código Visual Studio para Java.

Instale Node.js (se recomienda la versión 18 o posterior).

Asegúrese de que tiene instaladas las herramientas necesarias para .NET desarrollo.

Instalación del SDK de .NET

Necesita el SDK de .NET (Kit de desarrollo de software) para crear, compilar y ejecutar aplicaciones .NET. Recomendamos instalar la última versión de LTS (Soporte a Largo Plazo) o una versión posterior si lo requiere tu proyecto.

  1. Descargue el SDK de .NET de la página oficial de descargas de .NET. Seleccione el instalador adecuado para el sistema operativo (Windows, Linux o macOS).

  2. Siga las instrucciones de instalación del sistema operativo.

  3. Para comprobar la instalación, abra un terminal o símbolo del sistema, y ejecute:

    dotnet --version

    La respuesta debe ser la versión del SDK instalada.

Instalación del Kit de desarrollo de C# para Visual Studio Code

Para obtener la mejor experiencia de desarrollo de C# en VS Code, instale la extensión oficial del Kit de desarrollo de C#:

  1. Abre Visual Studio Code.
  2. Vaya a la vista Extensiones (Ctrl+Mayús+X o Cmd+Mayús+X).
  3. Busque Kit de desarrollo de C#.
  4. Instale la extensión publicada por Microsoft. Esto también instalará la extensión de C# base si aún no la tiene.

Crear un nuevo .NET Project

Puede crear un nuevo .NET project mediante el terminal integrado en Visual Studio Code (Terminal > Nuevo terminal).

Por ejemplo, para crear una nueva aplicación de consola:

# Navigate to the directory where you want to create your project
# cd path/to/your/projects

# Create a new console application in a subfolder named MyConsoleApp
dotnet new console -o MyConsoleApp

# Navigate into the newly created project folder
cd MyConsoleApp

Ahora puede abrir esta carpeta MyConsoleApp en VS Code (Archivo > Abrir Carpeta...) para empezar a trabajar en el proyecto de C#. VS Code, con la extensión C# Dev Kit, detectará automáticamente el proyecto, permitiendo características como IntelliSense, depuración y tareas de compilación.

Instalación del Azure CLI e inicio de sesión

Instale el Azure CLI e inicie sesión desde el entorno de desarrollo local para que pueda usar las credenciales de usuario para llamar a Azure OpenAI en Microsoft Foundry Models.

En la mayoría de los casos, puede instalar Azure CLI desde el terminal mediante el siguiente comando:

winget install -e --id Microsoft.AzureCLI

Puede seguir las instrucciones Cómo instalar la CLI de Azure si estos comandos no funcionan para su sistema operativo o configuración particular.

Después de instalar el Azure CLI, inicie sesión con el comando /> / 

az login

Como alternativa, puede iniciar sesión manualmente a través del explorador con un código de dispositivo.

az login --use-device-code

Mantenga este terminal abierto para ejecutar scripts después de iniciar sesión.

Instalación de la CLI para desarrolladores de Azure

La CLI de Azure Developer (azd) es una herramienta de código abierto que le ayuda a configurar e implementar recursos de aplicación en Azure. Proporciona comandos sencillos para las fases clave del desarrollo, tanto si se usa un terminal, IDE o pipelines de CI/CD. Instalar la CLI de Azure Developer para la plataforma.

Muchas de las plantillas de solución de IA incluyen una opción de implementación mediante azd.

Instalación de la extensión Foundry para VS Code

La extensión Foundry para Visual Studio Code le permite implementar modelos, compilar aplicaciones de IA y trabajar con agentes directamente desde la interfaz de VS Code. Instale la extensión Foundry VS Code.

Instalación de Git

Git es necesario para clonar ejemplos del SDK de Foundry. Si no tiene Git instalado, siga las instrucciones de la plataforma y seleccione el sistema operativo.

Solución de problemas

Cuestión Resolución
Comando no encontrado después de la instalación Cierre y vuelva a abrir el terminal, o reinicie VS Code, por lo que los cambios path surten efecto.
az login falla con un error del navegador Ejecute az login --use-device-code para autenticarse mediante un flujo de código de dispositivo en su lugar.
No se encontró Python Use python3 en lugar de python en macOS/Linux o instale una versión compatible (3.9 o posterior).
Permiso denegado durante la instalación En macOS/Linux, evite sudo pip install. En su lugar, use un entorno virtual .

Contenido relacionado

  • Documentación de referencia del SDK de .NET
  • Last updated on