Skonfiguruj Web IQ

Konfigurowanie Web IQ obejmuje dwa połączone środowiska. Portal Azure to miejsce, w którym tworzysz zasób używany do rozliczeń i zarządzania. Web IQ portal łączy ten zasób z profilem aplikacji, udostępnia poświadczenia i umożliwia testowanie pobierania.

Tworzenie zasobu Azure

Na wysokim poziomie utwórz zasób w następujący sposób:

1. Zaloguj się do portalu Azure przy użyciu konta z uprawnieniami do tworzenia zasobów w ramach subskrypcji.
2. Wyszukaj Microsoft Web IQ i wybierz pozycję Utwórz.
3. Wybierz płatną subskrypcję i grupę zasobów, a następnie wprowadź nazwę zasobu. Jeśli zostanie wyświetlony monit o region, wybierz pozycję Global.
4. Przejrzyj i zaakceptuj warunki użytkowania Web IQ, a następnie wybierz pozycję Przejrzyj i utwórz i Utwórz.
5. Poczekaj na zakończenie wdrożenia i otwórz zasób.

Zasób Azure kojarzy użycie Web IQ z subskrypcją. Aplikacje bezpośrednio wywołują usługę Web IQ API; zasób Azure nie jest niestandardowym indeksem wyszukiwania ani wdrożeniem modelu.

Połącz zasób i uzyskaj identyfikator AppID

Następnie otwórz portal Web IQ bezpośrednio lub za pomocą pozycji Przejdź do portalu Web IQ na stronie zasobu Azure.

1. Wybierz pozycję Get Started i zaloguj się przy użyciu konta skojarzonego z subskrypcją.
2. Jeśli zostanie wyświetlony monit, podaj identyfikator dzierżawcy Microsoft Entra dla tej subskrypcji.
3. Wybierz tę samą subskrypcję i utworzony zasób Web IQ.
4. Ukończ nawiązywanie połączenia, wybierając pozycję Ukończ.
5. Upewnij się, że nowy Web IQ AppID jest wyświetlany w selektorze w lewym górnym rogu portalu.

Web IQ AppID identyfikuje profil Web IQ aplikacji. Określa dozwolone interfejsy API, limity szybkości, klucze interfejsu API i wszystkie powiązane identyfikatory klienta aplikacji Microsoft Entra. Zapisz identyfikator AppID dla konfiguracji klientów, które tego wymagają, i wybierz prawidłowy profil podczas testowania poświadczeń lub zarządzania nimi.

Testowanie w portalu Web IQ

Użyj Playground, aby sprawdzić pobieranie przed nawiązaniem połączenia z agentem:

1. Upewnij się, że wybrano zamierzony identyfikator AppID.
2. Wybierz dostępną metodę lub kategorię wyszukiwania, taką jak Sieć Web, Wiadomości, Obrazy lub Filmy wideo.
3. Wprowadź zapytanie, takie jak nazwa zespołu i „nadchodzące terminy trasy koncertowej”. Przejrzyj dostępne parametry, w tym język, region i limity wyników.
4. Wyślij żądanie i sprawdź odpowiedź JSON lub sformatowaną wersję zapoznawcza.
5. Sprawdź istotność, źródłowe adresy URL, daty i ilość zwracanej zawartości. Uściślij zapytanie lub ustawienia i porównaj wyniki.

Pomyślne żądanie potwierdza, że zasób, subskrypcja, identyfikator AppID i poświadczenia są połączone. Jeśli zasób nie jest wyświetlany, sprawdź, czy wybrano tego samego tenant i subskrypcję używaną podczas wdrażania. Dostępność metody zależy od usług włączonych w profilu.

Przygotowywanie danych logowania dla klientów

Aby szybko rozpocząć, otwórz pozycję Zarządzanie profilami w portalu Web IQ i uzyskaj klucz interfejsu API dla wybranego profilu. Klient REST lub MCP uwierzytelniany kluczem wysyła ten sekret w nagłówku x-apikey. Klucz należy już do jednego identyfikatora AppID; nie dodawaj parametru zapytania APPID do żądań uwierzytelnionych przy użyciu klucza.

W przypadku aplikacji produkcyjnych należy rozważyć uwierzytelnianie za pomocą Microsoft Entra ID. Zarejestruj aplikację, powiąż identyfikator aplikacji (klienta) z profilem Web IQ i skonfiguruj klienta w celu uzyskania tokenu dostępu dla Web IQ. Jeśli ten sam identyfikator klienta Entra jest powiązany z wieloma AppID aplikacji Web IQ, żądania uwierzytelnione za pomocą tokenu muszą określać zamierzony AppID aplikacji Web IQ przy użyciu parametru zapytania APPID.

Zachowaj poświadczenia w ustawieniach bezpiecznego połączenia lub w menedżerze sekretów, a nie w instrukcjach agenta, kodzie źródłowym lub aplikacjach po stronie przeglądarki.

Aby uzyskać szczegółowe wskazówki dotyczące konfiguracji, zobacz Wdrażanie Microsoft Web IQ przy użyciu portalu Azure i Uwierzytelnianie za pomocą Microsoft Web IQ.