Uw ontwikkelomgeving voorbereiden

Bereid uw ontwikkelomgeving voor om te bouwen met de Microsoft Foundry. U hebt een ondersteunde programmeertaal nodig, de Azure CLI voor hulpprogramma's voor verificatie, Git en Foundry voor ontwikkelaars.

Tip

Foundry DevPack is de aanbevolen manier om de ontwikkelhulpprogramma's in één opdracht te installeren. U kunt elk hulpprogramma ook afzonderlijk installeren.

Belangrijk

In dit artikel worden algemene vereisten, algemene hulpprogramma's en Visual Studio Code setup behandeld. Het gaat niet om scenariospecifieke SDK-pakketten of verificatiecode. Wanneer uw omgeving gereed is, gaat u verder met de quickstart.

Voorwaarden

  • Een Azure-account met een actief abonnement. Als u nog geen account hebt, maakt u een vrij Azure-account, inclusief een gratis proefabonnement.

  • Download, installeer en configureer Visual Studio Code of gebruik de IDE van uw keuze.

  • Als u Foundry-resources wilt maken en beheren, gebruikt u een van deze Azure RBAC-rollen:

    • Foundry Project Manager voor het beheren van Foundry-projecten.

    Belangrijk

    De rollen Foundry RBAC zijn onlangs hernoemd. Foundry User, Foundry Owner, Foundry Account Owner en Foundry Project Manager zijn eerder benoemd Azure AI-gebruiker, Azure AI-eigenaar Azure AI-accounteigenaar en Azure AI Project Manager. Het kan zijn dat u op sommige plekken nog steeds de vorige namen ziet terwijl de naamswijziging wordt doorgevoerd. De rol-id's en basismachtigingen worden niet gewijzigd door de naamswijziging.

    • Owner voor machtigingen op abonnementsniveau en roltoewijzingen die in sommige scenario's vereist zijn.

  • Als u een bestaand project wilt gebruiken zonder resources te maken, hebt u ten minste Foundry User in het project nodig.

Zie Op rollen gebaseerd toegangsbeheer voor Microsoft Foundry voor meer informatie over elke rol.

Foundry DevPack installeren

Foundry DevPack installeert de Foundry-ontwikkelhulpprogramma's voor uw editor, terminal en coderingsagent. Voer de opdracht voor uw besturingssysteem uit.

Windows

winget install Microsoft.FoundryDevPack

macOS

brew install --cask microsoft/foundry/devpack && foundry-devpack install

Linux

curl -fsSL https://aka.ms/foundry-devpack-install.sh | bash

DevPack installeert deze hulpprogramma's:

Tool Wat kunt u doen
Microsoft Foundry Toolkit voor Visual Studio Code Bouwen, testen, evalueren en implementeren vanuit Visual Studio Code.
azd en azd ai Genereer, implementeer, evalueer en automatiseer vanuit de terminal.
Foundry Canvas (preview) Ontwerp en implementeer gehoste agents met een begeleide Copilot canvas.
Microsoft Foundry Skill Geef codeeragents herbruikbare richtlijnen voor Foundry-workflows.

Ga verder met de volgende secties om uw programmeertaal in te stellen, meld u aan met de Azure CLI en installeer Git.

Werken met een programmeertaal

Gebruik de taal die uw toepassing nodig heeft. Vouw een sectie uit als u de runtime of Visual Studio Code-extensie wilt installeren.

Python

Installeer Python 3.10 of hoger. Python 3.9 is de minimaal ondersteunde versie. Maak een virtuele omgeving voor uw project in plaats van pakketten wereldwijd te installeren.

Windows

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

macOS en Linux

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

Installeer de Python-extensie voor Visual Studio Code voor editorondersteuning.

Java

Installeer JDK 17 of hoger. De Microsoft Build van OpenJDK is een gratis distributie met langdurige ondersteuning. Installeer voor editorondersteuning het Visual Studio Code Extension Pack voor Java.

JavaScript/TypeScript

Installeer Node.js. Versie 20 of hoger wordt aanbevolen.

C#

Installeer de nieuwste Long-Term-ondersteuningsversie van de .NET SDK. Installeer C# Dev Kit voor Visual Studio Code voor ondersteuning voor de editor.

De Azure CLI installeren en u aanmelden

U installeert de Azure CLI en meldt u aan vanuit uw lokale ontwikkelomgeving, zodat uw code uw gebruikersreferenties kan gebruiken om Azure services aan te roepen via Foundry.

In de meeste gevallen kunt u Azure CLI installeren vanuit uw terminal met behulp van de volgende opdracht:

winget install -e --id Microsoft.AzureCLI

U kunt instructies volgen Hoe u de Azure CLI installeert als deze opdrachten niet werken voor uw specifieke besturingssysteem of installatie.

Nadat u de Azure CLI hebt geïnstalleerd, meldt u zich aan met de opdracht az login en meldt u zich aan met behulp van de browser:

az login

U kunt zich ook handmatig aanmelden via de browser met een apparaatcode.

az login --use-device-code

Houd deze terminal geopend om scripts uit te voeren nadat u zich hebt aangemeld.

Git installeren

Als u Foundry SDK-voorbeelden wilt klonen, hebt u Git nodig. Als u Git niet hebt geïnstalleerd, downloadt en installeert u deze vanaf de Git-website.

Ontwikkelhulpprogramma's afzonderlijk installeren

Als u Foundry DevPack niet gebruikt, installeert u elk hulpprogramma voor ontwikkelaars afzonderlijk:

  1. Installeer de Azure Developer CLI.
  2. Installeer alle Foundry-extensies voor azd: 
    azd ext install microsoft.foundry
    Als u in plaats daarvan afzonderlijke extensies wilt installeren, raadpleegt u De Azure Developer CLI Foundry-extensies installeren.
  3. Installeer de editor en de hulpprogramma's voor de codeeragent:

Veel AI-oplossingssjablonen ondersteunen implementatie met azd.

Probleemoplossing

Probleem Resolutie
De opdracht is niet gevonden na de installatie Sluit de terminal en open deze opnieuw of start Visual Studio Code opnieuw, zodat DE WIJZIGINGEN in PATH van kracht worden.
az login mislukt met een browserfout Voer az login --use-device-code uit om te verifiëren met een apparaatcode.
Python is niet gevonden Gebruik python3 in plaats van python macOS of Linux of installeer Python 3.9 of hoger.
Machtiging geweigerd tijdens Python pakketinstallatie Gebruik niet sudo pip installin macOS of Linux. Gebruik in plaats daarvan een virtuele omgeving.

Verwante inhoud

  • Last updated on