Microsoft Web IQ — Często zadawane pytania

Odpowiedzi na często zadawane pytania dotyczące korzystania z Microsoft Web IQ. Aby uzyskać szczegółowe informacje o interfejsie API i przykłady żądań, zobacz dokumentację interfejsu API.

Serwis i wdrażanie

Co to jest Microsoft web IQ?

Microsoft Web IQ to zestaw natywnych dla sztucznej inteligencji interfejsów API wyszukiwania w sieci i groundingu, które zapewniają maszynom LLM, agentom sztucznej inteligencji i aplikacjom dostęp do bieżących, odpowiednich informacji internetowych. Umożliwia to dokładniejsze i aktualne odpowiedzi SI ze źródłami, które użytkownicy mogą zweryfikować. Usługa Web IQ napędza wiodących asystentów sztucznej inteligencji, w tym Microsoft Copilot i ChatGPT.

Web IQ jest dostępny za pośrednictwem interfejsu REST pod adresem https://api.microsoft.ai/v3 i za pośrednictwem protokołu MCP pod adresem https://api.microsoft.ai/v3/mcp. Każdy Web IQ AppID może wywoływać funkcje Web Search, News, Images, Videos i Browse. Auto (beta) jest włączone dla identyfikatora AppID na żądanie: otwórz zgłoszenie do Web IQ Support.

Co to jest uziemienie w sieci i kiedy agent sztucznej inteligencji go potrzebuje?

Osadzanie w sieci zapewnia AI dostęp do najnowszych informacji z internetu, dzięki czemu może ono odpowiadać z wykorzystaniem aktualnych faktów wykraczających poza dane treningowe, wraz z cytowanymi źródłami, które użytkownicy mogą sprawdzić. Jest to najbardziej pomocne w przypadku często zmieniających się informacji, takich jak rozwój rynku, aktywność konkurencji, wiadomości i aktualizacje regulacyjne.

Czy web IQ to LLM? Czy generuje ostateczną odpowiedź?

No. Web IQ nie jest modelem AI ani LLM. Jest to pakiet natywnych dla sztucznej inteligencji internetowych interfejsów API wyszukiwania i groundingu, które zapewniają modelom LLM, agentom sztucznej inteligencji i aplikacjom dostęp do bieżących, odpowiednich informacji z internetu.

Web IQ nie generuje ostatecznej odpowiedzi AI. Pobiera odpowiednie informacje z Internetu, a wybrana logika LLM, agent sztucznej inteligencji lub logika aplikacji używa tych informacji do wygenerowania odpowiedzi.

Co sprawia, że Web IQ różni się od innych interfejsów API wyszukiwania w Internecie i usług ugruntowania?

Większość interfejsów API wyszukiwania w Internecie wymusza kompromis: szybkie albo dokładne, opłacalne albo kompletne. W opublikowanym przez Microsoft porównaniu Web IQ zapewnia najwyższy poziom satysfakcji z odpowiedzi ugruntowanych w źródłach, najszybszą szybkość i najmniejszą liczbę tokenów na zapytanie. Jest to ta sama platforma, na której asystenci AI, tacy jak Copilot i ChatGPT, polegają każdego dnia, sprawdzona na skalę globalną i gotowa, by każdy agent lub aplikacja AI mogły na niej bazować.

Web IQ wyróżnia się także tym, w jaki sposób uzyskuje dostęp do zawartości. Przyjmuje odpowiedzialne podejście do dostępu do internetu, łącząc otwarty internet i ustrukturyzowane dane z wbudowanymi zabezpieczeniami i ochroną klasy korporacyjnej.

Web IQ współpracuje z już używanym stosem AI. Możesz użyć preferowanego modelu sztucznej inteligencji i połączyć się za pośrednictwem interfejsu API REST lub protokołu MCP (Model Context Protocol), bez powiązania z jednym modelem lub platformą.

Źródło: Wyniki testów porównawczych Web IQ (sekcje jakości, wydajności i szybkości).

Co mogę zbudować za pomocą Web IQ?

Usługa Web IQ napędza agentów i aplikacje sztucznej inteligencji, które potrzebują nowych, zewnętrznych informacji z publicznej sieci Web. Zespoły wewnętrzne mogą jej używać do analizy konkurencyjnej, monitorowania, badań regulacyjnych, wywiadu sprzedażowego i optymalizacji zawartości. Interakcje skierowane do klientów mogą używać go do badań, odkrywania, rekomendacji oraz do obsługi wyspecjalizowanych agentów.

Najlepiej nadaje się do scenariuszy, w których informacje zmieniają się często, obejmują wiele źródeł zewnętrznych i muszą opierać się na bieżącej, źródłowej zawartości internetowej.

Które Web IQ API najlepiej odpowiada moim potrzebom?

Użyj Web Search API, aby znaleźć odpowiednie publiczne strony i fragmenty dla modelu, News API dla bieżących wydarzeń, interfejsów API Images i Videos dla wyników graficznych i wideo oraz Browse API, gdy znasz już adres URL. Zapoznaj się z dokumentacją interfejsu API, aby zapoznać się z możliwościami i limitami dostępnymi dla Twojego konta.

Czy mogę używać Web IQ z istniejącym modelem AI i frameworkiem agentów?

Yes. Web IQ umożliwia dodawanie informacji internetowych do wybranego modelu AI i wybranego przepływu pracy agenta. Interfejsy API REST i MCP zapewniają elastyczność w sposobie połączenia. Zapoznaj się z dokumentacją SDK i integracji MCP, aby zapoznać się z obsługiwanymi konfiguracjami.

Jak wygląda integracja?

Agent sztucznej inteligencji lub aplikacja wywołuje Web IQ w celu uzyskania danych z internetu, a następnie przekazuje wybrane wyniki do modelu w celu wygenerowania odpowiedzi. Możesz kontrolować sposób wybierania, użycia i cytowania informacji. Postępuj zgodnie z przewodnikiem Szybki start, aby połączyć swój pierwszy przepływ pracy lub rozpocząć pracę z Playground.

Czy Web IQ może uzyskiwać prywatne informacje firmy?

No. Web IQ pobiera informacje z publicznej sieci Web. W kontekście przedsiębiorstwa Microsoft oferuje Work IQ, Fabric IQ i Foundry IQ, z których każdy pełni inną rolę, od kontekstu organizacyjnego po dane biznesowe i wiedzę przedsiębiorstwa.

W jaki sposób usługa Web IQ odnosi się do Foundry IQ, Work IQ i Fabric IQ?

Microsoft IQ łączy cztery zintegrowane warstwy, które zasilają inteligencję przedsiębiorstwa w Microsoft. Web IQ udostępnia informacje z publicznej sieci Web. Work IQ koncentruje się na sygnałach związanych z pracą, Fabric IQ na danych biznesowych, a Foundry IQ na wiedzy organizacyjnej. Te produkty zaspokajają różne potrzeby informacyjne agentów AI i aplikacji i są najbardziej wydajne, gdy są używane razem.

Czy Web IQ jest zasobem Azure?

Wdrażasz zasób Web IQ w ramach subskrypcji Azure. Zasób obsługuje pomiary i rozliczenia. Tożsamością aplikacji w Web IQ jest jej identyfikator aplikacji Web IQ (AppID), utworzony podczas łączenia zasobu w portalu Web IQ.

Sama usługa jest hostowana przez firmę Microsoft i jest wielodostępna. Pobieranie i klasyfikowanie w sieci Web są uruchamiane w infrastrukturze Microsoft, a aplikacja wywołuje api.microsoft.ai za pośrednictwem protokołu HTTPS. Zasób Azure nie hostuje Web IQ i nie znajduje się w ścieżce żądania.

Jaka jest różnica między zasobem Web IQ a identyfikatorem AppID Web IQ?

Zasób Web IQ to zasób Azure tworzony w ramach subskrypcji Azure w portalu Azure lub za pomocą Azure CLI. Użycie Web IQ jest mierzone i rozliczane w ramach subskrypcji za jej pośrednictwem. Zasób nie znajduje się w ścieżce żądania: aplikacja wywołuje api.microsoft.ai bezpośrednio.

Web IQ AppID to tożsamość aplikacji w Web IQ. Jest on tworzony podczas łączenia zasobu Web IQ w portalu Web IQ. Wszystko, co dotyczy sposobu używania Web IQ przez aplikację, jest ustawiane w AppID: które interfejsy API może wywoływać, limit szybkości (domyślnie 15 QPS), klucze interfejsu API i powiązane z nią identyfikatory aplikacji Entra (klienta). Nie należy mylić jej z identyfikatorem aplikacji Entra (klienta) rejestracji aplikacji: ten identyfikator identyfikuje aplikację wobec Microsoft Entra ID, gdy uzyskuje token, i jest on powiązany z identyfikatorem aplikacji internetowej IQ AppID.

Połączenie zasobu powoduje utworzenie identyfikatora AppID, więc większość klientów zaczyna od jednego z każdego. Jeśli potrzebujesz więcej niż jednego identyfikatora AppID, na przykład po jednym dla każdego środowiska lub obciążenia, Twój przedstawiciel firmy Microsoft może poinformować Cię o dostępnych opcjach.

Gdzie wdrożono Web IQ?

Web IQ jest hostowany przez firmę Microsoft i dostępny za pośrednictwem publicznego https://api.microsoft.ai/v3 punktu końcowego. Aplikacja wywołuje interfejs API, a Web IQ wykonuje pobieranie po stronie serwera.

Czy istnieją dedykowane interfejsy API dla finansów, sportu lub pogody?

Nie ma dedykowanego API dla finansów, sportu ani pogody. W przypadku pogody auto zwraca ustrukturyzowane wyniki pogody (bieżące warunki, prognozy dzienne i aktywne alerty pogodowe z linkiem do urzędu wystawiającego) gdy zapytanie dotyczy pogody. W przypadku finansów, sportu i innych tematów użyj funkcji Web Search, która zwraca odpowiednie zindeksowane treści jako tekst strony bez struktury, a nie ustrukturyzowany strumień danych.

Dostęp i wdrożenie

Jak przejść z oceny do środowiska produkcyjnego?

1. Ukończ ocenę i potwierdź, że usługa spełnia Twoje wymagania.
2. Utwórz zasób Web IQ w płatnej subskrypcji Azure, a następnie zaloguj się do Witryny klienta Web IQ i połącz zasób. Spowoduje to utworzenie produkcyjnego identyfikatora AppID, który rozpoczyna się od domyślnego limitu 15 zapytań na sekundę (QPS).
3. Aby uwierzytelnić się przy użyciu Microsoft Entra ID, powiąż identyfikator aplikacji Entra (klienta) rejestracji aplikacji z tym identyfikatorem appID w witrynie klienta internetowego IQ.

Korzystanie z Web IQ podlega warunkom użytkowania Web IQ w kontekście Twojego istniejącego Umowa z Klientem Microsoft.

Których subskrypcji Azure mogę użyć?

Usługa Web IQ wymaga płatnej subskrypcji Azure, w tym subskrypcji zakupionych za pośrednictwem partnera Dostawca rozwiązań w chmurze (CSP). Visual Studio, bezpłatna wersja próbna i subskrypcje studenckie oraz kredyty Azure nie działają w przypadku Web IQ. Jeśli utworzenie zasobu Web IQ jest zablokowane ze względu na status konta Azure, zostanie wyświetlony komunikat o błędzie z prośbą o skontaktowanie się z zespołem ds. konto Microsoft, który może zażądać przeglądu.

Które interfejsy API może wywoływać moja aplikacja?

Każdy Web IQ AppID może wywoływać funkcje Web Search, News, Images, Videos i Browse. Auto jest włączone dla identyfikatora AppID na żądanie: otwórz zgłoszenie do pomocy technicznej Web IQ. Aby zobaczyć, które interfejsy API może wywoływać identyfikator AppID, zaloguj się do portalu Web IQ, przejdź do pozycji Zarządzanie profilami, wybierz swój identyfikator AppID według nazwy z listy rozwijanej w lewym górnym rogu i sprawdź pozycję Dozwolone usługi.

Którego adresu należy użyć do zalogowania?

Użyj adresu logowania do konta Microsoft, który ma dostęp do Web IQ: adresu udostępnionego Ci przez Microsoft lub konta użytego do połączenia zasobu Web IQ w Witrynie klienta Web IQ. Jest to zwykle adres używany w przypadku Azure, usługi Teams lub pakietu Office, który może różnić się od adresu e-mail skrzynki pocztowej.

Aby to potwierdzić, zaloguj się do portalu Azure i sprawdź adres w prawym górnym rogu.

Dlaczego logowanie mówi, że nie mam dostępu?

Najpierw upewnij się, że adres wyświetlany w prawym górnym rogu portalu Azure dokładnie odpowiada adresowi, który ma dostęp do Web IQ. Organizacje często używają jednego adresu do logowania Microsoft i innego na potrzeby poczty e-mail.

Jeśli adresy są takie same, organizacja może zablokować dostęp gościa między dzierżawcami do dzierżawcy Microsoft Corporation. Poproś administratora IT, aby umożliwił ten dostęp.

Gdzie mogę uzyskać pomoc?

Odwiedź witrynę pomocy technicznej Microsoft Web IQ, aby uzyskać pomoc dotyczącą produktu. W przypadku pytań dotyczących dozwolonego użytkowania, prywatności, przechowywania lub wyświetlania zapoznaj się z bieżącymi warunkami użytkowania Web IQ i odpowiednią umową klienta.

Uwierzytelnianie interfejsu API

Jakie metody uwierzytelniania są obsługiwane?

Web IQ obsługuje następujące elementy:

• tokeny okaziciela Microsoft Entra ID uzyskiwane za pośrednictwem przepływu poświadczeń klienta OAuth 2.0. Jest to zalecane w przypadku obciążeń produkcyjnych.
• Klucze interfejsu API wysyłane w nagłówku x-apikey żądania.

Cały ruch interfejsu API używa protokołu HTTPS.

Jak skonfigurować uwierzytelnianie serwer-serwer?

Zarejestruj aplikację w Microsoft Entra ID i użyj przepływu poświadczeń klienta OAuth 2.0. Powiąż identyfikator aplikacji Entra (klienta) rejestracji aplikacji z Web IQ AppID w witrynie Web IQ Customer Site, uzyskaj token dostępu i wyślij go jako Authorization: Bearer <access_token>.

Zobacz Uwierzytelnianie, aby zapoznać się z pełną instrukcją konfiguracji.

Czy mogę zarządzać własnymi kluczami interfejsu API?

Yes. Możesz utworzyć dowolną liczbę kluczy interfejsu API z poziomu Web IQ Customer Site. Za tworzenie kluczy nie są naliczane opłaty.

Czy Web IQ używa kontroli dostępu opartej na rolach platformy Azure na potrzeby autoryzacji interfejsu API?

No. Web IQ to usługa hostowana przez firmę Microsoft, z której korzystasz przez Internet. Zasób Web IQ wdrożony w subskrypcji Azure obsługuje pomiary i rozliczenia, ale nie znajduje się w ścieżce żądania, więc nie ma zasobu usługi, do którego można przypisać role RBAC platformy Azure.

Web IQ autoryzuje żądania według identyfikatora AppID. Każdy identyfikator AppID ma własny profil kwalifikowalności treści i limit, a nieautoryzowane wywołania zwracają HTTP 403. Aby oddzielić zespoły lub obciążenia, na przykład przy użyciu różnych zasad dostępu lub limitów przydziału, użyj wielu identyfikatorów AppID.

Czy jeden identyfikator aplikacji Entra (klienta) może odwoływać się do więcej niż jednego identyfikatora aplikacji internetowej Web IQ AppID?

Yes. Pojedynczy identyfikator aplikacji Entra (klienta) może uzyskać autoryzację do wywoływania co najmniej jednego identyfikatora AppID. Aby wybrać identyfikator AppID, przekaż go jako parametr zapytania, na przykład https://api.microsoft.ai/v3/search/web?APPID=<your-web-iq-appid>. Interfejs API rozpoznaje identyfikator AppID w następujący sposób:

• Identyfikator aplikacji Entra (klienta) jest powiązany z jednym identyfikatorem AppID: jeśli nie określisz identyfikatora appID lub określisz ten identyfikator AppID, żądanie zakończy się powodzeniem (HTTP 200). Jeśli określisz inny identyfikator AppID, żądanie zwróci błąd HTTP 403.
• Identyfikator aplikacji Entra (klienta) jest powiązany z kilkoma identyfikatorami AppID: musisz określić jeden. Brak lub pusty identyfikator AppID zwraca błąd HTTP 400; jeden z powiązanych identyfikatorów AppID kończy się powodzeniem (HTTP 200); każdy inny identyfikator AppID zwraca http 403.
• Identyfikator aplikacji Entra (klienta) nie jest powiązany z żadnym identyfikatorem AppID: żądanie zwraca błąd HTTP 401.

Uwierzytelnianie kluczem API (x-apikey) pozostaje bez zmian. Każdy klucz interfejsu API jest powiązany z jednym identyfikatorem AppID, więc APPID nigdy nie jest potrzebny ani akceptowany w przypadku wywołań uwierzytelnionych za pomocą klucza.

Jakiego uwierzytelniania powinien używać hostowany agent: Managed Identity lub AgentID?

Oba działają. Tożsamość zarządzana i AgentID są tożsamościami Entra ID, a Web IQ akceptuje dowolną tożsamość Entra ID, której identyfikator aplikacji Entra (klienta) jest powiązany z Web IQ AppID ze strony Zarządzanie profilami w witrynie klienta Web IQ.

To, którego używasz, zależy od tego, gdzie jest hostowany agent:

• Tożsamość zarządzana pasuje do agentów uruchamianych w infrastrukturze Azure, takiej jak Foundry, App Service, Container Apps, AKS, Functions lub maszyny wirtualne. Tożsamości przypisane przez system i przypisane przez użytkownika działają.
• Identyfikator agenta jest odpowiedni dla agentów hostowanych w Foundry lub Copilot Studio, które uwidaczniają tożsamość agenta.
• Agenci hostowani poza Azure, na przykład na własnym klastrze Kubernetes lub w innej chmurze, mogą używać standardowej rejestracji aplikacji Entra z wpisem tajnym klienta lub poświadczeniami federacyjnymi.

W każdym przypadku wywołanie używa przepływu poświadczeń klienta OAuth 2.0 i wysyła token jako Authorization: Bearer <access_token>. Zobacz Uwierzytelnianie , aby zapoznać się z krokami konfiguracji. Klucz interfejsu API w nagłówku x-apikey pozostaje prostszą opcją dla prototypów.

Sieć i zabezpieczenia

Czy Web IQ obsługuje Private Link, prywatne punkty końcowe, integrację z siecią wirtualną lub listę dozwolonych adresów IP?

No. Żadna z tych funkcji nie jest obecnie obsługiwana. Dostęp do Web IQ jest uzyskiwany za pośrednictwem jednego publicznego punktu końcowego, https://api.microsoft.ai/v3, za pośrednictwem protokołu HTTPS z Entra ID lub uwierzytelnianiem klucza interfejsu API. W punkcie końcowym interfejsu API nie ma kontroli dostępu opartej na adresie IP.

Zasób Web IQ w subskrypcji Azure obsługuje pomiar użycia i rozliczenia, ale nie znajduje się w ścieżce żądania, dlatego mechanizmy kontroli sieci platformy Azure, takie jak Private Link, integracja z siecią wirtualną, Azure Firewall, sieciowe grupy zabezpieczeń i topologie typu piasta-szprychy, po stronie Web IQ nie mają elementu, do którego można je podłączyć. Integracja tożsamości (Entra ID) jest zgodna z platformą Azure; warstwa sieciowa nie jest.

Po twojej stronie zezwól na nazwę hosta api.microsoft.ai w kontrolach ruchu wychodzącego.

Czy ruch z Azure do sieci Web IQ pozostaje w sieci firmy Microsoft lub w sieci szkieletowej Azure?

Nie jest to gwarantowane. Klienci łączą się z publicznym https://api.microsoft.ai punktem końcowym, a ruch jest zabezpieczony podczas przesyłania za pomocą protokołu HTTPS.

Ruch internetowy interfejsu API Web IQ jest terminowany w usłudze Azure Front Door, która obsługuje protokoły TLS 1.2 i TLS 1.3 z następującymi zestawami szyfrów:

• TLS 1.3: TLS_AES_256_GCM_SHA384, TLS_AES_128_GCM_SHA256
• TLS 1.2: TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384, TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256, TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384, TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256

Czy narzędzie do inspekcji ruchu wychodzącego Zscaler lub inne narzędzie do inspekcji ruchu wychodzącego zakłóca działanie Web IQ?

Nie powinno zakłócać działania, gdy jest skonfigurowane do zezwalania na połączenia z usługą api.microsoft.ai. Jest to standardowe działanie dodania do listy dozwolonych, a nie ogólne pominięcie zabezpieczeń. To samo podejście dotyczy innych bezpiecznych bram internetowych, takich jak Netskope.

Czy mogę umieścić Web IQ za usługą Azure API Management?

Yes. Możesz umieścić Azure API Management lub inną bramę przed usługą Web IQ we własnej subskrypcji Azure w celu monitorowania i zapewnienia nadzoru, a nie są znane żadne ograniczenia uniemożliwiające takie wdrożenie. Wywołania interfejsu API przechodzą od obiektu wywołującego do https://api.microsoft.ai/v3 przez protokół TLS przy użyciu klucza interfejsu API lub tokenu Entra ID, więc wszystko, co zostało umieszczone przed tym ruchem, jest Twoją własną infrastrukturą w Twojej dzierżawie. Microsoft nie publikuje architektury referencyjnej dla tych wdrożeń; zespół architektury chmury odpowiada za ten projekt architektury.

Zgodnie z Warunkami korzystania z Web IQ nie można buforować ani przechowywać zawartości odpowiedzi w celu utworzenia pochodnego zestawu danych, niezależnie od tego, co robi brama. Dane telemetryczne operacyjne, takie jak stan, opóźnienie, nagłówki i identyfikatory śledzenia, mogą być zachowywane, na przykład w usłudze Application Insights lub Log Analytics.

Jakie mechanizmy kontroli zabezpieczeń są dostępne?

• Uwierzytelnianie: Entra ID (poświadczenia klienta OAuth 2.0) lub klucz interfejsu API.
• Autoryzacja: dostęp per-AppID do interfejsów API. Nieautoryzowane wywołania zwracają HTTP 403.
• Ograniczanie szybkości: wymuszanie limitu przydziału dla identyfikatora AppID. Żądania przekraczające limit powodują zwrócenie kodu HTTP 429.
• Transport: tylko protokół HTTPS.

Polityka sieciowa na twoim perymetrze jest Twoją odpowiedzialnością. Jeśli masz określone wymagania dotyczące architektury, które chcesz poddać ocenie, skontaktuj się z Web IQ Support.

Limity szybkości i klucze interfejsu API

Czy istnieje limit żądań?

Yes. Każdy Web IQ AppID ma domyślny limit 15 zapytań na sekundę (QPS). Zasób Web IQ zwykle ma jeden identyfikator AppID utworzony podczas łączenia zasobu. Web IQ Customer Site wyświetla limit.

Limit jest współdzielony dla wszystkich kluczy interfejsu API i powiązanych identyfikatorów aplikacji Entra (klienta) dla tego identyfikatora AppID. Żądania przekraczające limit powodują zwrócenie kodu HTTP 429.

Czy mogę zwiększyć limit żądań?

Yes. Każdy Web IQ AppID obsługuje od 15 QPS. Aby zażądać wyższego limitu, otwórz zgłoszenie do pomocy technicznej Web IQ z oczekiwanym ruchem i przypadkiem użycia.

Ile kluczy interfejsu API można utworzyć?

Możesz utworzyć dowolną liczbę kluczy zgodnie z potrzebami aplikacji. Tworzenie klucza jest bezpłatne, ale wszystkie klucze dla jednego identyfikatora AppID współdzielą limit liczby żądań.

Ochrona prywatności i obsługa danych

Czy Web IQ rejestruje zapytania API?

Yes. Żądania interfejsu API są rejestrowane w celach operacyjnych: zapewnienie niezawodności usługi, debugowanie i ulepszanie jakości. Jest to standard dla usług Microsoft.

• Dostęp jest ograniczony do autoryzowanych pracowników działów inżynierii i operacji firmy Microsoft i podlega wewnętrznym zasadom kontroli dostępu Microsoft. Dane w dziennikach nie są dostępne dla innych klientów ani stron trzecich.
• Dzienniki są przechowywane w infrastrukturze produkcyjnej Microsoft i podlegają standardowym mechanizmom kontroli zabezpieczeń Microsoft, w tym kontroli dostępu opartej na rolach i dziennikach inspekcji.
• Dzienniki są szyfrowane podczas przesyłania (HTTPS) i podczas przechowywania zgodnie ze standardowymi praktykami szyfrowania firmy Microsoft.

Microsoft działa jako administrator danych zgodnie z Oświadczeniem o ochronie prywatności firmy Microsoft.

Jak długo są przechowywane zapytania?

Przechowywanie danych telemetrycznych dotyczących zapytań podlega sekcji 4 dokumentu Web IQ Terms of Use, co oznacza, że przetwarzanie przez Microsoft podlega postanowieniom Microsoft Privacy Statement. Nie ma oddzielnego zobowiązania dotyczącego okresu przechowywania specyficznego dla Web IQ poza tym, co opisano w Oświadczeniu o ochronie prywatności.

Czy mogę wyłączyć rejestrowanie zapytań dla obciążeń regulowanych lub poufnych?

Tekst zapytania jest rejestrowany w ramach standardowej telemetrii żądania, a jego przetwarzanie podlega Oświadczeniu o ochronie prywatności firmy Microsoft i sekcji 4 Warunków użytkowania usługi Web IQ.

Jeśli masz konkretny wymóg regulacyjny lub dotyczący zgodności, usługa Web IQ oferuje Zero Query Logging, które nie zapisuje tekstu zapytania w telemetrii. Zapytanie jest nadal wysyłane do Microsoft w celu obsługi żądania; Zero Query Logging przechowuje tekst zapytania z naszych dzienników. Nie jest to funkcja samoobsługowa: nasz zespół produktowy włącza ją dla Ciebie, dla wszystkich Twoich aplikacji lub tylko konkretnych aplikacji. Aby go zażądać, skontaktuj się z zespołem ds. kont Microsoft i udostępnij:

• Stosowane ramy regulacyjne lub dotyczące zgodności (na przykład GLBA, HIPAA, RODO lub APPI).
• Krótki opis scenariusza wdrażania.

W przypadku rejestrowania bez zapytań tekst zapytania, tytuły wyników i adresy URL, adres IP i identyfikator aplikacji Entra nie są przechowywane. Identyfikator aplikacji, identyfikator śledzenia, czas, stan i pola rozliczeniowe są przechowywane, abyśmy mogli uruchamiać i rozliczać usługę. Nie ma nic do skonfigurowania po twojej stronie.

Czy mogę sprawdzić, czy Zero Query Logging jest włączone?

Nie, obecnie nie w portalu deweloperskim Web IQ ani w interfejsie API. Jeśli potrzebujesz potwierdzenia, na przykład w przypadku inspekcji, otwórz zgłoszenie do Web IQ Support z nazwą firmy i nazwą zasobu Web IQ lub profilu aplikacji, a Web IQ Support potwierdzi ustawienie na piśmie.

Jakie zobowiązania dotyczące rezydencji danych zapewnia web IQ?

Brak dzisiaj. Web IQ nie zapewnia zobowiązań dotyczących przechowywania danych w określonym regionie ani przetwarzania w regionie, a routing między regionami do najbliższego dostępnego punktu końcowego jest oczekiwanym zachowaniem. Prywatność jest objęta Oświadczeniem o ochronie prywatności firmy Microsoft. Microsoft nie oferuje zobowiązań dotyczących lokalizacji ani narodowości personelu, który może uzyskiwać dostęp do danych.

Czy Web IQ jest objęta Dodatkiem Azure dotyczącym ochrony danych lub granicą danych UE?

No. Sekcja 4.1 Web IQ Terms of Use wyklucza usługę z dokumentu Microsoft Products and Services Data Protection Addendum.

Zamiast tego Microsoft i klient pełnią rolę niezależnych administratorów danych dla wszelkich danych osobowych przetwarzanych zgodnie z warunkami użytkowania (sekcja 4.4). Przetwarzanie danych przez firmę Microsoft podlega Zasadom zachowania poufności informacji firmy Microsoft (sekcja 4.2), a Ty odpowiadasz za przekazanie odpowiednich powiadomień użytkownikom końcowym.

W przypadku transferów międzynarodowych Warunki użytkowania obejmują standardowe klauzule umowne, w razie potrzeby (sekcja 4.6.1). Ten mechanizm transferu odbywa się poprzez Warunki użytkowania, które są objęte umową Umowa z Klientem Microsoft, a nie za pośrednictwem Dodatku dotyczącego ochrony danych.

Web IQ nie składa obecnie zobowiązań dotyczących granicy danych UE, rezydencji danych specyficznej dla regionu ani przetwarzania danych w regionie.

Czy Web IQ wykrywa lub maskuje dane osobowe w zapytaniach?

No. Web IQ nie wykonuje wykrywania po stronie serwera ani maskowania danych osobowych w zapytaniach przychodzących. Jeśli obciążenie może wysyłać dane osobiste lub poufne, wyczyść je przed wywołaniem Web IQ, na przykład za pomocą usługi Język platformy Azure AI PII Detection jako kroku przetwarzania wstępnego. W ten sposób nic wrażliwego nie opuszcza Twojego środowiska i zapewniasz pełną kontrolę nad tym, co dociera do interfejsu API.

Czy usługa Web IQ obsługuje branże regulowane?

Yes. Usługa Web IQ obsługuje szereg przypadków użycia dla przedsiębiorstw i zastosowań podlegających regulacjom. Jeśli masz wyspecjalizowane wymagania dotyczące zgodności, ładu korporacyjnego lub branży, skontaktuj się z Web IQ Support.

Bezpieczeństwo i zakres treści

Jakie mechanizmy kontroli bezpieczeństwa zawartości są stosowane?

Web IQ stosuje klasyfikację jakości i bezpieczeństwa w czasie przeszukiwania, filtrowanie zawartości dla dorosłych i reguły kwalifikowalności treści dla poszczególnych klientów. Usługa SafeSearch jest domyślnie wymuszana po stronie serwera w strict. Wyniki wyszukiwania w Internecie zawierają również pole isAdult do dodatkowej obsługi po stronie klienta.

Czy Web IQ chroni LLM przed prompt injection w pobranej zawartości?

Microsoft Web IQ pobiera i klasyfikuje zawartość z internetu; nie wykonuje, interpretuje ani nie działa na podstawie instrukcji osadzonych w pobranej zawartości. Web IQ uzupełnia to działanie mechanizmu pobierania przy użyciu istniejących w Bing mechanizmów kontroli jakości, zaufania, spamu i złośliwych treści.

Ochrona przed pośrednim wstrzyknięciem promptu, próbami jailbreaku i atakami wymuszającymi wykonywanie instrukcji leży głównie po stronie modelu podrzędnego i warstwy aranżacji. Traktuj monity i pobraną zawartość jako niezaufane dane wejściowe i zastosuj kontrolki warstwowe, takie jak Prompt Shields, Bezpieczeństwo zawartości platformy Azure AI, izolacja monitu systemowego, dostęp do narzędzia o najniższych uprawnieniach, walidacja osadzenia w źródłach i walidacja danych wyjściowych. Web IQ nie powinien być traktowany jako jedyny punkt wymuszania w celu ograniczenia ryzyka ataków typu prompt injection.

W jaki sposób zawartość internetowa jest przetwarzana, zanim funkcja Web IQ zwróci ją? Czy jest ono oczyszczone pod kątem instrukcji podobnych do promptów?

Microsoft Web IQ nie działa bezpośrednio na surowym kodzie HTML strony podczas pobierania. Podczas indeksowania zawartość internetowa jest normalizowana w ustrukturyzowanej reprezentacji dokumentu mającej na celu zachowanie znaczącej zawartości i struktury dokumentu. Fragmenty zwracane przez Web IQ są wybierane z tej reprezentacji, co umożliwia bardziej spójne wyodrębnianie i pobieranie w całym interfejsie API. Istniejące w Bing mechanizmy kontroli jakości, bezpieczeństwa, spamu i złośliwych treści są również stosowane w ramach potoku indeksowania.

Web IQ nie może zagwarantować, że zwrócona zawartość jest wolna od skryptów lub złośliwego oprogramowania, a normalizacja nie jest gwarancją, że tekst podobny do monitu zostanie zidentyfikowany lub usunięty. Traktuj pobraną zawartość jako niezaufane dane wejściowe i zastosuj zabezpieczenia warstwy modelu i orkiestracji opisane w poprzedniej odpowiedzi.

Czy Web IQ zwraca ukrytą lub niewidoczną dla użytkownika zawartość strony?

Microsoft web IQ próbuje zwrócić zawartość widoczną przez normalną interakcję użytkownika, w tym zawartość ujawnianą za pomocą zwykłych kontrolek stron lub renderowania po stronie klienta. Nie jest to gwarantowane. Struktura strony i implementacja różnią się, dlatego aplikacje nie powinny zakładać, że każdy zwrócony fragment był widoczny w stanie początkowym strony lub że każdy ukryty element będzie zawsze wykluczony.

Jak Microsoft utrzymuje jakość indeksu?

Strony są oceniane pod kątem jakości, autorytetu i wiarygodności. Złośliwe treści, spam i phishing są wykrywane i wykluczane, a indeks jest stale odświeżany. Jest to ten sam indeks, od którego zależą własne produkty sztucznej inteligencji Microsoftu.

Jak usługa Web IQ szanuje preferencje dotyczące zawartości wydawcy?

Web IQ został zaprojektowany tak, aby uwzględniać obsługiwane mechanizmy kontroli wydawcy, w tym odpowiednie dyrektywy robots.txt i inne sygnały wydawcy rozpoznawane przez firmę Microsoft.

Czy istnieje opublikowana lista wykluczonych witryn lub zablokowanych kategorii?

No. Mechanizmy kontroli wykluczeń obejmują zgodność z plikiem robots.txt, usunięcia ze względów prawnych i zgodności (takie jak powiadomienia DMCA i nakazy sądowe), spam, złośliwe oprogramowanie i filtrowanie wyłudzania informacji oraz filtrowanie zawartości dla dorosłych. Same listy są zastrzeżone i stale aktualizowane. Jeśli masz obawy dotyczące określonych kategorii treści, które pojawiają się lub nie pojawiają się w wynikach, skontaktuj się z Web IQ Support, aby omówić, czy konfiguracja Twojego Web IQ AppID spełnia te wymagania.

Jakie treści obejmuje Web IQ i jak świeże są te treści?

Web IQ stale pobiera świeże informacje na stronach internetowych, wiadomościach i wynikach obrazów i wideo, aby pomóc agentowi sztucznej inteligencji lub aplikacji odpowiedzieć na pytania wykraczające poza dane szkoleniowe modelu.

Dostępność i świeżość różnią się w zależności od interfejsu API, typu źródła i przypadku użycia; nie ma jednej gwarancji aktualności dla całej zawartości. Podczas wybierania źródeł i ustawień pobierania należy wziąć pod uwagę wymagania dotyczące aktualności danych dla obciążenia.

Które języki i rynki obsługuje Web IQ?

Web IQ czerpie z globalnej sieci Web, ale zasięg różni się w zależności od języka, rynku, tematu i typu źródła. Przejrzyj stronę Obsługiwane języki i regiony, aby zapoznać się z kodami akceptowanymi przez każdy interfejs API i ocenić, na ile zakres odpowiada potrzebom docelowych użytkowników.

Czy mogę skonfigurować listy dozwolonych lub odrzucanych domen?

W przypadku poszczególnych domen lub małych list użyj standardowych operatorów zapytań, takich jak site:example.com do dołączania domeny i -site:example.com do wykluczania domeny. Aby ponownie użyć nazwanego zestawu reguł dołączania i wykluczania w wyszukiwaniu w sieci Web lub w wyszukiwaniu wiadomości, utwórz zakres IQ sieci Web dla konta rozliczeniowego z dostępnym zarządzaniem zakresem. Nazwane zakresy obsługują maksymalnie 10 000 znormalizowanych selektorów unikatowych na listę, z zastrzeżeniem połączonego limitu rozmiaru definicji.

Dlaczego nie widzę wyników LinkedIn?

Wyniki LinkedIn są obecnie wykluczone.

Co się stanie po wywołaniu Browse dla wykluczonego adresu URL?

Funkcja Przeglądaj zwraca błąd HTTP 403. Bazowa lista wykluczeń nie jest widoczna.

Jak mogę sprawić, aby moja witryna internetowa była wykrywalna przez Web IQ?

Web IQ jest oparty na tym samym indeksie internetowym, z którego Microsoft korzysta w swoich produktach sztucznej inteligencji. Użyj standardowych rozwiązań odnajdywania w internecie, takich jak mapy witryn, IndexNow, Bing Webmaster Tools i odpowiednie zasady robots.txt. Nie ma oddzielnej ścieżki zgłoszeń dla Web IQ.

Nazwane obszary wyszukiwania

Jak mogę kontrolować i filtrować wyniki Web IQ?

Użyj Scopes, aby filtrować wyniki wyszukiwania w sieci Web i wyszukiwania wiadomości za pomocą list adresów URL, witryn, domen lub ścieżek wielokrotnego użytku do uwzględnienia lub wykluczenia. Utwórz nazwany zakres, a następnie wybierz go za pomocą parametru żądania scopeName. Wykluczenia mają pierwszeństwo przed uwzględnieniami. Zobacz Filtrowanie wyników za pomocą zakresów.

W jaki sposób konto rozliczeniowe Web IQ różni się od AppID lub identyfikatora klienta Entra?

Grupy internetowych kont rozliczeniowych IQ web IQ AppID, dostęp do konta i przypisana kolekcja zakresów. Web IQ AppID określa konfigurację wyszukiwania środowiska uruchomieniowego aplikacji. Identyfikator aplikacji Entra (klienta) identyfikuje rejestrację aplikacji, która uzyskuje tokeny Entra; nie jest to ani Web IQ ID. Zobacz kluczowe pojęcia i wykrywanie autoryzowanych zasobów.

Czy można używać poświadczeń wyszukiwania do tworzenia zakresów?

Dostęp do wyszukiwania nie udziela automatycznie dostępu do zarządzania. Aplikacja wywołująca interfejs API zarządzania klientami wymaga tokenu Entra tylko dla aplikacji oraz CustomerApiAccess na docelowym koncie rozliczeniowym. Administrator będący człowiekiem przyznaje to osobno. Zobacz udzielanie aplikacji dostępu do interfejsu API zarządzania.

Czy zakresy są przypisane do jednego Web IQ AppID?

No. Identyfikatory AppID Web IQ na koncie rozliczeniowym używają przypisanej do niego kolekcji zakresu. Nazwy są unikalne bez rozróżniania wielkości liter w tej kolekcji. Konta przypisane do tej samej kolekcji współużytkują definicje, więc zmiany lub usunięcia wpływają na wszystkich użytkowników tych definicji. Znajomość nazwy nie udziela dostępu do zakresów innego konta.

Czy pusta lista dołączona wyłącza zakres?

No. Puste dołączanie zezwala na każde nieukluczone źródło. Jeśli obie listy są puste, sam zakres nie nakłada żadnych ograniczeń witryny. Wykluczenie zawsze ma pierwszeństwo przed dołączeniem.

Co zrobić, jeśli wyszukiwarka nie znajduje mojego zakresu?

Domyślnie failOnMissingScope ma wartość true: zgłoszone niepowodzenie zastosowania zakresu powoduje zwrócenie błędu zamiast wyniku bez zakresu. Nieprawidłowa nazwa lub niekompletna propagacja może spowodować brak zakresu. Jeśli jawnie ustawisz false, wyszukiwanie może być kontynuowane względem całego indeksu bez zakresu i zgłosić scopeApplied: false. Użyj tego ustawienia tylko wtedy, gdy wyniki niezakresowe są akceptowalne. Zobacz błędy o nazwach zakresów.

Czy wartość scopeApplied true oznacza, że wyszukiwanie używało mojej najnowszej definicji zakresu?

No. scopeApplied: true oznacza, że dla tego żądania zastosowano zakres. Nie identyfikuje używanej wersji ani nie gwarantuje propagacji globalnej. Pole jest opcjonalne, gdy nie zostanie zgłoszony żaden wynik aplikacji; Nie zakładaj, że jest zawsze obecny lub false w przypadku żądań bez scopeName.

Jeśli użycie poprzedniej definicji podczas wdrażania jest niedopuszczalne, przed przełączeniem wywołujących utwórz i zweryfikuj zakres pod nową nazwą. Nie ma jeszcze punktu końcowego gotowości ani wersjonowania zakresu. Pełna globalna propagacja zwykle trwa około 10 minut, ale w niektórych przypadkach może trwać do 30 minut. Obecnie nie ma gwarantowanego SLA dla propagacji i te terminy nie są gwarantowane. Przełączanie obiektów wywołujących nie jest atomowe w skali globalnej.

Zachowanie zapytań i jakość wyników

Czy należy używać zapytań w języku naturalnym czy opartych na słowach kluczowych?

Obie działają. Zapytania w języku naturalnym często dobrze współpracują z elementem contentFormat=passage, podczas gdy zapytania kluczowe są przydatne w przypadku precyzyjnych wyszukiwań, takich jak nazwy firm, tickery lub konkretne tematy. Unikaj nadmiernie długich lub złożonych zapytań; podziel wiele potrzeb informacyjnych na oddzielne wywołania interfejsu API.

Jaka jest maksymalna długość zapytania?

Maksymalna liczba znaków to 1000 znaków, a dłuższe zapytania są odrzucane. Krótsze, ukierunkowane zapytania zwykle generują lepsze wyniki: jeśli zapytanie zawiera dużo kontekstu, pobieranie może nie skupić się na odpowiednim sygnałie.

Czy mogę filtrować wyniki wyszukiwania w Sieci Web według daty?

Wyszukiwanie w Sieci Web nie oferuje obecnie filtru zakresu dat i zalecamy unikanie sztywnego filtru dat, chyba że naprawdę go potrzebujesz. Świeżość jest już uwzględniana w klasyfikacji na podstawie zapytania, a dodanie sztywnego ograniczenia daty prawie zawsze obniża trafność wyników. W przypadku zastosowań związanych z wiadomościami użyj interfejsu News API zamiast filtrować wyniki wyszukiwania w sieci Web według daty.

lastUpdatedAt jest datą ostatniej aktualizacji zawartości przez wydawcę, a nie datą ostatniego sprawdzenia strony przez internet, dlatego starsza data nie oznacza, że strona nie została ostatnio sprawdzona. Jest zwracany w odpowiedzi, nie jest filtrem żądania, a nie każdy wynik zawiera go. Można go użyć do sortowania lub filtrowania wyników w aplikacji.

Czy usługa Web Search może obsługiwać monit zawierający kilka pytań?

Każde żądanie wyszukiwania w Sieci Web obsługuje jedno zapytanie. Jeśli monit zawiera kilka pytań lub intencji, podziel go na oddzielne zapytania w aplikacji, wywołaj funkcję Web Search dla każdego z nich i połącz wyniki przed wygenerowaniem odpowiedzi.

Czy Web IQ może obsługiwać wieloetapowe przepływy pracy agenta?

Yes. Agent może wywołać funkcję Web IQ za każdym razem, gdy potrzebuje dodatkowych dowodów internetowych podczas zadania. Opóźnienie pobierania jest szczególnie ważne w przepływach pracy, które wykonują kilka wywołań przed utworzeniem odpowiedzi.

Jak agent sztucznej inteligencji lub aplikacja powinna obsługiwać pozyskane dane dowodowe?

Użyj dowodów istotnych dla pytania i śledź, które źródła potwierdzają odpowiedź. Zachowaj pobraną zawartość oddzielnie od instrukcji sterujących agentem. Gdy źródła są sprzeczne lub dowody są niekompletne, upewnij się, że ta niepewność jest jasna, zamiast wypełniać luki niepopartymi twierdzeniami.

Jak wypada jakość uziemienia w porównaniu?

Microsoft raportuje najwyższą satysfakcję z groundingu w opublikowanym porównaniu, z wynikiem 79,05. Wyniki zależą od zestawu zapytań, modelu i metody oceny, więc zweryfikuj jakość we własnych scenariuszach.

Źródło: Wyniki benchmarku Web IQ. 3K Global, zapytania ślepe pobrane z prod, konfiguracja: 10 wyników, 10K znaków na wynik (lub równoważnie).

Czy internetowe IQ traktuje źródła kondycji inaczej?

Modele rankingowe Web IQ wykorzystują sygnały wiarygodności źródeł. W przypadku zapytań związanych ze zdrowiem te sygnały opierają się na zasadach opracowanych niezależnie przez Narodową Akademię Medycyny. Dotyczy to Wyszukiwarki oraz wyników Auto pochodzących z Wyszukiwarki; nie dotyczy Wiadomości. Jest to automatyczne: nie ma nic do włączenia. Nie publikujemy listy ani liczby źródeł. Aby ograniczyć wyniki do wybranej witryny, użyj pozycji Zakresy.

Dlaczego wyniki różnią się od Bing.com?

Web IQ jest zoptymalizowany na potrzeby modeli LLM, gęstości faktów, jakości fragmentów i małych opóźnień. Bing.com to usługa dla użytkowników z dodatkowymi sygnałami klasyfikacji, personalizacją, odpowiedziami wizualnymi i zawartością, która może nie podlegać redystrybucji za pośrednictwem interfejsu API. Oczekuje się pewnych różnic w klasyfikacji.

Czy identyczne żądania mogą zwracać różne wyniki?

Pewne różnice są oczekiwane, ponieważ indeks jest stale odświeżany, a aktualizacje są propagowane w centrach danych. Wyniki identycznych żądań złożonych blisko siebie powinny pozostać ogólnie stabilne. Jeśli w ciągu kilku sekund zobaczysz znaczącą wariancję identycznych zapytań, skontaktuj się z pomocą techniczną Web IQ.

Dlaczego zapytanie zwraca mniej wyników niż oczekiwano?

Przed zliczeniem wyników sprawdź nieprzetworzoną odpowiedź Web IQ. Najczęstszą przyczyną jest ustawienie po stronie klienta lub dalszy etap potoku przetwarzania, który filtruje prawidłowe wyniki przed ich pomiarem. Sprawdź maxResultsrównież kwalifikowanie się treści, zachowanie SafeSearch i dowolne operatory site: lub -site: w zapytaniu.

Jak język, region i lokalizacja wpływają na wyniki?

Język samego zapytania ma największe znaczenie; parametry language i region odgrywają rolę pomocniczą, a ich efekt może się różnić w zależności od interfejsu API. Każdy obsługiwany język działa z dowolnym obsługiwanym regionem, na przykład en z IN, AUlub NZ. Region ma wpływ na ranking, mieszankę źródeł i jednostki (na przykład °C lub °F), ale nie na format daty. Zapytanie dotyczące tematu globalnego nadal zwraca wyniki globalne. W przypadku zapytań lokalnych, takich jak „pogoda w mojej okolicy”, lokalizacja ma większe znaczenie niż region.

Oba parametry przyjmują dwuliterowe kody; każda inna wartość powoduje zwrócenie kodu HTTP 400. Jeśli region dwuliterowy nie jest obsługiwany, usługa Web IQ używa US. Jeśli język dwuliterowy nie jest obsługiwany, używany jest język domyślny dla tego regionu. Żaden przypadek nie zwraca błędu. Działa tak samo w Wyszukiwarce internetowej, Wyszukiwarce wiadomości i Auto. Zobacz Obsługiwane języki i regiony.

Czy potrzebuję responseFilter do Auto?

No. Auto decyduje, jakich danych wymaga zapytanie (sieć Web, wiadomości, pogoda i nie tylko) i zwraca je w jednym wywołaniu, więc nie trzeba wywoływać każdego interfejsu API oddzielnie. responseFilter wymienia typy danych, które Auto może uwzględnić; gdy ten element zostanie pominięty, wszystkie typy są dopuszczalne. Aby pominąć typy, których nigdy nie chcesz, takich jak obrazy lub wideo, wymień tylko te, które chcesz (na przykład ["web", "news"]). Ustaw ją raz dla aplikacji, a nie dla poszczególnych zapytań. Auto obsługuje te same języki i regiony co wyszukiwanie w Sieci Web, a responseFilter działa tak samo w każdym regionie. Zobacz dokumentację automatycznego interfejsu API.

Formaty zawartości

Co zwraca każdy wynik: fragmenty lub pełny dokument?

Wyszukiwanie w internecie i wyszukiwanie wiadomości zwracają zawartość każdego wyniku w polu content. Po ustawieniu contentFormat na passage uzyskasz części dokumentu, które są najbardziej trafne dla Twojego zapytania. Za pomocą text, html lub markdown uzyskasz pełny dokument: ustrukturyzowaną wersję strony, którą Web IQ tworzy podczas indeksowania. Fragmenty tekstu działają dla każdej aplikacji; pełne formaty dokumentów wymagają pełnego dostępu do dokumentu. Obrazy i filmy zwracają szczegóły wyników, takie jak tytuły, adresy URL i miniatury, a nie zawartość strony. Zobacz Fragmenty tekstu i formaty zawartości.

Co to jest passage, i dlaczego go używać?

Ustaw contentFormat=passage, a interfejs API zwraca dla każdego wyniku tylko segmenty dokumentu, które są najbardziej istotne dla zapytania, a nie pełny dokument. Pełny dokument jest przetwarzany po stronie Web IQ, a zwracany jest fragment ukierunkowany na zapytanie, więc usługa LLM nie musi przeglądać niezwiązanych akapitów, aby znaleźć odpowiednie zdanie.

• Oszczędność tokenów: LLM otrzymuje tylko część dokumentu zamiast całego dokumentu.
• Lepsza zgodność z faktami: przy mniejszej ilości treści niezwiązanych z tematem w kontekście model z mniejszym prawdopodobieństwem będzie skupiać się na pobocznym akapicie.

Ustaw contentFormat=passage dla każdego żądania wyszukiwania w sieci Web oraz każdego żądania wiadomości. Funkcja Przeglądaj obsługuje również funkcję passage: wyślij query, a funkcja Przeglądaj zwraca części strony najbardziej istotne dla zapytania.

Którego formatu należy użyć?

Służy passage do uziemienia. Jest to zalecany format i działa dla każdej aplikacji. Użyj text, html lub markdown, jeśli potrzebujesz całego dokumentu, na przykład do podsumowania lub wyodrębnienia z pełnej strony. Te formaty wymagają pełnego dostępu do dokumentu.

Czy należy ustawić contentFormat i maxLength na każdym żądaniu?

Yes. Ustaw oba parametry w każdym żądaniu wyszukiwania w sieci Web i aktualności, aby zawsze uzyskiwać oczekiwany format i długość.

Jak długie może być pole content?

Maksymalnie maxLength znaków. Bez pełnego dostępu do dokumentu fragmenty są co najwyżej 3000 znaków na wynik, nawet jeśli wartość maxLength jest wyższa. Przy pełnym dostępie do dokumentu content może mieć do maxLength 500 000 znaków. Pełne dokumenty dłuższe niż maxLength są obcinane.

Dlaczego otrzymuję błąd HTTP 403 (AuthContentFormatForbidden) po ustawieniu contentFormat na text, html lub markdown?

W obszarze Wyszukiwanie w sieci Web i wyszukiwanie wiadomości text, html i markdown zwracają pełny dokument i wymagają pełnego dostępu do dokumentu. Bez niego te formaty zwracają http 403 z kodem AuthContentFormatForbiddenbłędu . passage działa dla każdej aplikacji.

Jak uzyskać pełny dokument jako text, htmllub markdown?

Otwórz zgłoszenie do pomocy technicznej Web IQ. Aplikacje, które już używają html lub text, nadal działają tak jak dziś.

Co zwraca Browse?

Przeglądaj zwraca zawartość wybranego adresu URL, maksymalnie do maxLength znaków. Po contentFormat ustawieniu wartości passage i query funkcja zwraca części strony najbardziej istotne dla zapytania. Jest to format domyślny, chyba że aplikacja ma pełny dostęp do dokumentów. Dzięki pełnemu dostępowi do dokumentu może również zwrócić cały dokument jako text, htmllub markdown. Zobacz dokumentację API Browse.

Dlaczego otrzymuję błąd HTTP 400 z Browse, gdy nie wysyłam query?

Żądanie cytatu wymaga wartości query, która nie jest pusta. passage jest formatem domyślnym, chyba że aplikacja ma pełny dostęp do dokumentów, więc uwzględnij query w każdym żądaniu przeglądania o długości do 1000 znaków. Zobacz Fragmenty tekstu i formaty zawartości.

Jak dostosować maxResults i maxLength, aby zarządzać oknem kontekstowym i kosztami tokenów?

Web IQ może nadawać priorytet fragmentom związanym z zapytaniem zamiast podawania niepotrzebnego kontekstu strony. Może to zmniejszyć ilość tekstu przekazanego do modelu i obniżyć koszty tokenów wejściowych. Korzyści zależą od Twojego modelu, promptów, mieszanki zapytań i ustawień wyszukiwania.

W przypadku większości scenariuszy groundingu więcej wyników z krótszymi fragmentami daje lepsze dane wyjściowe niż mniej wyników z dłuższymi fragmentami przy mniej więcej tym samym całkowitym budżecie tokenów. Dobrym punktem wyjścia jest maxResults=10 z maxLength wynoszącym około 3000 znaków w formacie passage. Przeprowadź test porównawczy z własnymi zapytaniami i modelem.

Dlaczego wyszukiwanie w sieci Web i wyszukiwanie wiadomości nie zwracają pola snippet?

Jest to celowe. Oba są zwracane jako fragment zależny od zapytania (passage) content, zamiast oddzielnego, niezależnego od zapytania snippet.

Zawartość odpowiedzi

Jaka jest maksymalna maxResults wartość dla funkcji Web Search?

Wyszukiwanie w Internecie obsługuje maksymalnie 50 wyników na żądanie.

Które parametry żądania można skonfigurować?

Wyszukiwanie w Sieci Web uwidacznia maxResultswartości , language i region, contentFormat (passage, text, htmllub markdown), maxLengthi safeSearch. Zobacz dokumentację interfejsu API , aby uzyskać pełną listę parametrów.

Jaka jest różnica między lastUpdatedAt i crawledAt?

lastUpdatedAt to podawana przez wydawcę data aktualizacji treści, zwracana przez Wyszukiwarkę internetową, Wiadomości, Wideo, Obrazy, Przeglądanie i Auto, jeśli jest dostępna. crawledAt to czas ostatniego pobrania strony przez Web IQ, zwracany przez Wyszukiwanie w sieci Web, Browse, News i Auto. Dostępność obu pól różni się w zależności od wyniku.

Czym jest Browse Live Crawl i kiedy należy tego używać?

Funkcja Browse zwraca zawartość z indeksu internetowego Bing, który jest stale odświeżany, gdy nasze roboty indeksujące obserwują zmiany w Internecie. Tak ogólnie działa wyszukiwanie w Internecie: wyniki wyszukiwania są dostarczane z indeksu, a nie przez pobieranie na żywo każdego adresu URL przy każdym żądaniu, i to właśnie zapewnia Browse szybkość i spójność.

Browse obsługuje przeszukiwanie na żywo dla adresów URL, które nie są dostępne w indeksie. Ustaw liveCrawl: "fallback" w żądaniu, aby zażądać pobrania na żywo, gdy brakuje indeksowanej kopii. Indeksowanie na żywo podlega ograniczeniom wynikającym z zasad dostępu ustalonych przez wydawcę i dostępności; fallback nie gwarantuje rzeczywistego przeszukiwania. Jeśli zawartość indeksowana jest dostępna, funkcja Browse zwróci ją. Pominięcie parametru (lub ustawienia liveCrawl: "none") zwraca tylko indeksowaną zawartość bez przeszukiwania na żywo. Zobacz dokumentację referencyjną Browse API, aby uzyskać szczegółowe informacje o parametrach.

Live Crawl jest domyślnie dostępny w Web IQ Browse i ma domyślnie przydzielony niewielki limit przepustowości na sekundę, niezależny od ogólnego Browse QPS. Ten limit jest wspólny dla wszystkich kluczy API w ramach AppID. Większość obciążeń Browse nie wymaga przeszukiwania na żywo i jest najlepiej obsługiwana przez standardową ścieżkę indeksowaną; użyj funkcji Przeszukiwanie na żywo, jeśli adres URL nie jest dostępny w indeksie.

Czy Browse może pobierać strony renderowane w języku JavaScript?

Yes. Użyj razem renderDynamicPages: true z liveCrawl: "fallback". Zobacz dokumentację interfejsu API przeglądania , aby uzyskać pełny zestaw parametrów i szczegóły odpowiedzi. Przetestuj reprezentatywne adresy URL, zanim zaczniesz polegać na tym zachowaniu w środowisku produkcyjnym.

Czy Browse może wyodrębniać pliki PDF online?

Pliki PDF hostowane online nie są obecnie udokumentowanym scenariuszem przeglądania. Jeśli masz konkretny przypadek użycia pliku PDF, skontaktuj się z Web IQ Support, przesyłając reprezentatywny adres URL i oczekiwane zachowanie, a otrzymasz ostateczną odpowiedź.

Rozliczenia i kwestie prawne

Ile kosztuje Web IQ?

Usługa Web IQ korzysta z cen opartych na użyciu oraz rozliczeń za każde wywołanie. Ceny zależą od interfejsów API, które są włączone dla Twojego konta, Twojego użycia i Twoich warunków komercyjnych. Zobacz Cennik, aby sprawdzić aktualne stawki.

Czy Web IQ obejmuje zobowiązanie dotyczące SLA, RTO lub RPO?

No. Microsoft Web IQ nie obejmuje umowy dotyczącej poziomu usług. Warunki użytkowania Web IQ nie gwarantują dostępności, opóźnienia, celu czasu odzyskiwania (RTO) ani celu punktu odzyskiwania (RPO), a warunki umowy SLA nie są ustalane dla poszczególnych klientów.

Czy muszę wyświetlać cytowania?

Yes. Załącznik A, sekcja 1 (LLM Use) Warunków korzystania z Web IQ wymaga przypisania źródła i linku zwrotnego do każdego źródła używanego do wyświetlanej zawartości LLM, w pobliżu tej zawartości.

• Przytaczaj tylko źródła, których faktycznie użyto do wygenerowania odpowiedzi. Jeśli funkcja Web IQ zwróciła 10 wyników, a model użył 3, wyświetl te 3.
• Cytaty muszą być widoczne wraz z odpowiedzią i dostępne po wykonaniu jednej czynności. Nie pokazuj ich tylko krótko, nie ukrywaj ich na wielu ekranach ani nie wymagaj od użytkowników osobnego monitowania o źródła.
• W przypadku ograniczonych interfejsów, takich jak samochody, urządzenia do noszenia, urządzenia obsługiwane głosem lub kioski, należy użyć trwałego kodu QR, który prowadzi do strony zawierającej listę wszystkich cytatów użytych w bieżącej odpowiedzi, aplikacji towarzyszącej, która pokazuje odpowiedź z klikalnymi cytatami, lub listy ekranowej, którą użytkownik może otworzyć bezpośrednio.

Możesz przechowywać linki źródłowe wyświetlane razem z podsumowaniem LLM w historii czatu użytkownika końcowego lub w ramach wewnętrznego produktu roboczego. Zobacz pytanie dotyczące buforowania poniżej.

Ile zawartości źródłowej może wyświetlać mój agent sztucznej inteligencji lub aplikacja?

Załącznik A do Warunków korzystania z Web IQ ogranicza wyświetlane Treści źródłowe z dowolnego pojedynczego źródła do mniejszej z następujących wartości: 200 znaków lub maksymalnej liczby określonej przez właściciela witryny lub webmastera. W przypadku trybów wykorzystujących głos lub audio zastosuj ten sam limit do danych wyjściowych mówionych. Dodatkowe ograniczenia dotyczą podsumowań i wyświetlania. Przed tworzeniem fragmentów zapoznaj się z warunkami użytkowania; ten limit nie jest uprawnieniem do odtwarzania całych stron źródłowych.

Czy wyniki dotyczące obrazów i wideo mogą być używane do uziemienia modelu LLM?

Metadane obrazów i wideo oraz tekst alternatywny są zawarte w definicji Grounding Content. Web IQ Terms of Use zabraniają jednak używania rzeczywistych obrazów lub filmów wideo z wyników do ugruntowywania odpowiedzi, uwzględniania ich w danych wyjściowych LLM lub tworzenia na ich podstawie obrazów pochodnych lub filmów wideo. Zapoznaj się z zasadami planowanego wdrożenia.

Czy mogę buforować lub przechowywać zawartość Web IQ?

Ogólnie rzecz biorąc, nie. Warunki użytkowania Web IQ zabraniają kopiowania, przechowywania, buforowania, archiwizowania lub tworzenia bazy danych zawartości, z wyjątkiem przypadków dozwolonych w Warunkach użytkowania (sekcja 3.2.15 i załącznik A, sekcja 4):

• Historia czatów użytkowników końcowych: możesz przechowywać podsumowania LLM (podsumowania tworzone przez aplikację na podstawie Grounding Content dla użytkowników końcowych, sekcja 2.5) w sposób nieagregowany, oddzielnie dla każdego użytkownika końcowego w historii czatów każdego użytkownika końcowego, tak długo, jak zezwala na to obowiązujące prawo.
• Wewnętrzny produkt roboczy: możesz przechowywać podsumowania LLM i linki źródłowe wyświetlane z nimi jako zintegrowaną część wewnętrznego produktu roboczego, takie jak notatki, raporty, prezentacje lub dzienniki zabezpieczeń i inspekcji, w zakresie dozwolonym przez prawo autorskie. Nie można ich używać jako zamiennika usług lub zawartości, na przykład w celu utworzenia bazy danych zawartości, indeksowania linków, przeszukiwania lub skrobania danych ani oferowania oddzielnego wyszukiwania.
• Przetwarzanie przejściowe akcji niepodzielnej: Zawartość może być przechowywana w stanie przetwarzania przejściowego tylko w sposób ściśle niezbędny do ukończenia pojedynczego żądania logicznego lub przepływu pracy zainicjowanego przez usługę LLM (akcja niepodzielna, która może obejmować wiele wewnętrznych kroków lub interakcji agenta). Zawartość musi zostać usunięta natychmiast po zakończeniu Atomic Action.

Poza tymi wyjątkami nie przechowuj samych wyników wyszukiwania: Warunki użytkowania nie zezwalają na bazy danych pochodnych, trwałe buforowanie ani długoterminowe archiwizowanie zawartości.

Gdzie można przeczytać internetowe warunki użytkowania Web IQ?

Bieżące warunki są dostępne pod adresem Microsoft Web IQ Terms of Use. Są one stosowane razem z istniejącą umową Umowa z Klientem Microsoft.