Preparación del entorno de desarrollo

Prepare el entorno de desarrollo para compilar con Microsoft Foundry. Necesita un lenguaje de programación compatible, Git y las herramientas de desarrollo de Foundry que se ajusten al flujo de trabajo.

Tip

Foundry DevPack es la manera recomendada de instalar las herramientas de desarrollo en un comando. También puede instalar cada herramienta por separado.

Importante

En este artículo se tratan los requisitos previos generales y las herramientas de desarrollo. No cubre paquetes de SDK específicos del escenario ni código de autenticación. Cuando el entorno esté listo, continúe con el inicio rápido.

Requisitos previos

Instalación de Foundry DevPack

Foundry DevPack instala las herramientas de desarrollo de Foundry para el terminal, el editor y el agente de codificación. Seleccione su sistema operativo.

winget install Microsoft.FoundryDevPack

DevPack instala sus herramientas principales y agrega extensiones de host solo cuando sus aplicaciones están presentes:

Herramienta Qué puede hacer
azd y azd ai Genere la estructura base, implemente, evalúe y automatice desde la terminal.
Habilidad de Microsoft Foundry Proporcione instrucciones reutilizables a los agentes de codificación para los flujos de trabajo de Foundry.
Microsoft Foundry Toolkit para Visual Studio Code Se instala solo cuando Visual Studio Code está presente. Compile, pruebe, evalúe e implemente desde el editor.
Foundry Canvas (versión preliminar) Se instala solo cuando GitHub Copilot App está instalada. Diseñe e implemente agentes hospedados desde un lienzo guiado.

DevPack no instala Visual Studio Code ni GitHub Copilot App.

Continúe con las secciones siguientes para configurar el lenguaje de programación e instalar Git.

Trabajar con un lenguaje de programación

Use el idioma que requiere la aplicación. Expanda una sección si necesita instalar su entorno de ejecución o extensión de Visual Studio Code.

Pitón

Instale Python 3.10 o posterior. Python 3.9 es la versión mínima admitida. Cree un entorno virtual para el proyecto en lugar de instalar paquetes globalmente.

Windows

py -3 -m venv .venv
.\.venv\Scripts\Activate.ps1

macOS y Linux

python3 -m venv .venv
source .venv/bin/activate

Para obtener compatibilidad con el editor, instale la extensión Python para Visual Studio Code.

Java

Instale JDK 17 o posterior. El Compilación de Microsoft de OpenJDK es una distribución gratuita con soporte a largo plazo. Para obtener compatibilidad con el editor, instale el paquete de extensiones de Visual Studio Code para Java.

JavaScript/TypeScript

Instale Node.js. Se recomienda la versión 20 o posterior.

C#

Instale la versión más reciente de soporte a largo plazo (LTS) del SDK de .NET. Para obtener compatibilidad con el editor, instale el Kit de desarrollo de C# para Visual Studio Code.

Instalación de Git

Para clonar ejemplos del SDK de Foundry, necesita Git. Si no tiene Git instalado, descargue e instálelo desde el sitio web de Git.

Instalación de herramientas de desarrollo por separado

Si no usa Foundry DevPack, seleccione una pestaña para instalar solo las herramientas que necesita.

  1. Instale la CLI para desarrolladores de Azure.

  2. Instale las extensiones de Foundry:

    azd ext install microsoft.foundry
    

Para instalar extensiones individuales en lugar del paquete completo, consulte Instalar las extensiones de Foundry de la CLI para desarrolladores de Azure.

Para la administración directa y granular de recursos de Azure individuales, use el CLI de Azure (az). Consulte CLI de Azure para desarrolladores frente a CLI de Azure.

Solución de problemas

Problema Resolución
Comando no encontrado después de la instalación Cierre y vuelva a abrir el terminal. Si usa Visual Studio Code, reinícielo para que los cambios de PATH surtan efecto.
no se encuentra Python Use python3 en lugar de python en macOS o Linux, o instale Python 3.9 o posterior.
Permiso denegado durante la instalación del paquete de Python En macOS o Linux, no use sudo pip install. En su lugar, use un entorno virtual.