Wbudowane zasady wdrażania modelu w portalu Microsoft Foundry

Azure Policy udostępnia wbudowane definicje zasad, które ułatwiają zarządzanie wdrażaniem modeli sztucznej inteligencji w portalu Microsoft Foundry. Za pomocą tych zasad można kontrolować modele, które deweloperzy mogą wdrażać w portalu Foundry.

Uwaga

Aby wdrożyć i używać routera modeli, gdy przypisano zasady zatwierdzonych modeli, router modeli i każdy model uwzględniony w tym wdrożeniu muszą spełniać te zasady za pośrednictwem dozwolonego wydawcy lub dozwolonego identyfikatora zasobu. Jeśli używasz zatwierdzania opartego na wydawcy, uwzględnij Microsoft dla routera modelu i każdego wydawcę reprezentowanego w wybranym zestawie routingu, na przykład Anthropic dla modeli Claude'a. Nazwy wydawców są wymienione na karcie każdego modelu w katalogu modeli. W przypadku ARM lub CLI jakikolwiek model niespełniający wymagań w żądanym zestawie powoduje, że całe wdrożenie kończy się niepowodzeniem. W portalu Foundry można wykluczyć niezgodne modele i wdrożyć zgodny podzestaw.

Wymagania wstępne

  • Konto Azure z aktywną subskrypcją. Jeśli go nie masz, utwórz konto free Azure. Twoje konto Azure umożliwia dostęp do portalu Foundry.

  • Uprawnienia do tworzenia i przypisywania zasad. Aby utworzyć i przypisać zasady, musisz być Właścicielem lub Współtwórcą Polityki Zasobów na poziomie subskrypcji Azure lub grupy zasobów.

  • Znajomość Azure Policy. Aby dowiedzieć się więcej, zobacz Czym jest Azure Policy?.

Microsoft Foundry udostępnia wbudowane definicje Azure Policy ułatwiające zarządzanie modelami, które można wdrożyć w organizacji. Następujące definicje mają zastosowanie do wdrożeń modelu:

Policy Purpose Status
Wdrożenia modeli w Foundry powinny używać wyłącznie zatwierdzonych modeli Ogranicz wdrożenia do określonej listy modeli lub wydawców, które organizacja jawnie zatwierdza. Ogólnie dostępne
Wdrożenia modeli Foundry powinny spełniać kryteria kwalifikacji Ogranicz wdrożenia na podstawie atrybutów modelu, takich jak źródło (bezpośrednie z Azure) i stan cyklu życia (wersja zapoznawcza). Ogólnie dostępne

Obie zasady są oceniane w czasie wdrażania. Katalog nie ukrywa modeli. Zamiast tego akcja Wdróż jest wyłączona z wyraźnym powodem, gdy zasady blokują wdrożenie. W zależności od potrzeb dotyczących ładu można przypisać jedną lub obie zasady.

Uwaga

Te zasady regulują również modele bazowe, spośród których router modeli dokonuje wyboru. Router modeli kieruje żądania tylko do modeli, które spełniają przypisane do Ciebie zasady, więc te same zasady zatwierdzania i kwalifikacji obowiązują niezależnie od tego, czy wdrażasz model bezpośrednio, czy używasz routera modeli do wyboru modelu dla każdego żądania. Ponadto dedykowane wbudowane definicje zasad dla routera modelu są dostępne w publicznej wersji zapoznawczej. Te definicje rozszerzają nadzór na inne aspekty wdrożeń routera modelu, w tym regiony wdrażania, wymagane reguły routingu i konfiguracje rejestrowania. Aby uzyskać więcej informacji, zobacz Zarządzanie wdrożeniami routera modelu za pomocą Azure Policy.

Jak te zasady współpracują ze sobą

Te dwie zasady uzupełniają się i odpowiadają na różne pytania dotyczące ładu:

  • Zatwierdzone modele odpowiadają na pytanie "Czy ten dokładny model znajduje się na liście dozwolonych mojej organizacji?" — na podstawie tożsamości modelu.
  • Wymagania dotyczące uprawnień odpowiadają na pytania "Czy ten model spełnia standardy mojej organizacji dotyczące źródła i dojrzałości?" — na podstawie atrybutów modelu.

Jeśli przypiszesz obie zasady, a model nie spełnia wymagań żadnej z nich, w widoku Wdrażanie najpierw zostanie wyświetlony powód o najwyższym priorytecie (zatwierdzenie, a następnie kwalifikacja), dzięki czemu użytkownicy otrzymają jeden jasny komunikat wskazujący wymagane działanie.

We wdrożeniach modeli Foundry należy używać wyłącznie zatwierdzonych modeli

Użyj tych zasad, aby ograniczyć wdrożenia do określonej listy modeli lub wydawców, które organizacja jawnie zatwierdza.

Uwaga

Ta zasada nosiła wcześniej nazwę Wdrożenia usług Cognitive Services powinny korzystać wyłącznie z zatwierdzonych modeli z rejestru. Identyfikator definicji zasad pozostaje bez zmian, więc istniejące przypisania nadal będą działać bez konieczności podejmowania jakichkolwiek działań.

Przypisywanie zasad zatwierdzonych modeli

Użyj Azure CLI, aby znaleźć wbudowaną definicję zasad i przypisać ją do określonego zakresu.

  1. Zaloguj się i wybierz subskrypcję, w której chcesz pracować:

    az login
    az account set --subscription "<subscription-id>"
    
  2. Znajdź identyfikator definicji zasad dla wbudowanej definicji:

    az policy definition list \
       --query "[?displayName=='Foundry model deployments should only use approved models'].{name:name, id:id}" \
       --output table
    

    Oczekiwany wynik: wiersz zawierający zasady id.

  3. Utwórz plik parametrów (przykład):

    {
       "effect": {
          "value": "Deny"
       },
       "allowedPublishers": {
          "value": ["OpenAI"]
       },
       "allowedAssetIds": {
          "value": [
             "azureml://registries/azure-openai/models/gpt-5/",
             "azureml://registries/azure-openai/models/gpt-5.2/versions/1"
          ]
       }
    }
    

    Oczekiwany wynik: plik JSON zgodny z zatwierdzonymi nazwami wydawców i identyfikatorami modeli.

    Ważne

    Każdy identyfikator zasobu jest dopasowywany na podstawie prefiksu. Identyfikator bez ukośnika końcowego jest również zgodny z innymi modelami, azureml://registries/azure-openai/models/gpt-5 których nazwy zaczynają się od tych samych znaków — na przykład pasuje do GPT-5, a także GPT-5.2 i GPT-5.4. Dodaj ukośnik końcowy (/), aby ograniczyć dopasowanie tylko do tego konkretnego modelu — na przykład azureml://registries/azure-openai/models/gpt-5/ pasuje tylko do GPT-5 (wszystkie jego wersje) i wyklucza GPT-5.2 i GPT-5.4. Aby zezwolić tylko na jedną wersję, użyj pełnego identyfikatora zasobu, w tym wersji (na przykład azureml://registries/azure-openai/models/gpt-5.2/versions/1).

    Ważne

    Nazwy parametrów w tym przykładzie muszą być zgodne z przypisaną definicją zasad. Jeśli różnią się one w Twojej dzierżawie, zaktualizuj klucze JSON, aby były zgodne z parametrami definicji zasad.

  4. Przypisz zasady w zakresie (na przykład: zakres subskrypcji):

    az policy assignment create \
       --name "allow-only-approved-models" \
       --display-name "Allow only approved models" \
       --scope "/subscriptions/<subscription-id>" \
       --policy "<policy-definition-id>" \
       --params @params.json
    

    Oczekiwany wynik: polecenie zwraca ładunek JSON zawierający przypisanie id.

Referencja:

Wdrożenia modeli Foundry powinny spełniać wymogi kwalifikacyjne

Użyj tych zasad, aby ograniczyć wdrożenia na podstawie atrybutów modelu , a nie konkretnej tożsamości modelu. To ograniczenie jest przydatne, gdy chcesz wymusić szersze standardy organizacyjne — na przykład "brak modeli w wersji zapoznawczej w środowisku produkcyjnym" lub "tylko modele Microsoft bezpośrednie" — bez zachowania jawnej listy dozwolonych.

Ta zasada obecnie obsługuje następujące atrybuty:

Parametr Typ Default Zachowanie, gdy true
onlyAllowDirectFromAzure logiczny false Odrzuca wdrażanie modeli, które nie są bezpośrednie z Azure.
denyPreviewModels logiczny false Odrzuca wdrażanie modeli, których stan cyklu życia to Wersja zapoznawcza.

Oba parametry są domyślnie ustawione na false, więc nieskonfigurowane przypisanie nie nakłada żadnych ograniczeń. Włącz przełączniki zgodne z zasadami obowiązującymi w organizacji.

Przypisz politykę kwalifikowalności

  1. Zaloguj się i wybierz subskrypcję, w której chcesz pracować:

    az login
    az account set --subscription "<subscription-id>"
    
  2. Znajdź identyfikator definicji zasad:

    az policy definition list \
       --query "[?displayName=='Foundry model deployments should meet eligibility requirements'].{name:name, id:id}" \
       --output table
    
  3. Utwórz plik parametrów (na przykład — blokuj modele w wersji zapoznawczej, zezwalaj na dowolne źródło):

    {
       "effect": {
          "value": "Deny"
       },
       "onlyAllowDirectFromAzure": {
          "value": false
       },
       "denyPreviewModels": {
          "value": true
       }
    }
    
  4. Przypisz zasady:

    az policy assignment create \
       --name "foundry-model-eligibility" \
       --display-name "Foundry model eligibility" \
       --scope "/subscriptions/<subscription-id>" \
       --policy "<policy-definition-id>" \
       --params @params.json
    

Co deweloperzy widzą, gdy wdrożenie jest zablokowane

Gdy programista próbuje wdrożyć model, którego wdrożenie jest blokowane przez zasady, akcja Deploy jest wyłączona, a komunikat wyjaśnia, dlaczego. Sam model pozostaje widoczny w katalogu, dzięki czemu deweloper rozumie, czego próbowano.

Scenario Co widzi deweloper
Model jest zatwierdzony i uprawniony Wdrożenie włączone.
Model nie znajduje się na liście zatwierdzonych Wdrażanie wyłączone — komunikat informuje, że model nie został zatwierdzony przez organizację, i wskazuje, aby skontaktować się z administratorem subskrypcji lub usługi Foundry.
Model jest zatwierdzony, ale nie spełnia uprawnień (na przykład model w wersji zapoznawczej, gdy denyPreviewModels jest włączony) Wdrażanie wyłączone — komunikat wskazuje, że model nie spełnia wymagań kwalifikacyjnych organizacji (dotyczących źródła lub stanu cyklu życia), i zawiera informację o kontakcie z administratorem.
Wiele zasad blokuje wdrożenie Wdrażanie wyłączone — wyświetlany jest powód o najwyższym priorytecie (zatwierdzenie, a następnie kwalifikowalność).

Każdy komunikat zawiera nazwę zasad i identyfikator przypisania , dzięki czemu administratorzy mogą szybko zidentyfikować, które zasady wymuszają ograniczenie.

Monitorowanie zgodności

Aby monitorować zgodność z zasadami, wykonaj następujące kroki:

  1. W portalu Azure wybierz pozycję Policy po lewej stronie. Możesz również wyszukać Zasady na pasku wyszukiwania w górnej części strony.

  2. Po lewej stronie pulpitu nawigacyjnego Azure Policy wybierz pozycję Compliance. Każde przypisanie polityki jest wyświetlane ze stanem zgodności. Aby wyświetlić więcej szczegółów, wybierz przypisanie zasad.

Aktualizowanie przypisania zasad

Aby zaktualizować istniejące przypisanie zasad przy użyciu nowych modeli, wykonaj następujące kroki:

  1. W portalu Azure wybierz pozycję Policy po lewej stronie. Możesz również wyszukać Zasady na pasku wyszukiwania w górnej części strony.
  2. Po lewej stronie pulpitu nawigacyjnego Azure Policy wybierz pozycję Przypisania i znajdź istniejące przypisanie zasad. Wybierz wielokropek (...) obok zadania i wybierz Edytuj zadanie.
  3. Na karcie Parametry zaktualizuj dozwolone identyfikatory zasobów i dozwolone modele Wydawców przy użyciu nowych zatwierdzonych identyfikatorów modeli i nazw wydawców.
  4. Na karcie Przeglądanie i zapisywanie wybierz pozycję Zapisz , aby zaktualizować przypisanie zasad.

Najlepsze rozwiązania

  • Szczegółowe określanie zakresu: przypisz zasady w odpowiednim zakresie, aby zrównoważyć kontrolę i elastyczność. Na przykład zastosuj na poziomie subskrypcji, aby kontrolować wszystkie zasoby w subskrypcji lub stosować na poziomie grupy zasobów w celu kontrolowania zasobów w określonej grupie.
  • Nazewnictwo zasad: użyj spójnej konwencji nazewnictwa przypisań zasad, aby ułatwić identyfikowanie przeznaczenia zasad. Dołącz informacje, takie jak cel i zakres w nazwie.
  • Tagi: użyj tagów, aby kategoryzować zasady i zarządzać nimi. Na przykład zasady tagowania według środowiska (deweloperskie, testowe, prod) lub według działu.
  • Dokumentacja: przechowuj rekordy przypisań zasad i konfiguracji na potrzeby inspekcji. Dokumentowanie wszelkich zmian wprowadzonych w zasadach w czasie.
  • Regularne przeglądy: okresowo przeglądaj przypisania zasad, aby upewnić się, że są one zgodne z wymaganiami organizacji.
  • Testowanie: Testowanie zasad w środowisku nieprodukcyjnym przed zastosowaniem ich do zasobów produkcyjnych.
  • Komunikacja: Upewnij się, że deweloperzy są świadomi polityki i rozumieją implikacje dotyczące ich pracy.

Weryfikowanie skuteczności zasad

Po przypisaniu zasad sprawdź, czy działają zgodnie z oczekiwaniami:

  1. Poczekaj co najmniej 15 minut na zastosowanie przydzielenia zasad. Nowe przypisania nie są stosowane natychmiast.

  2. Spróbuj wdrożyć model, który nie znajduje się na liście dozwolonych. Jeśli zasady używają efektu Odmów, wdrożenie zakończy się niepowodzeniem z powodu błędu naruszenia zasad.

  3. Upewnij się, że wdrażanie zatwierdzonego modelu nadal kończy się powodzeniem.

  4. Sprawdź pulpit nawigacyjny Compliance w Azure Policy, aby sprawdzić, czy zasady prawidłowo oceniają zasoby. Niezgodne zasoby są wyświetlane w ramach jednego cyklu oceny zgodności (zazwyczaj do 24 godzin).

Rozwiązywanie problemów z błędami przypisywania zasad

Objaw Przyczyna Rozdzielczość
Przypisanie zasad kończy się niepowodzeniem z powodu błędu uprawnień Twoje konto nie posiada roli Właściciel ani Współautor zasad dotyczących zasobów w docelowym zakresie. Przypisz wymaganą rolę i spróbuj ponownie. Zobacz Wymagania wstępne.
Zasady nie blokują niezgodnych wdrożeń Przypisanie zasad nie zostało jeszcze rozpropagowane lub efekt jest ustawiony na Inspekcja zamiast Odmowa. Poczekaj co najmniej 15 minut, a następnie ponów próbę. Sprawdź, czy parametr Effect ma ustawioną wartość Odmów.
Zatwierdzony model jest nieoczekiwanie blokowany Identyfikator zasobu modelu lub nazwa wydawcy w parametrach zasad nie jest dokładnie zgodna z modelem. Porównaj wartości parametrów z kartą modelu w wykazie modeli. W identyfikatorach zasobów i nazwach wydawców jest rozróżniana wielkość liter.
Panel zgodności nie wyświetla danych Ocena zgodności nie została jeszcze ukończona. Azure Policy weryfikuje nowe przypisania w ciągu 24 godzin. Poczekaj na następny cykl oceny lub uruchom skanowanie na żądanie.
Błąd niezgodności nazwy parametru podczas przypisywania Klucze parametrów JSON nie są zgodne z definicją zasad. Uruchom polecenie az policy definition show --name "<definition-id>" , aby pobrać dokładne nazwy parametrów z definicji. Użyj allowedPublishers i allowedAssetIds.