Szybki start: konfigurowanie zasobów Microsoft Foundry

• Zainstaluj Azure CLI w wersji 2.80.0 lub nowszej. Sprawdź swoją wersję za pomocą polecenia az version i uruchom polecenie az upgrade, jeśli potrzebujesz nowszej wersji.

  W wersji 2.80.0 dodano polecenia az cognitiveservices account project, które są używane w tych krokach. We wcześniejszej wersji polecenia kończą się niepowodzeniem w przypadku użycia unrecognized arguments lub 'project' is misspelled or not recognized by the system.

• Zaloguj się do Azure:

  az login
  

• Dostęp do portalu Microsoft Foundry.

1. Utwórz grupę zasobów lub użyj istniejącej. Na przykład utwórz my-foundry-rg w eastus.

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

   Sprawdź, czy grupa zasobów istnieje:

   az group show --name my-foundry-rg --query properties.provisioningState --output tsv
   

   Dane wyjściowe zawierają wartość Succeeded.

2. Utwórz zasób Foundry z włączonym zarządzaniem projektami. Na przykład utwórz my-foundry-resource w my-foundry-rg grupie zasobów:

   az cognitiveservices account create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --kind AIServices \
       --sku S0 \
       --location eastus \
       --custom-domain my-foundry-resource \
       --assign-identity \
       --allow-project-management true
   

   Użyj następujących wartości:

   Parametr	Purpose
   --assign-identity	Tworzy tożsamość zarządzaną wymaganą przez zarządzanie projektami. Bez niego tworzenie projektu kończy się niepowodzeniem z powodu błędu, że tożsamość zarządzana musi być włączona w zasobie.
   --allow-project-management	Umożliwia zarządzanie projektami. Nie można zmienić tego ustawienia po utworzeniu zasobu.
   --custom-domain	Musi ona być unikatowa w skali globalnej. Jeśli my-foundry-resource jest zajęte, polecenie zakończy się niepowodzeniem z komunikatem CustomDomainInUse. Wybierz inną nazwę i ponownie uruchom polecenie.

3. Utwórz projekt. Na przykład utwórz my-foundry-project w my-foundry-resource:

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

4. Sprawdź, czy zasób jest aprowizowany:

   az cognitiveservices account show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --query properties.provisioningState --output tsv
   

   Dane wyjściowe powinny wskazywać wartość Succeeded. Jeśli dane wyjściowe zawierają inny stan, sprawdź uprawnienia, dostępność regionu i limity przydziału zasobów. Aby uzyskać więcej pomocy, zobacz Tworzenie zasobu z wieloma usługami.

5. Sprawdź, czy projekt został utworzony:

   az cognitiveservices account project show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --project-name my-foundry-project \
       --query properties.provisioningState --output tsv
   

   Dane wyjściowe powinny wskazywać wartość Succeeded. Jeśli polecenie zakończy się niepowodzeniem z komunikatem informującym, że należy włączyć tożsamość zarządzaną, upewnij się, że utworzono zasób za pomocą --assign-identity.

Dokumentacja referencyjna: az cognitiveservices account project

1. Zaloguj się do Microsoft Foundry. Upewnij się, że przełącznik New Foundry jest włączony. Te kroki dotyczą rozwiązania Foundry (nowy).

   

2. Utwórz projekt.

   • Jeśli jest to pierwsze użycie rozwiązania Foundry, zostanie wyświetlony monit o utworzenie lub wyszukanie projektu, aby kontynuować. Wybierz pozycję Utwórz nowy projekt na liście rozwijanej.
   • Jeśli masz już załadowany projekt, wybierz jego nazwę w lewym górnym rogu, a następnie wybierz pozycję Utwórz nowy projekt.

3. Wprowadź nazwę projektu, na przykład my-foundry-project.

4. Wybierz pozycję Opcje zaawansowane , aby skonfigurować grupę zasobów i lokalizację:

   • Grupa zasobów: utwórz nową grupę zasobów lub wybierz istniejącą. Jeśli tworzysz nową grupę zasobów, możesz łatwiej zarządzać projektem i wszystkimi jej zasobami razem.
   • Lokalizacja: wybierz region najbliżej twojego zespołu.

5. Wybierz pozycję Utwórz projekt.

   Poczekaj na utworzenie projektu. Po wyświetleniu strony przeglądu projektu projekt jest gotowy.

1. Wyświetl listę modeli dostępnych w twoim regionie, aby potwierdzić nazwę i wersję modelu:

   az cognitiveservices model list \
       --location eastus \
       --query "[?model.name=='gpt-5-mini'].{version:model.version,skus:join(',',model.skus[].name)}" \
       --output table
   

2. Wdróż model:

   az cognitiveservices account deployment create \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --model-name gpt-5-mini \
       --model-version "2025-08-07" \
       --model-format OpenAI \
       --sku-capacity 10 \
       --sku-name GlobalStandard
   

   Jeśli polecenie nie powiedzie się z komunikatem DeploymentModelNotSupported, model, wersja lub kod SKU nie są dostępne w Twoim regionie. Użyj danych wyjściowych poprzedniego kroku, aby wybrać obsługiwaną kombinację.

3. Sprawdź, czy wdrożenie zakończyło się pomyślnie:

   az cognitiveservices account deployment show \
       --name my-foundry-resource \
       --resource-group my-foundry-rg \
       --deployment-name gpt-5-mini \
       --query properties.provisioningState --output tsv
   

   Dane wyjściowe pokazują Succeeded, gdy wdrożenie jest gotowe.

Dokumentacja: az cognitiveservices account deployment

1. Wybierz pozycję Odnajdź w prawym górnym rogu, a następnie pozycję Modele w okienku po lewej stronie.
2. Wyszukaj frazę gpt-5-mini.
3. Wybierz pozycję Wdróż>ustawienia domyślne , aby dodać je do projektu.
4. Zanotuj nazwę wdrożenia (na przykład gpt-5-mini). Twój zespół potrzebuje tej nazwy, aby użyć modelu.

Pobierz punkt końcowy projektu:

az cognitiveservices account project show \
    --name my-foundry-resource \
    --resource-group my-foundry-rg \
    --project-name my-foundry-project \
    --query 'properties.endpoints."AI Foundry API"' --output tsv

Dane wyjściowe to punkt końcowy projektu w postaci https://my-foundry-resource.services.ai.azure.com/api/projects/my-foundry-project. Użyj tej wartości w innych przewodnikach Szybki start i samouczkach.

1. Zaloguj się do Microsoft Foundry przy użyciu konta Azure.
2. Wybierz projekt.
3. Znajdź punkt końcowy projektu na ekranie powitalnym projektu.
4. Skopiuj wartość punktu końcowego. Używasz tej wartości w innych przewodnikach szybkiego startu i samouczkach.

1. Pobierz identyfikator zasobu projektu:

   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. Przypisz rolę Użytkownika rozwiązania Foundry do członka zespołu:

   Important

   Niedawno zmieniono nazwy ról RBAC w usłudze Foundry. Użytkownik Foundry, właściciel Foundry, właściciel konta Foundry i menedżer projektu Foundry były wcześniej nazywane odpowiednio użytkownikiem Azure AI, właścicielem Azure AI, właścicielem konta Azure AI i menedżerem projektu Azure AI. Poprzednie nazwy mogą być nadal widoczne w niektórych miejscach, podczas gdy zmiana nazwy jest wdrażana. Identyfikatory ról i uprawnienia podstawowe są niezmienione przez zmianę nazwy.

   az role assignment create \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --assignee "user@contoso.com" \
       --assignee-principal-type User \
       --scope $PROJECT_ID
   

Aby dodać grupę zabezpieczeń zamiast pojedynczego użytkownika:

az role assignment create \
    --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
    --assignee-object-id "<security-group-object-id>" \
    --assignee-principal-type Group \
    --scope $PROJECT_ID

1. Sprawdź przypisanie roli:

   az role assignment list \
       --scope $PROJECT_ID \
       --role "53ca6127-db72-4b80-b1b0-d745d6d5456d" \
       --output table
   

Referencja: az role assignment

1. W portalu Foundry wybierz pozycję Zarządzaj w prawym górnym rogu nawigacji.
2. Wybierz Szczegóły projektu w lewym panelu.
3. Wybierz kartę Użytkownicy .
4. Wybierz pozycję Dodaj użytkownika w prawym górnym rogu.
5. Wprowadź adres e-mail członka zespołu.
6. Wybierz pozycję Dodaj.

Powtórz te kroki dla każdego członka zespołu lub grupy zabezpieczeń.

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

Usuwanie odbywa się w tle. Aby potwierdzić, że grupa zasobów została usunięta, uruchom polecenie:

az group exists --name my-foundry-rg

Wynik pokazuje false po zakończeniu usuwania.

W portalu Azure znajdź i wybierz grupę zasobów. Wybierz pozycję Usuń i potwierdź, aby usunąć grupę zasobów i wszystkie skojarzone z nią zasoby.