Wymagania systemowe

Wskazówka

Szczegółowe kroki wdrożenia poprzez Azure Marketplace można znaleźć w Przewodniku wdrożeniowym.

Przegląd

AI Analyst wdrażany jest w ramach własnego dzierżawcy Azure jako Azure Managed Application. Na tej stronie przedstawiono wszystkie elementy, które muszą być zapewnione przed rozpoczęciem wdrożenia. Weryfikacja poniższych punktów z wyprzedzeniem znacząco skraca czas wdrożenia – niemal każda nieudana implementacja wynika z braku odpowiednich uprawnień, niezarejestrowanego dostawcy zasobów lub niewystarczającego limitu zasobów.

Wymagania wstępne dab

Przed wdrożeniem AI Analyst należy zapewnić dostępność następujących elementów:

• dab Nexus
• Licencja na dab AI Analyst

Uwaga

dab Knowledge Hub dostarcza wiedzę ekspercką z zakresu SAP i analityki, na podstawie której działa AI Analyst. Z tego względu AI Analyst nie może funkcjonować bez Knowledge Hub, a do jego dostępu wymagana jest licencja AI Analyst License.

Wymagania dotyczące Azure

Subskrypcja i uprawnienia

• Subskrypcja Azure, do której wdrażany jest AI Analyst
• Owner dla docelowego zakresu lub Contributor oraz User Access Administrator
• Uprawnienia do wdrożenia oferty z Azure Marketplace

Ważne

Sama rola Contributor nie jest wystarczająca. W ramach wdrożenia tworzone są przypisania ról, dzięki którym aplikacja uzyskuje dostęp do własnych sekretów w Key Vault poprzez zarządzaną tożsamość. W przypadku braku User Access Administrator wdrożenie zakończy się niepowodzeniem na etapie przypisywania ról.

Wymagani dostawcy zasobów

W docelowej subskrypcji muszą być zarejestrowane następujący dostawcy zasobów:

Dostawca zasobów	Cel rejestracji
Microsoft.Web	App Service i App Service Plan wykorzystywane przez AI Analyst
Microsoft.KeyVault	Key Vault przechowujący connection string, klucze API oraz sekrety
Microsoft.CognitiveServices	Konto Azure AI Foundry i wdrażany model AI
Microsoft.Network	Sieć wirtualna, podsieci i prywatny endpoint do dab Knowledge Hub
Microsoft.ManagedIdentity	Zarządzana tożsamość wykorzystywana przez AI Analyst do dostępu do Key Vault Secrets
Microsoft.App	Elementy platformy zarządzanej aplikacji

Rejestracji dostawców można dokonać w Azure Portal w sekcji Subscription -> Settings -> Resource providers, bądź wykonując poniższe polecenie:

az provider register --namespace Microsoft.Web
az provider register --namespace Microsoft.KeyVault
az provider register --namespace Microsoft.CognitiveServices
az provider register --namespace Microsoft.Network
az provider register --namespace Microsoft.ManagedIdentity
az provider register --namespace Microsoft.App

Uwaga

Rejestracja jest asynchroniczna i może potrwać kilka minut. Przed rozpoczęciem wdrożenia należy upewnić się, że każdy dostawca ma status Registered.

Wymagany limit zasobów (Quota)

Wdrożenie wymaga wolnych zasobów w dwóch obszarach. Oba limity są weryfikowane przez Azure w czasie wdrażania; zbyt niski limit powoduje błąd wdrożenia.

Limit	Co sprawdzić
Azure OpenAI tokens per minute (TPM)	W wybranym regionie Cognitive Services dla rodziny modeli, której zamierzają Państwo użyć. Limit jest wspólny dla wszystkich wdrożeń tej rodziny modeli w danej subskrypcji i regionie.
App Service compute	Wskazany rozmiar App Service Plan musi być dostępny w regionie wdrożeniowym. Nowe lub testowe subskrypcje często mają ograniczenie 0 dla wymaganej rodziny maszyn wirtualnych.

Limit modeli można sprawdzić w Azure Portal w sekcji Azure AI Foundry -> Quotas, bądź za pomocą polecenia:

az cognitiveservices usage list --location <region> --output table

Uwaga

Jeżeli dostępny limit jest niższy niż planowana pojemność wdrażanego rozwiązania, należy z wyprzedzeniem wystąpić o zwiększenie limitu. Wnioski o podwyższenie limitów są rozpatrywane przez Microsoft i wymagają czasu.

Wymagania dotyczące bazy danych

Wymagana jest baza danych służąca do przechowywania odpowiednich tabel wyników, a w szczególności:

• Baza Microsoft SQL Server lub Azure SQL Server, w której przechowywane są wyniki działań analitycznych dab Nexus
• Użytkownik bazy z uprawnieniami tylko do odczytu dla analizowanych przez AI Analyst tabel
• Connection string w formacie ADO.NET (lub ODBC) z aktywnym szyfrowaniem
• Zapewniona łączność sieciowa z Azure do tej bazy

Uwaga

Należy używać connection string bazy danych wykorzystywanej przez run analityczny, a nie dab Nexus application database.

Ważne

AI Analyst łączy się z bazą danych poprzez ruch wychodzący z własnej sieci wirtualnej. Przed wdrożeniem należy ustalić trasę sieciową wspólnie z zespołem administrującym bazą. Dostępne opcje ścieżki sieciowej omówione zostały w Przewodniku wdrożeniowym.

Informacje wymagane podczas wdrożenia

Przed rozpoczęciem pracy z kreatorem należy przygotować poniższe dane:

Wartość	Źródło
Subskrypcja, grupa zasobów oraz region	Państwo
Connection string do bazy danych	Państwo
Schemat bazowy tabel SQL	Państwo, domyślnie Results
Dozwolone zakresy adresów IP (notacja CIDR)	Dział IT, np. 203.0.113.0/27
AIA API Key	Generowany przez Państwa, minimum 32 znaki
Session Token Secret	Generowany przez Państwa, minimum 32 znaki
Knowledge Hub API Key	Dostarczany przez dab w ramach AIAnalyst License
Prywatna wiadomość żądania Link	Państwo, wykorzystywana przez dab do identyfikacji zapytania

Ważne

AIA API Key oraz Session Token Secret nie można później odczytać z wyników wdrożenia; należy je zawsze podać ponownie przy każdym ponownym wdrożeniu. Zaleca się utworzenie tych haseł i przechowywanie ich w menedżerze haseł przed rozpoczęciem procesu.