Szybki start: konfigurowanie zasobów Microsoft Foundry

W tym przewodniku szybkiego startu utworzysz projekt Microsoft Foundry i wdrożysz model. Jeśli zarządzasz zespołem, udzielasz również dostępu członkom zespołu. Po wykonaniu tych kroków ty lub twój zespół będzie mógł rozpocząć tworzenie aplikacji sztucznej inteligencji przy użyciu wdrożonego modelu.

Wskazówka

Ten szybki start pokazuje, jak utworzyć zasoby do zbudowania agenta z użyciem podstawowej konfiguracji. Aby uzyskać bardziej zaawansowane scenariusze korzystające z własnych zasobów, zobacz Konfigurowanie środowiska na potrzeby tworzenia agentów.

Wymagania wstępne

• Konto Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz konto free Azure, które obejmuje subskrypcję bezpłatnej wersji próbnej.
• Jeśli tworzysz projekt dla siebie:
  • Dostęp do roli umożliwiającej tworzenie zasobu usługi Foundry, na przykład Azure Account AI Owner lub Foundry Owner, w ramach subskrypcji lub grupy zasobów. Aby uzyskać więcej informacji na temat uprawnień, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

    Ważna

    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.

• Jeśli tworzysz projekt dla zespołu:
  • Dostęp do roli, która umożliwia wykonywanie przypisań ról, takich jak Właściciel. Aby uzyskać więcej informacji na temat uprawnień, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.
  • Lista adresów e-mail użytkowników lub identyfikatory grup zabezpieczeń Microsoft Entra dla członków zespołu, którzy potrzebują dostępu.

Wybierz preferowaną metodę przy użyciu następujących kart:

Azure CLI

• Zainstaluj Azure CLI w wersji 2.67.0 lub nowszej (sprawdź az version).

• Zaloguj się do Azure:

  az login
  

Portal usługi Foundry

• Dostęp do portalu Microsoft Foundry.

Tworzenie projektu

Utwórz projekt Foundry, aby zorganizować swoją pracę. Projekt zawiera modele, agentów i inne zasoby używane przez zespół.

Azure CLI

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
   

2. Utwórz zasób Foundry. 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 \
      --allow-project-management
   

   Flaga --allow-project-management umożliwia tworzenie projektu w ramach tego zasobu.

3. Utwórz niestandardową poddomenę dla zasobu. Nazwa domeny niestandardowej musi być globalnie unikatowa. Jeśli my-foundry-resource jest zajęte, spróbuj użyć bardziej unikalnej nazwy.

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

4. 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
   

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
   

   Dane wyjściowe wyświetlają właściwości projektu, w tym jego identyfikator zasobu.

Odniesienie: az cognitiveservices account

Portal usługi Foundry

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.

Wdrażanie modelu

Wdróż model, którego można użyć. W tym przykładzie użyto modelu gpt-4.1-mini, ale można wybrać dowolny dostępny model.

Azure CLI

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

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-4.1-mini

Gdy wdrożenie jest gotowe, dane wyjściowe zawierają wartość "provisioningState": "Succeeded".

Dokumentacja: az cognitiveservices account deployment

Portal usługi Foundry

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

Uzyskaj szczegóły połączenia projektu

Aby nawiązać połączenie z kodu, potrzebny jest punkt końcowy projektu. Jeśli zarządzasz tym projektem dla innych, wyślij im ten punkt końcowy wraz z nazwą wdrożenia.

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.

Dla administratorów — udzielanie dostępu

Jeśli administrowasz zespołem, przypisz rolę Użytkownika rozwiązania Foundry członkom zespołu, aby mogli korzystać z projektu i wdrożonych modeli. Ta rola zapewnia minimalne uprawnienia wymagane do kompilowania i testowania aplikacji sztucznej inteligencji. W przypadku innych ról, które mogą być konieczne do przypisania, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry

Ważna

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.

Azure CLI

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:

   Ważna

   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" \
       --scope $PROJECT_ID
   

Note

Ponieważ ostatnio zmieniono nazwę ról RBAC usługi Foundry, użyj identyfikatora definicji roli (GUID) zamiast nazwy roli w kodzie, aby uniknąć problemów podczas wdrażania zmiany nazwy:

• Użytkownik Foundry: 53ca6127-db72-4b80-b1b0-d745d6d5456d
• Właściciel odlewni: c883944f-8b7b-4483-af10-35834be79c4a
• Właściciel konta usługi Foundry: e47c6f54-e4a2-4754-9501-8e0985b135e1
• Menedżer projektu Foundry: eadc314b-1a2d-4efa-be10-5d325db5065e

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

Portal usługi Foundry

1. W portalu Foundry wybierz pozycję Operuj w prawym górnym rogu nawigacji.
2. Wybierz pozycję Administrator w okienku po lewej stronie.
3. Wybierz nazwę projektu w tabeli.
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ń.

Wskazówka

Aby dodać wielu użytkowników jednocześnie, użyj grupy zabezpieczeń Microsoft Entra zamiast poszczególnych adresów e-mail.

Weryfikowanie dostępu członka zespołu

Poproś członka zespołu o zweryfikowanie dostępu, logując się do Microsoft Foundry i wybierając projekt z listy projektów.

Jeśli członek zespołu nie może uzyskać dostępu do projektu, sprawdź, czy przypisanie roli zostało ukończone pomyślnie. Sprawdź, czy użyto poprawnego adresu e-mail lub identyfikatora grupy zabezpieczeń. Upewnij się, że konto Azure członka zespołu znajduje się w tej samej dzierżawie Microsoft Entra.

Aby upewnić się, że wdrożony model jest dostępny, poproś członka zespołu o wybranie pozycji Kompiluj w prawym górnym rogu nawigacji, a następnie pozycję Modele w okienku po lewej stronie.

Czyszczenie zasobów

Jeśli nie chcesz już tego projektu, usuń grupę zasobów, aby usunąć wszystkie skojarzone z nim zasoby.

Azure CLI

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

Portal usługi Foundry

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.

Następny krok

Microsoft Foundry — szybki start