Delen via

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 access aan 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.

Aanbeveling

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

Vereiste 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. De 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. 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 vlag --allow-project-management kunt u project maken binnen deze resource.

  3. Maak een aangepast subdomein voor de resource. De custom domain naam moet wereldwijd uniek zijn. Als my-foundry-resource bezet is, probeer een meer unieke naam.

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

  4. Maak de project. Maak bijvoorbeeld 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 de 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 project eigenschappen weergegeven, inclusief de resource-id.

Verwijzing: 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 "provisioningState": "Succeeded" weergegeven.

Naslaginformatie: az cognitiveservices-accountimplementatie

Uw project-verbindingsgegevens ophalen

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

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

Voor beheerders : access verlenen

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

  1. Haal de resource-id van de 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

Verwijzing: az-roltoewijzing

Toegang teamleden controleren

Vraag een teamlid hun toegang te verifiëren door zich aan te melden bij Microsoft Foundry, het project in de projectenlijst te selecteren en te bevestigen dat het geïmplementeerde model wordt weergegeven onder Build>Models.

Als het teamlid het project niet kan openen, controleer 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.

De hulpbronnen opschonen

Wanneer u deze 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

Microsoft Foundry - Quickstart

  • Last updated on