Quickstart: Microsoft Foundry-resources instellen

In deze quickstart maakt u een Microsoft Foundry-project en implementeert u een model. Als u een team beheert, verleent u ook toegang tot teamleden. Nadat u deze stappen hebt voltooid, kunt u of uw team beginnen met het bouwen van AI-toepassingen met behulp van het geïmplementeerde model.

Tip

In deze quickstart ziet u hoe u middelen maakt om een agent te bouwen met een basissetup. Zie Uw omgeving instellen voor agentontwikkeling voor meer geavanceerde scenario's die gebruikmaken van uw eigen resources.

Voorwaarden

Selecteer de gewenste methode met behulp van de volgende tabbladen:

  • Installeer de Azure CLI versie 2.67.0 of hoger (neem contact op met az version).

  • Meld u aan bij Azure:

    az login

Een project maken

Maak een Foundry-project om uw werk te organiseren. Het project bevat modellen, agents en andere resources die uw team gebruikt.

  1. Maak een resourcegroep of gebruik een bestaande resourcegroep. Maak bijvoorbeeld my-foundry-rg het volgende in eastus:

    az group create --name my-foundry-rg --location eastus

  2. Maak de Foundry-resource aan. Maak my-foundry-resource bijvoorbeeld in de my-foundry-rg resourcegroep:

    az cognitiveservices account create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --kind AIServices \
    --sku s0 \
    --location eastus \
   --allow-project-management

    Met de --allow-project-management flag kan een project worden gemaakt binnen deze resource.

  3. Maak een aangepast subdomein voor de resource. De aangepaste domeinnaam moet wereldwijd uniek zijn. Als my-foundry-resource gebruikt wordt, probeert u een uniekere naam.

    az cognitiveservices account update \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --custom-domain my-foundry-resource

  4. Maak het project. Bijvoorbeeld, creëer my-foundry-project in de my-foundry-resource.

    az cognitiveservices account project create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --location eastus

  5. Controleer of het project is gemaakt:

    az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project

    In de uitvoer worden de projecteigenschappen weergegeven, inclusief de resource-id.

Referentie: az cognitiveservices account

Een model implementeren

Implementeer een model dat u kunt gebruiken. In dit voorbeeld wordt gpt-4.1-mini gebruikt, maar u kunt elk beschikbaar model kiezen.

az cognitiveservices account deployment create \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini \
    --model-name gpt-4.1-mini \
    --model-version "2025-04-14" \
    --model-format OpenAI \
    --sku-capacity 10 \
    --sku-name Standard

Controleer of de implementatie is geslaagd:

az cognitiveservices account deployment show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --deployment-name gpt-4.1-mini

Wanneer de implementatie gereed is, wordt de uitvoer getoond "provisioningState": "Succeeded".

Naslagwerk: az cognitiveservices account deployment

De details van de projectverbinding ophalen

U hebt uw project-eindpunt nodig om verbinding te maken vanuit de code. Als u dit project voor anderen beheert, stuurt u dit eindpunt samen met de implementatienaam.

  1. Meld u aan bij Microsoft Foundry met behulp van uw Azure-account.
  2. Selecteer uw project.
  3. Zoek uw projectendpoint op het welkomstscherm van het project.Schermafbeelding van het Microsoft Foundry Models welkomstscherm met de eindpunt-URL en kopieerknop.
  4. Kopieer de eindpuntwaarde. U gebruikt deze waarde in andere snelstartgidsen en zelfstudies.

Voor beheerders : toegang verlenen

Als u een team beheert, wijst u de rol Azure AI-gebruiker toe aan teamleden, zodat ze het project en de geïmplementeerde modellen kunnen gebruiken. Deze rol biedt de minimale machtigingen die nodig zijn voor het bouwen en testen van AI-toepassingen. Zie Toegangsbeheer op basis van Microsoft Foundry voor andere rollen die u mogelijk moet toewijzen.

  1. Haal de resource-id van het project op:

    PROJECT_ID=$(az cognitiveservices account project show \
  --name my-foundry-resource \
  --resource-group my-foundry-rg \
  --project-name my-foundry-project \
  --query id -o tsv)

  2. Wijs de rol Azure AI-gebruiker toe aan een teamlid:

    az role assignment create \
    --role "Azure AI User" \
    --assignee "user@contoso.com" \
    --scope $PROJECT_ID

    Een beveiligingsgroep toevoegen in plaats van een afzonderlijke gebruiker:

    az role assignment create \
    --role "Azure AI User" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

  3. Controleer de roltoewijzing:

    az role assignment list \
    --scope $PROJECT_ID \
    --role "Azure AI User" \
    --output table

Naslaginformatie: az role assignment

Toegang tot teamleden controleren

Vraag een teamlid om de toegang te controleren door u aan te melden bij Microsoft Foundry en het project te selecteren in de lijst met projecten.

Als het teamlid geen toegang heeft tot het project, controleert u of de roltoewijzing is voltooid. Controleer of u het juiste e-mailadres of de juiste id van de beveiligingsgroep hebt gebruikt. Zorg ervoor dat het Azure-account van het teamlid zich in dezelfde Microsoft Entra tenant bevindt.

Als u wilt controleren of het geïmplementeerde model beschikbaar is, vraagt u het teamlid om Build te selecteren in de navigatie in de rechterbovenhoek en vervolgens modellen in het linkerdeelvenster.

Resources opschonen

Wanneer u dit project niet meer wilt, verwijdert u de resourcegroep om alle resources te verwijderen die eraan zijn gekoppeld.

az group delete --name my-foundry-rg --yes --no-wait

Volgende stap

quickstart Microsoft Foundry

  • Last updated on