Kommentar
Åtkomst till den här sidan kräver auktorisering. Du kan prova att logga in eller ändra kataloger.
Åtkomst till den här sidan kräver auktorisering. Du kan prova att ändra kataloger.
Konfigurera utvecklingsmiljön så att den använder Microsoft Foundry SDK. Du behöver också Azure CLI för autentisering så att din kod kan komma åt dina användaruppgifter.
I den här artikeln installerar du språkkörningar, Azure CLI, Azure Developer CLI, Foundry VS Code-tillägget och Git.
Viktigt!
Den här artikeln beskriver endast allmänna krav , till exempel språkkörningar, globala verktyg och KONFIGURATION av VS Code och tillägg.
Den omfattar inte scenariospecifika steg som SDK-installation eller autentisering.
När din miljö är klar går du vidare till snabbstarten för vidare instruktioner.
Förutsättningar
-
Ett Azure konto med en aktiv prenumeration. Om du inte har ett skapar du ett fritt Azure konto, som innehåller en kostnadsfri utvärderingsprenumeration.
Ladda ned, installera och konfigurera Visual Studio Code eller valfri IDE. Mer information finns i Ladda ned Visual Studio Code.
För att skapa och hantera Foundry-resurser, en av följande Azure RBAC-roller
- Azure AI Project Manager (för att hantera Foundry-projekt)
- Ägare (för behörigheter på prenumerationsnivå). Ägaren är nödvändig för ytterligare rolltilldelningar som krävs för andra scenarier i Foundry. För att säkerställa att du avblockeras för alla scenarier i Foundry är ägaren den rolltilldelning som krävs.
Om du vill använda project men inte skapa nya resurser behöver du minst:
- Azure AI-användare för de projekt som du använder (minst privilegierad roll för utveckling)
Mer information om behörigheter för varje roll finns i Rollbaserad åtkomstkontroll för Microsoft Foundry.
Installera programmeringsspråket
I Visual Studio Code skapar du en ny mapp för din project. Öppna ett terminalfönster i mappen.
Skapa först en ny Python-miljö. Installera inte paket i din globala Python-installation. Använd alltid en virtuell miljö eller conda-miljö när du installerar Python-paket. Annars kan du avbryta den globala installationen av Python.
Installera Python om det behövs
Använd Python 3.10 eller senare, men minst Python 3.9 krävs. Om du inte har en lämplig version av Python installerad följer du anvisningarna i VS Code Python-självstudien för det enklaste sättet att installera Python på operativsystemet.
Skapa en virtuell miljö
Om du redan har Python 3.10 eller senare installerat skapar du en virtuell miljö med hjälp av följande kommandon:
När du aktiverar Python-miljön används Python-tolken i mappen för ditt program när du kör python eller pip från kommandoraden .venv .
Anmärkning
deactivate Använd kommandot för att avsluta den virtuella Python-miljön. Du kan återaktivera den senare när det behövs.
Installera Python-tillägget för Visual Studio Code
Python-tillägget för Visual Studio Code stöder Python med IntelliSense, felsökning, formatering, linting, kodnavigering, refaktorisering, variabelutforskaren, testutforskaren och miljöhantering.
Installera:
- Java Development Kit (JDK) 17 eller senare
- Vi rekommenderar Microsoft Build of OpenJDK, som är en kostnadsfri, Long-Term supportdistribution (LTS) av OpenJDK
Installera Visual Studio Code Extension Pack för Java
Tilläggspaketet för Java är en samling populära tillägg som kan hjälpa dig att skriva, testa och felsöka Java-program i Visual Studio Code.
Installera Node.js (version 18 eller senare rekommenderas).
Se till att du har de verktyg som behövs installerade för .NET utveckling.
Installera .NET SDK
Du behöver .NET SDK (Software Development Kit) för att skapa, skapa och köra .NET program. Vi rekommenderar att du installerar den senaste LTS-versionen (långsiktig support) eller en senare version om det krävs av din project.
Ladda ned .NET SDK från nedladdningssidan official .NET. Välj rätt installationsprogram för operativsystemet (Windows, Linux eller macOS).
Följ installationsanvisningarna för operativsystemet.
Kontrollera installationen genom att öppna en terminal eller kommandotolk och köra:
dotnet --versionSvaret ska vara den installerade SDK-versionen.
Installera C# Dev Kit för Visual Studio Code
Installera det officiella C#Dev Kit-tillägget för bästa C#-utveckling i VS Code:
- Öppna Visual Studio Code.
- Gå till vyn Tillägg (Ctrl+Skift+X eller Cmd+Skift+X).
- Sök efter C# Dev Kit.
- Installera tillägget som publicerats av Microsoft. Detta installerar även C#-bastillägget om du inte redan har det.
Skapa en ny .NET Project
Du kan skapa en ny .NET project med hjälp av terminalen som är integrerad i Visual Studio Code (Terminal > Ny terminal).
Om du till exempel vill skapa ett nytt konsolprogram:
# 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
Nu kan du öppna mappen MyConsoleApp i VS Code (File > Open Folder...) för att börja arbeta med C# project. VS Code, med tillägget C# Dev Kit, identifierar automatiskt project, vilket aktiverar funktioner som IntelliSense, felsökning och bygguppgifter.
Installera Azure CLI och logga in
Du installerar Azure CLI och loggar in från din lokala utvecklingsmiljö, så att du kan använda dina användarautentiseringsuppgifter för att anropa Azure OpenAI i Microsoft Foundry Models.
I de flesta fall kan du installera Azure CLI från terminalen med hjälp av följande kommando:
Du kan följa anvisningarna Så här installerar du Azure CLI om dessa kommandon inte fungerar för ditt specifika operativsystem eller installationsprogram.
När du har installerat Azure CLI loggar du in med kommandot az login och loggar in med webbläsaren:
az login
Du kan också logga in manuellt via webbläsaren med en enhetskod.
az login --use-device-code
Håll terminalen öppen för att köra skript när du har loggat in.
Installera Azure Developer CLI
AZURE Developer CLI (azd) är ett verktyg med öppen källkod som hjälper dig att konfigurera och distribuera appresurser på Azure. Den innehåller enkla kommandon för viktiga utvecklingsstadier, oavsett om du använder en terminal, IDE eller CI/CD-pipelines. Installera Azure Developer CLI för din plattform.
Många av AI-lösningsmallarna innehåller ett distributionsalternativ med hjälp av azd.
Installera Foundry VS Code-tillägget
Med Foundry-tillägget för Visual Studio Code kan du distribuera modeller, skapa AI-appar och arbeta med agenter direkt från VS Code-gränssnittet. Installera Foundry VS Code-tillägget.
Installera Git
Git krävs för att klona Foundry SDK-exempel. Om du inte har Git installerat följer du anvisningarna för din plattform och väljer ditt operativsystem.
Felsökning
| Problematik | Lösning / Beslut |
|---|---|
| Kommandot hittades inte efter installationen | Stäng och öppna terminalen igen, eller starta om VS Code, så PATH-ändringar börjar gälla. |
az login misslyckas med ett webbläsarfel |
Kör az login --use-device-code för att autentisera med hjälp av ett enhetskodflöde i stället. |
| Python hittades inte | Använd python3 i stället python för på macOS/Linux eller installera en version som stöds (3.9 eller senare). |
| Behörighet nekad under installationsprocessen | Undvik i macOS/Linux sudo pip install. Använd en virtuell miljö i stället. |