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.

W przypadku tworzenia agentów połącz się również z usługą Azure Monitor Application Insights, aby przechowywać ślady agentów.

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, która umożliwia utworzenie zasobu usługi Foundry, takiego jak właściciel konta usługi Foundry lub właściciel usługi Foundry w subskrypcji lub grupie zasobów. Aby uzyskać więcej informacji na temat uprawnień, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

      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.

  • 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.
  • Aby wyświetlić ślady agenta: dostęp do odczytu połączonego zasobu usługi Application Insights, takiego jak Log Analytics Reader. Administrator może nadać ten dostęp. Zobacz Udzielanie dostępu do śladów, aby uzyskać informacje o wymaganiach dotyczących chronionej tabeli i obszaru roboczego.
  • Aby przypisać role czytelnika śledzenia, musisz mieć uprawnienie Microsoft.Authorization/roleAssignments/write w zakresie docelowym. Sam współtwórca nie udziela tego uprawnienia. Jeśli nie możesz przypisać ról, poproś administratora o przypisanie wymaganego dostępu.

Jeśli używasz Azure CLI zamiast portalu, rola Współautor lub Właściciel w grupie zasobów wystarczy, aby utworzyć zasób i projekt. Nadal potrzebujesz roli, która może przypisywać role, takie jak Właściciel, aby udzielić dostępu członkom zespołu.

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

  • 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

Tworzenie projektu

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

Wskazówka

Utwórz projekt w regionie Zachodnie stany USA 3 , jeśli chcesz wypróbować model błyskawiczny (wersja zapoznawcza).

Note

Te kroki wymagają Azure CLI w wersji 2.80.0 lub nowszej oraz roli Współautor lub Właściciel w grupie zasobów. Uruchom polecenie az version , aby sprawdzić wersję i az upgrade jeśli potrzebujesz nowszej wersji. Uruchom az login, aby się zalogować, zanim zaczniesz. Aby uzyskać informacje o obsługiwanych regionach, zobacz Obsługa regionów.

  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

Łączenie usługi Application Insights na potrzeby śledzenia agentów

Przed uruchomieniem przewodnika Szybki start dla agenta ukończ tę konfigurację w portalu Foundry.

Przed włączeniem śledzenia należy przejrzeć zabezpieczenia i prywatność śledzenia oraz przechowywanie danych i koszty.

Postępuj zgodnie z instrukcjami dotyczącymi łączenia usługi Application Insights z projektem Foundry. Sprawdź i ponownie użyj istniejącego połączenia.

Note

Jeśli istniejące połączenie korzysta z Project Managed Identity lub organizacja wymaga pozyskiwania danych wyłącznie w usłudze Entra, zachowaj zatwierdzoną konfigurację. Zobacz Konfigurowanie uwierzytelniania Microsoft Entra na potrzeby pozyskiwania danych śledzenia.

W przypadku agentów hostowanych przez usługę Foundry połączenie umożliwia śledzenie po stronie serwera. W przypadku agentów działających we własnej aplikacji skonfiguruj również śledzenie po stronie klienta.

Udziel dostępu do śladów

Osoba lub grupa wyświetlająca ślady musi mieć rolę Log Analytics Reader w połączonym zasobie usługi Application Insights lub równoważny dostęp dziedziczony. W przypadku chronionych tabel śledzenia należy również przyznać uprawnienie Privileged Monitoring Data Reader.

Aby uzyskać szczegółowe instrukcje, zobacz Wymagania wstępne dotyczące śledzenia i Przypisywanie ról Azure przy użyciu portalu Azure.

W przypadku zapytań w zakresie obszaru roboczego lub obszarów roboczych, które wymagają uprawnień obszaru roboczego, zobacz Zarządzanie dostępem do obszarów roboczych usługi Log Analytics.

Zweryfikuj pierwszy ślad agenta

Kontynuuj wdrażanie modelu lub skorzystaj z przewodnika Szybki start agenta. Po pierwszym żądaniu agenta wykonaj kroki w sekcji Sprawdź, czy śledzenie działa, aby potwierdzić, że pojawi się nowy ślad. Sama pomyślna odpowiedź nie potwierdza, że ślady zostały zapisane.

Jeśli nie ma śladu, zobacz Rozwiązywanie problemów ze śledzeniem.

Wdrażanie modelu

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

Wskazówka

Aby wypróbować model dostępu błyskawicznego (wersja zapoznawcza), możesz pominąć ten krok.

  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

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.

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.

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 możesz potrzebować przypisać, zobacz Kontrola dostępu oparta na rolach dla Microsoft Foundry.

  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

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

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.

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.

Następny krok

Microsoft Foundry — szybki start

  • Ostatnia aktualizacja o