Aan de slag met Azure AI Studio-projecten in VS Code (preview)

Belangrijk

Sommige van de functies die in dit artikel worden beschreven, zijn mogelijk alleen beschikbaar in de preview-versie. Deze preview wordt aangeboden zonder een service level agreement en we raden deze niet aan voor productieworkloads. Misschien worden bepaalde functies niet ondersteund of zijn de mogelijkheden ervan beperkt. Zie Aanvullende gebruiksvoorwaarden voor Microsoft Azure-previews voor meer informatie.

Azure AI Studio biedt ondersteuning voor ontwikkelen in VS Code - Desktop en Web. In elk scenario is uw VS Code-exemplaar extern verbonden met een vooraf gemaakte aangepaste container die wordt uitgevoerd op een virtuele machine, ook wel een rekenproces genoemd.

VS Code starten vanuit Azure AI Studio

1. Ga naar Azure AI Studio.

2. Open uw project in Azure AI Studio.

3. Selecteer Code in het linkermenu.

4. Selecteer voor Compute een bestaand rekenproces of maak een nieuw rekenproces.

   • Selecteer een rekenproces dat u wilt gebruiken. Als het is gestopt, selecteert u Rekenproces starten en wacht u totdat deze overschakelt naar Actief. U ziet de status Gereed wanneer de berekening gereed is voor gebruik.
   • Als u geen rekenproces hebt, voert u een naam in en selecteert u Compute maken. Wacht totdat het rekenproces gereed is.

5. Voor VS Code-container selecteert u Container instellen zodra de knop is ingeschakeld. Hiermee configureert u de container op de berekening. Het instellen van de container kan enkele minuten duren. Zodra u de container voor het eerst hebt ingesteld, kunt u de volgende keren rechtstreeks starten. Mogelijk moet u uw rekenproces verifiëren wanneer hierom wordt gevraagd. Wanneer de installatie is voltooid, ziet u Gereed.

   Waarschuwing

   Zelfs als u inactief afsluiten inschakelt voor uw rekenproces, vindt niet-actief afsluiten plaats voor berekeningen die zijn ingesteld met deze aangepaste VS Code-container. Dit is om ervoor te zorgen dat de berekening niet onverwacht wordt afgesloten terwijl u in een container werkt.

6. Open het project in VS Code:

   • Als u wilt werken in uw lokale VS Code-exemplaar, kiest u Starten in VS Code (Desktop). Er wordt een nieuw lokaal exemplaar van VS Code geopend op uw lokale computer.
   • Als u in plaats daarvan in de browser wilt werken, selecteert u de vervolgkeuzepijl en kiest u Starten in VS Code (web). Er wordt een nieuw browsertabblad geopend dat is verbonden met vscode.dev .

   

De structuur van de aangepaste containermap

Onze vooraf gebouwde ontwikkelomgevingen zijn gebaseerd op een Docker-container met Azure AI SDK's, de promptstroom-SDK en andere hulpprogramma's. De omgeving is geconfigureerd om VS Code extern in de container uit te voeren. De container wordt op een vergelijkbare manier gedefinieerd als deze Dockerfile en is gebaseerd op de Python 3.10 Development Container Image van Microsoft.

Uw verkenner wordt geopend voor de specifieke projectmap die u hebt gestart in AI Studio.

De container is geconfigureerd met de Azure AI-maphiërarchie (afh map), die is ontworpen om u in uw huidige ontwikkelingscontext te richten en u te helpen met uw code, gegevens en gedeelde bestanden het meest efficiënt te werken. Deze afh map bevat uw Azure AI Studio-projecten en elk project heeft een toegewezen projectmap met code, dataen shared mappen.

Deze tabel bevat een overzicht van de mapstructuur:

Map	Beschrijving
code	Gebruiken voor het werken met Git-opslagplaatsen of lokale codebestanden. De code map is een opslaglocatie rechtstreeks op uw rekenproces en presteert voor grote opslagplaatsen. Het is een ideale locatie om uw Git-opslagplaatsen te klonen of uw codebestanden op een andere manier in te voeren of te maken.
data	Gebruiken voor het opslaan van lokale gegevensbestanden. U wordt aangeraden de data map te gebruiken om lokale gegevens op een consistente manier op te slaan en ernaar te verwijzen.
shared	Gebruik dit voor het werken met de gedeelde bestanden en assets van een project, zoals promptstromen. Hier vindt u bijvoorbeeld shared\Users\{user-name}\promptflow de promptstromen van het project.

Belangrijk

Het is raadzaam dat u in deze projectmap werkt. Bestanden, mappen en opslagplaatsen die u in uw projectmap opneemt, blijven behouden op uw hostcomputer (uw rekenproces). Bestanden die zijn opgeslagen in de code en gegevensmappen, blijven behouden, zelfs wanneer het rekenproces wordt gestopt of opnieuw wordt opgestart, maar gaan verloren als de berekening wordt verwijderd. De gedeelde bestanden worden echter opgeslagen in het opslagaccount van uw hub en gaan daarom niet verloren als het rekenproces wordt verwijderd.

Werken met promptstromen

U kunt promptstromen maken, ernaar verwijzen en ermee werken.

Promptstromen die al zijn gemaakt in Azure AI Studio, vindt u op shared\Users\{user-name}\promptflow. U kunt ook nieuwe stromen in uw code of shared map maken.

De promptstroom maakt automatisch gebruik van de Azure AI Studio-verbindingen waar uw project toegang toe heeft.

U kunt ook werken met de promptstroomextensie in VS Code, die vooraf is geïnstalleerd in deze omgeving. Binnen deze extensie kunt u de verbindingsprovider instellen op uw project. Zie verbindingen van Azure AI gebruiken.

Zie de mogelijkheden voor promptstromen voor meer informatie.

AI-app-sjablonen gebruiken

AI-app-sjablonen worden aan de rechterkant van het tabblad Code van uw project gekoppeld. In deze voorbeelden leert u hoe u de Azure AI SDK's gebruikt om het volgende te doen:

• Uw ontwikkelomgeving instellen en verbinding maken met bestaande resources
• Uw aangepaste toepassingscode invoeren
• Evaluaties uitvoeren
• Uw code implementeren

Als u een volledig nieuwe set resources wilt inrichten, inclusief een nieuwe hub en een nieuw project, en deze voorbeeldtoepassingen wilt implementeren, kunt u de Azure Developer CLI (AZD) gebruiken in uw lokale ontwikkelomgeving.

Opmerkingen

Als u van plan bent om meerdere code- en gegevensmappen of meerdere opslagplaatsen te gebruiken, kunt u de functie Split Root File Explorer in VS Code gebruiken. Voer de volgende stappen uit om deze functie te proberen:

1. Voer Ctrl+Shift+p in om het opdrachtenpalet te openen. Werkruimten zoeken en selecteren : Map toevoegen aan werkruimte.
2. Selecteer de opslagplaatsmap die u wilt laden. U ziet nu een nieuwe sectie in de Verkenner voor de map die u hebt geopend. Als het een opslagplaats was, kunt u nu werken met broncodebeheer in VS Code.
3. Als u deze configuratie wilt opslaan voor toekomstige ontwikkelingssessies, voert u nogmaals Ctrl+Shift+p in en selecteert u Werkruimten: Werkruimte opslaan als. Met deze actie wordt een configuratiebestand opgeslagen in uw huidige map.

Zie Apps ontwikkelen die gebruikmaken van Azure AI-services voor app-sjablonen en SDK-voorbeelden in uw favoriete programmeertaal.

Gerelateerde inhoud

• Aan de slag met het bouwen van een chat-app met behulp van de promptstroom-SDK
• Aan de slag met Azure AI SDK's