Wdrażanie dab AI Analyst

Wskazówka

Proszę najpierw zapoznać się z wymaganiami systemowymi. Większość problemów z wdrożeniem wynika z pominięcia przygotowania wymaganego komponentu.

Przed rozpoczęciem

dab AI Analyst wdraża się z Azure Marketplace jako zarządzaną aplikację Azure. Proces wdrożenia obejmuje sześć zakładek konfiguracyjnych oraz końcowy krok Review + create, które należy wykonać po kolei. Przed rozpoczęciem należy potwierdzić poniższe punkty:

• dab Nexus jest już używany
• Klucz AI Analyst License przekazany przez dab jako część AI Analyst License jest dostępny; szczegóły w https://knowledge.dab-europe.com/portal/license-management
• Wybrano docelową subskrypcję Azure
• Zarejestrowano wymaganych providerów zasobów
• Użytkownik wdrażający posiada Owner lub Contributor oraz uprawnienia roli User Access Administrator
• W wybranych regionach dostępny jest limit App Service compute
• Dostępny jest connection string do bazy danych przechowującej wyniki analiz Nexus
• W wybranych regionach dostępny jest limit Azure Foundry LLM deployment

Uwaga

Connection string do bazy danych powinien wskazywać na bazę wykorzystywaną przez cykl dab AnalyticSuite, a nie bazę aplikacyjną dab Nexus.

Otwieranie oferty w Marketplace

dab AI Analyst jest opublikowany jako oferta publiczna w Azure Marketplace i należy go wybrać.

1. Podstawowe ustawienia

Na tej zakładce określa się miejsce utworzenia aplikacji oraz jej zasobów.

Pole	Co wprowadzić
Subskrypcja	Subskrypcja Azure, w której wdrażany jest AI Analyst
Grupa zasobów	Nowa lub istniejąca grupa zasobów dla zarządzanej aplikacji
Region	Region Azure dla wirtualnej sieci, Key Vault oraz App Service
Nazwa aplikacji	Nazwa dla zarządzanej aplikacji
Grupa zasobów zarządzanych	Grupa zasobów zawierająca zasoby tej aplikacji

Wskazówka

Zalecamy wybór regionu położonego blisko Państwa bazy danych. Wybrany tu region nie określa lokalizacji wdrożenia modelu AI — tę wybiera się osobno w kroku 6.

2. Ustawienia aplikacji

Na tej zakładce określa się ogólne parametry wdrożenia.

2.1 Rozmiar planu App Service

Należy wybrać rozmiar planu App Service dla AI Analyst. Jest to backend AI Analyst, obsługujący agentów działających na wdrożonym modelu Azure AI Foundry. W przyszłości skalowanie planu w górę lub w dół można przeprowadzić bez ponownego wdrażania.

SKU	Rdzenie	RAM	Zalecane do
P1v3	2	8 GB	Zalecany domyślny wybór
P1mv3	2	16 GB	Wymagające pamięci obciążenia
P1v4	2	8 GB	Najnowsza generacja, porównywalna z P1v3
P2v4	4	16 GB	Wiele równoczesnych użytkowników
P3v4	8	32 GB	Skala korporacyjna

Zalecamy rozpocząć od P1v3, skalując plan w górę tylko w razie potrzeby ze względu na wydajność.

2.2 Sekrety

Oba sekrety to wartości definiowane przez Państwa.

Pole	Cel zastosowania
AIA API Key	Bezpieczna komunikacja pomiędzy AI Analyst Visual w PowerBi Dashboard a backendem AI Analyst. Każdy klient wywołujący API wymaga tego klucza.
Session Token Secret	Służy do podpisywania sesji użytkowników, umożliwiając aplikacji weryfikację zalogowania. Użytkownicy nigdy nie widzą tej wartości.

Każda wartość powinna mieć minimum 32 znaki i należy je przechowywać, ponieważ będą potrzebne po wdrożeniu.

Wskazówka

Do generowania i przechowywania sekretów warto użyć menedżera haseł.

Ważne

Dozwolone są wyłącznie znaki A-Z, a-z i 0-9. Użycie takich znaków jak ;, ", &, % lub spacji może prowadzić do błędów przy parsowaniu nagłówków HTTP i dalszej konfiguracji.

3. Bezpieczeństwo sieciowe

Domyślnie AI Analyst i wymagane przez niego usługi dostępne są tylko poprzez własną sieć wirtualną. Na tej zakładce określa się, czy dostęp do aplikacji mogą uzyskać również użytkownicy spoza tej sieci, np. z biura korporacyjnego.

Pole	Co wprowadzić
Dodaj adresy IP do allowlisty	Yes, jeśli użytkownicy mają uzyskiwać dostęp do AI Analyst spoza sieci wirtualnej; w innym przypadku No
Dopuszczalne zakresy IP (CIDR)	Dozwolone zakresy IP w notacji CIDR, rozdzielone przecinkami, np. 203.0.113.0/27, 198.51.100.42/32

Warto dodać zakres adresów IP Państwa biura — dzięki temu zyskają Państwo dostęp do interfejsu AI Analyst oraz możliwość odczytu sekretów Key Vault w Azure Portal. W późniejszym czasie allowlistę można edytować w Azure Portal w sekcji App Service -> Networking -> Ograniczenia dostępu.

Uwaga

W przypadku wybrania No API pozostanie niedostępne spoza sieci wirtualnej; konieczne będzie skonfigurowanie połączenia z tą siecią, np. poprzez peering sieciowy.

4. Połączenie z bazą danych

Na tej zakładce definiuje się bazę danych, do której zapytania kieruje AI Analyst. Wartość zapisywana jest w Key Vault po wdrożeniu i nie trafia nigdy do logów ani ustawień aplikacji.

Pole	Co wprowadzić
Connection string do bazy danych	Connection string do bazy przechowującej wyniki analiz
Schemat bazowej tabeli SQL	Schemat, do którego dab Nexus eksportuje wymagane przez AI Analyst tabele; domyślnie Results

Obsługiwane są następujące formaty connection string:

• Format ADO.NET (zalecany):

  Server=tcp:myserver.database.windows.net,1433;Database=mydb;User ID=myuser;Password=mypassword;Encrypt=yes;TrustServerCertificate=no;

• Alternatywnie format ODBC:

  Driver={ODBC Driver 18 for SQL Server};Server=tcp:myserver.database.windows.net,1433;Database=mydb;Uid=myuser;Pwd=mypassword;Encrypt=yes;TrustServerCertificate=yes;

Obsługiwane metody uwierzytelniania:

• Użytkownik SQL i hasło (zalecane) — należy utworzyć dedykowanego, tylko do odczytu użytkownika SQL dla dab AI Analyst i podać jego dane w connection string jak powyżej. Ten mechanizm działa od razu i nie wymaga dodatkowej konfiguracji.
• Managed identity (opcjonalnie) — alternatywnie, uwierzytelnianie może się odbywać przy użyciu managed identity przypisanego do Managed Application. Wtedy w connection string nie podaje się User ID/Password, a należy użyć Authentication=Active Directory Managed Identity. Wymaga to własnoręcznego przygotowania po wdrożeniu: konieczne jest utworzenie użytkownika na poziomie bazy oraz przyznanie mu uprawnień do odczytu. Powinno się wybrać tę opcję wyłącznie jeśli wymaga tego polityka organizacyjna.

Ostrzeżenie

Ze względu na wykorzystanie Generative AI należy dopilnować, by użytkownik pozwalający dab AI Analyst na dostęp do danych miał uprawnienia wyłącznie do odczytu.

Ważne

Baza danych musi być osiągalna z poziomu Azure App Service, aby dab AI Analyst działał poprawnie. Jeżeli baza nie jest publicznie dostępna, należy samodzielnie skonfigurować jej dostępność po wdrożeniu.

Brak dostępu do bazy nie uniemożliwia wdrożenia. Aplikacja uruchomi się, zaloguje Database warm-up failed i pozostanie nieużyteczna, dopóki nie zostaną poprawione ustawienia sieciowe. Przed dniem wdrożenia warto potwierdzić ścieżkę sieciową z zespołem zarządzającym bazą danych.

5. Konfiguracja modelu AI

Na tej zakładce określa się model Azure OpenAI, na którym AI Analyst dokonuje rozumowania oraz ilość dostępnych zasobów.

Pole	Co wprowadzić
Region Cognitive Services	Region, w którym wdrożono model. Musi być tam dostępny limit dla wybranego modelu. Zalecamy rezerwację 1,2 mln tokenów na minutę na każde 10 użytkowników.
Model	Model wykorzystywany przez AI Analyst. Lista obejmuje tylko modele dostępne w wybranym regionie.
Pojemność (Quota Units)	Przepustowość zarezerwowana dla AI Analyst. Jedna jednostka to 10 000 tokenów na minutę.

Rekomendujemy model gpt5.6-luna, który zapewnia wysoką jakość rozumowania przy niskim koszcie; gpt5.6-terra wypada nieco lepiej, ale jest wyraźnie droższy. Wybierając region, warto wybrać najbliższy miejsca wdrożenia i posiadający wolny limit dla danego modelu.

Ważne

Pojemność jest współdzielona między wszystkimi wdrożeniami tej samej rodziny modeli w ramach subskrypcji i regionu. W przypadku żądania większej pojemności niż dostępna, wdrożenie zakończy się błędem. Proszę zacząć od niskiej wartości i zwiększać ją później w Azure Portal.

5.1. Pojemność modelu AI

5.2. Wydajność modelu AI

6. Licencja i Knowledge Hub

AI Analyst wzbogaca odpowiedzi o ekspertyzę SAP oraz analiz dzięki dab Knowledge Hub. Ta zakładka umożliwia połączenie wdrożenia z tą usługą przez prywatny Link — ruch sieciowy nie opuszcza internetu publicznego.

Pole	Co wprowadzić
Knowledge Hub API Key	Klucz licencyjny otrzymany z dab
Prywatny Link - wiadomość z prośbą	Wiadomość identyfikująca zgłoszenie (firma i osoba odpowiedzialna), np. Contoso AG (m.mustermann(at)cag.com) - productive AI Analyst deployment

Uwaga

Prywatne połączenie Link utworzy się w stanie Pending i wymaga zatwierdzenia przez dab. AI Analyst nie będzie w pełni działać bez tej akceptacji.

Ostrzeżenie

Prywatna wiadomość Link, która nie zawiera nazwę firmy lub osoby odpowiedzialnej, zostanie odrzucona.

Weryfikacja i wdrożenie

Azure zweryfikuje wszystkie parametry oraz wyświetli podsumowanie. Proszę sprawdzić, czy wszystkie sekrety są poprawnie wpisane, regiony i model się zgadzają oraz connection string jest kompletny. Następnie należy kliknąć Create. Proces wdrożenia zajmuje około trzy do pięciu minut.

Wskazówka

Po wdrożeniu należy przejść do Po wdrożeniu, aby sprawdzić poprawność działania i złożyć wniosek o akceptację prywatnego Link.