domande frequenti su Microsoft Web IQ

Risposte alle domande comuni sull'uso di Microsoft Web IQ. Per informazioni dettagliate sull'API ed esempi di richieste, vedere il riferimento API.

Servizio e implementazione

Che cos'è Microsoft Web IQ?

Microsoft Web IQ è una suite di API native di ricerca Web e di grounding basate sull'intelligenza artificiale che offrono a LLM, agenti di intelligenza artificiale e applicazioni l'accesso a informazioni Web attuali e pertinenti. Ciò consente di ottenere risposte generate dall'IA più accurate e aggiornate, con fonti che gli utenti possono verificare. IQ Web supporta i principali assistenti di intelligenza artificiale di frontiera, tra cui Microsoft Copilot e ChatGPT.

L'IQ Web è disponibile tramite REST all'indirizzo https://api.microsoft.ai/v3 e tramite MCP all'indirizzo https://api.microsoft.ai/v3/mcp. Le API attualmente disponibili sono Ricerca Web, Notizie, Video, Immagini e Browse. Auto è disponibile in versione beta.

Che cos'è il web grounding e quando un agente di intelligenza artificiale ne ha bisogno?

Il web grounding consente all'intelligenza artificiale di accedere alle informazioni Web più recenti in modo da poter rispondere usando i fatti correnti oltre i dati di training, con fonti citate che gli utenti possono controllare. È particolarmente utile per le informazioni che cambiano frequentemente, ad esempio gli sviluppi del mercato, l'attività dei concorrenti, le notizie e gli aggiornamenti normativi.

Web IQ è un LLM? Genera la risposta finale?

No. Web IQ non è un modello di intelligenza artificiale o LLM. Si tratta di una suite di API native per l'IA per la ricerca sul Web e il grounding che offrono a LLMs, agenti di intelligenza artificiale e applicazioni l'accesso alle informazioni Web correnti e pertinenti.

Web IQ non genera la risposta finale dell'IA. Recupera informazioni pertinenti dal Web e l'LLM, l'agente di intelligenza artificiale o la logica dell'applicazione scelti usa tale evidenza per generare una risposta.

Cosa rende Web IQ diverso da altre API di ricerca Web e servizi di grounding?

La maggior parte delle API di ricerca Web forza un compromesso: veloce o accurato, conveniente o completo. Nel confronto pubblicato di Microsoft, L'IQ Web offre la soddisfazione più elevata, la velocità più rapida e il minor numero di token per ogni query. È la stessa piattaforma su cui si basano ogni giorno assistenti di intelligenza artificiale come Copilot e ChatGPT, comprovata su scala globale e pronta per qualsiasi agente di intelligenza artificiale o app su cui basarsi.

Web IQ è anche differenziato in base al modo in cui accede al contenuto. Adotta un approccio responsabile all'accesso Web, riunendo il web aperto e i dati strutturati con la sicurezza e le protezioni di livello aziendale integrate.

Web IQ funziona con lo stack di intelligenza artificiale già usato. È possibile usare il modello di intelligenza artificiale preferito e connettersi tramite l'API REST o il protocollo MCP (Model Context Protocol), senza essere associati a un singolo modello o piattaforma.

Fonte: risultati del benchmark IQ Web (sezioni Qualità, Efficienza e Velocità).

Cosa è possibile creare con Web IQ?

L'IQ Web supporta agenti e applicazioni di intelligenza artificiale che necessitano di informazioni aggiornate ed esterne dal Web pubblico. I team interni possono usarlo per l'intelligence competitiva, il monitoraggio, la ricerca normativa, l'intelligence sulle vendite e l'ottimizzazione del contenuto. Le esperienze rivolte ai clienti possono usarlo per ricerche, individuazione, raccomandazioni e agenti specializzati.

È più adatto per scenari in cui le informazioni cambiano frequentemente, si estendono su molte origini esterne e devono basarsi su contenuti web attuali e attribuibili.

Quale API IQ Web si adatta al caso d'uso?

Usare la Web Search API per trovare pagine e passaggi pubblici pertinenti per il modello, la News API per gli eventi correnti, le API Immagini e video per i risultati visivi e video e la Browse API quando si conosce già l'URL. Controllare le informazioni di riferimento sulle API per le funzionalità e i limiti disponibili per l'account.

È possibile usare Web IQ con il modello di intelligenza artificiale esistente e il framework agente?

Yes. Web IQ consente di aggiungere informazioni Web al modello di intelligenza artificiale e al flusso di lavoro dell'agente scelti. Le API REST e MCP offrono flessibilità nel modo in cui puoi collegarti ad esso. Per informazioni sulle configurazioni supportate, vedere l'SDK e la documentazione sull'integrazione MCP.

Che aspetto ha l'integrazione?

L'agente di intelligenza artificiale o l'applicazione chiama Web IQ per ottenere prove dal web, quindi passa i risultati selezionati al modello per generare una risposta. Controlli come vengono selezionate, utilizzate e citate le informazioni. Segui la guida introduttiva per connettere il primo flusso di lavoro o iniziare a usare Playground.

Web IQ può recuperare informazioni aziendali private?

No. Web IQ recupera informazioni dal Web pubblico. Per il contesto aziendale, Microsoft offre Work IQ, Fabric IQ e Foundry IQ, ognuno dei quali ha un ruolo diverso, dal contesto aziendale ai dati aziendali e alle conoscenze aziendali.

In che modo Web IQ si riferisce a Foundry IQ, Work IQ e Fabric IQ?

Microsoft IQ riunisce quattro livelli integrati che alimentano l'intelligence aziendale in Microsoft. Web IQ fornisce informazioni dal Web pubblico. Work IQ è incentrato sui segnali di lavoro, Fabric IQ sui dati aziendali e Foundry IQ sulla conoscenza dell'organizzazione. Questi prodotti rispondono a diverse esigenze di informazioni per gli agenti e le applicazioni di intelligenza artificiale e sono più potenti se usati insieme.

Web IQ è una risorsa Azure?

Distribuisci una risorsa Web IQ nella tua sottoscrizione Azure. La risorsa gestisce l'identità, la misurazione dei consumi e la fatturazione.

Il servizio stesso è ospitato da Microsoft e multi-tenant. Il recupero Web e la classificazione vengono eseguiti nell'infrastruttura Microsoft e la tua applicazione chiama api.microsoft.ai tramite HTTPS. La risorsa Azure non ospita Web IQ e non è nel percorso della richiesta.

Dove viene distribuito Web IQ?

Web IQ è ospitato da Microsoft ed è disponibile tramite l'endpoint pubblico https://api.microsoft.ai/v3. L'applicazione chiama l'API e Web IQ esegue il recupero web sul lato server.

Ci sono API dedicate per finanza, sport o meteo?

Non oggi. Le API dedicate sono Ricerca Web, Notizie, Video, Immagini e Sfoglia. Per finanza, sport, meteo e altri soggetti senza un'API dedicata, usare Ricerca Web, che restituisce contenuti indicizzati dal web crawler pertinenti. Il contenuto è un testo di pagina non strutturato anziché un feed strutturato.

Accesso e onboarding

Come si passa dalla valutazione alla produzione?

1. Completare la valutazione e verificare che il servizio soddisfi i requisiti.
2. La sottoscrizione Azure è abilitata per Web IQ.
3. Distribuire la risorsa Web IQ in tale sottoscrizione, quindi accedere al Sito clienti Web IQ e connettere la risorsa. In questo modo viene creato l'ID app di produzione, che inizia al limite predefinito di 15 query al secondo (QPS).
4. Per eseguire l'autenticazione con Entra ID, aggiungere l'ID client dell'applicazione a tale AppID nel sito clienti Web IQ.

L'uso di Web IQ è disciplinato dalle Condizioni per l'utilizzo di Web IQ, nel contesto del Contratto del cliente Microsoft esistente.

Quali sottoscrizioni di Azure si possono usare?

L'IQ Web richiede un abbonamento Azure a pagamento. I crediti Azure non funzionano per Web IQ.

Quale indirizzo devo usare per accedere?

Usare l'indirizzo di accesso Microsoft che ha accesso a Web IQ: l'indirizzo Microsoft abilitato o l'account usato per connettere la risorsa Web IQ nel sito del cliente Web IQ. Questo è in genere l'indirizzo usato per Azure, Teams o Office, che può differire dall'indirizzo della cassetta postale.

Per confermarlo, accedere al portale di Azure e controllare l'indirizzo nell'angolo in alto a destra.

Perché la procedura di accesso indica che non si ha accesso?

Verificare innanzitutto che l'indirizzo visualizzato nell'angolo superiore destro del portale di Azure corrisponda esattamente all'indirizzo che ha accesso a IQ Web. Le organizzazioni usano spesso un indirizzo per l'accesso a Microsoft e un altro per la posta elettronica.

Se gli indirizzi e-mail corrispondono, l'organizzazione potrebbe bloccare l'accesso guest tra tenant al tenant Microsoft Corporation. Chiedi al tuo amministratore IT di consentire tale accesso.

Dove posso ottenere assistenza?

Per assistenza sul prodotto, visitare il sito di supporto di Microsoft Web IQ. Per domande sull'uso, la privacy, l'archiviazione o la visualizzazione consentite, vedere gli attuali Termini di utilizzo di Web IQ e il contratto cliente applicabile.

Autenticazione delle API

Quali metodi di autenticazione sono supportati?

Web IQ supporta:

• Microsoft Entra ID token bearer tramite il flusso di credenziali client OAuth 2.0. È l'opzione consigliata per i carichi di lavoro di produzione.
• Chiavi API inviate nell'intestazione della richiesta x-apikey.

Tutto il traffico dell'API usa HTTPS.

Come si configura l'autenticazione da server a server?

Registrare un'applicazione in Microsoft Entra ID e usare il flusso di credenziali client OAuth 2.0. Aggiungere l'ID client dell'applicazione al Web IQ AppID nel Web IQ Customer Site, acquisire un token di accesso e inviarlo come Authorization: Bearer <access_token>.

Per la procedura di configurazione completa, vedere Autenticazione .

È possibile gestire le proprie chiavi API?

Yes. È possibile creare tutte le chiavi API necessarie dal Web IQ Customer Site. Non è previsto alcun addebito per la creazione di chiavi.

Web IQ usa Azure RBAC per l'autorizzazione API?

No. Web IQ è un servizio ospitato da Microsoft a cui si accede tramite Internet. La risorsa Web IQ distribuita nella sottoscrizione Azure gestisce identità, misurazione e fatturazione, ma non è nel percorso della richiesta, quindi non esiste alcuna risorsa di servizio a cui assegnare i ruoli RBAC di Azure.

L'IQ Web autorizza le richieste per AppID. Ogni AppID ha un proprio profilo e quota di idoneità per il contenuto e le chiamate non autorizzate restituiscono HTTP 403. Per separare i team o i carichi di lavoro, ad esempio con quote o criteri di accesso diversi, usare più AppIDs.

Un Entra ID può chiamare più di un AppID?

Yes. Un singolo ID applicazione Entra (client) può essere autorizzato a chiamare uno o più ID AppID. Per scegliere l'AppID, passarlo come parametro di query, ad esempio https://api.microsoft.ai/v3/search/web?appid=<AppID>. L'API risolve l'APPID come segue:

• Il Entra ID è associato a un ID app: se non si specifica un Id app o si specifica l'ID app, la richiesta ha esito positivo (HTTP 200). Se si specifica un ID app diverso, la richiesta restituisce HTTP 403.
• Il Entra ID è associato a diversi ID App: è necessario specificarne uno. Un Id app mancante o vuoto restituisce HTTP 400; uno dei valori AppID associati ha esito positivo (HTTP 200); qualsiasi altro Id app restituisce HTTP 403.
• Il Entra ID non è associato ad alcun AppID: la richiesta restituisce HTTP 401.

L'autenticazione con chiave API (x-apikey) non è influenzata. Ogni chiave API è associata a un singolo ID app, quindi ?appid= non è mai necessaria o accettata per le chiamate autenticate tramite chiave.

Quale autenticazione deve essere usata da un agente ospitato: Identità gestita o AgentID?

Uno dei due funziona. L'identità gestita e l'ID agente sono entrambe identità Entra ID e Web IQ accetta qualsiasi identità Entra il cui ID applicazione (client) sia collegato al profilo applicazione Web IQ dalla pagina Gestione profili del sito del cliente Web IQ.

Quello usato dipende dalla posizione in cui è ospitato l'agente:

• L'identità gestita si adatta agli agenti eseguiti nell'infrastruttura Azure, ad esempio Foundry, App Service, Container Apps, AKS, Functions o macchine virtuali. Le identità assegnate dal sistema e quelle assegnate dall'utente funzionano entrambe.
• AgentID si adatta agli agenti foundry o Copilot Studio ospitati che espongono un'identità dell'agente.
• Gli agenti ospitati all'esterno di Azure, ad esempio nel proprio cluster Kubernetes o in un altro cloud, possono usare una registrazione standard dell'applicazione Entra con un segreto client o credenziali federate.

In ogni caso, la chiamata usa il flusso di credenziali client OAuth 2.0 e invia il token come Authorization: Bearer <access_token>. Vedere Autenticazione per i passaggi di configurazione. Una chiave API nell'intestazione x-apikey rimane l'opzione più semplice per i prototipi.

Rete e sicurezza

Web IQ supporta collegamento privato, endpoint privati, integrazione con VNet o elenco di indirizzi IP consentiti?

No. Nessuno di questi è attualmente supportato. L'accesso a Web IQ viene eseguito tramite un singolo endpoint pubblico, https://api.microsoft.ai/v3, su HTTPS con Entra ID o l'autenticazione tramite chiave API. Non esiste alcun controllo di accesso basato su IP nell'endpoint DELL'API.

La risorsa IQ Web nella sottoscrizione Azure gestisce identità, misurazione e fatturazione, ma non è nel percorso della richiesta, quindi i controlli di rete di Azure come collegamento privato, integrazione della rete virtuale, Firewall di Azure, gruppi di sicurezza di rete e topologie hub-spoke non hanno nulla sul lato IQ Web a cui collegarsi. L'integrazione dell'identità (Entra ID) è allineata ad Azure; il livello di rete non lo è.

Da parte tua, consenti il nome host api.microsoft.ai nei controlli in uscita.

Il traffico da Azure a Web IQ rimane nella rete di Microsoft o nel backbone Azure?

Questo non è garantito. I client si connettono all'endpoint pubblico https://api.microsoft.ai e il traffico viene protetto in transito con HTTPS.

Il traffico dell'API IQ Web termina in Frontdoor di Azure, che supporta TLS 1.2 e TLS 1.3 con queste suite di crittografia:

• 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

Zscaler o un altro strumento di ispezione in uscita interferirà con Web IQ?

Non deve interferire quando configurato per consentire le connessioni a api.microsoft.ai. Si tratta di un'azione standard di allow-list, non di un bypass generale. Lo stesso approccio si applica ad altri gateway Web sicuri, ad esempio Netskope.

È possibile inserire Web IQ dietro Gestione API di Azure?

Yes. È possibile posizionare Gestione API di Azure o un altro gateway davanti a Web IQ nella propria sottoscrizione Azure per l'osservabilità e la governance e non esistono limitazioni bloccanti note. Le chiamate API passano dal chiamante a https://api.microsoft.ai/v3 tramite TLS con una chiave API o un token Entra ID, quindi qualsiasi elemento inserito davanti a tale traffico è la tua infrastruttura nel tuo tenant. Microsoft non pubblica un'architettura di riferimento per queste implementazioni; il team dell'architettura cloud è responsabile di questa progettazione.

In base alle Condizioni per l'utilizzo di Web IQ, il contenuto della risposta non può essere memorizzato nella cache o archiviato per creare un set di dati derivato, indipendentemente da ciò che fa il gateway. I dati di telemetria operativi, ad esempio stato, latenza, intestazioni e ID di traccia, possono essere conservati, ad esempio in Application Insights o Log Analytics.

Quali controlli di sicurezza sono disponibili?

• Autenticazione: Entra ID (credenziali client OAuth 2.0) o una chiave API.
• Autorizzazione: accesso per AppID alle API. Le chiamate non autorizzate restituiscono HTTP 403.
• Rate limiting: imposizione della quota per AppID. Le richieste superiori al limite restituiscono HTTP 429.
• Trasmissione: solo HTTPS.

Le policy di rete a livello di perimetro sono una tua responsabilità. Se si hanno requisiti di architettura specifici che si desidera valutare, contattare Web IQ Support.

Limiti di frequenza e chiavi API

Esiste un limite di richieste?

Yes. Ogni risorsa IQ Web ha un limite predefinito di 15 query al secondo (QPS). Il limite si applica all'AppID creato quando si connette la risorsa e Web IQ Customer Site lo visualizza.

Il limite viene condiviso tra tutte le chiavi API e i client Entra ID per tale AppID. Le richieste superiori al limite restituiscono HTTP 429.

È possibile aumentare il limite di richieste?

Yes. Ogni risorsa Web IQ parte da 15 QPS. Per richiedere un limite superiore, contattare il Web IQ Support con il traffico previsto e il caso d'uso.

Quante chiavi API è possibile creare?

È possibile creare tutte le chiavi necessarie per l'applicazione. La creazione della chiave è gratuita, ma tutte le chiavi per una risorsa condividono il limite di frequenza.

Privacy e gestione dei dati

Web IQ registra le query API?

Yes. Le richieste API vengono registrate a scopo operativo: affidabilità del servizio, debug e miglioramento della qualità. Questo è lo standard per i servizi Microsoft.

• L'accesso è limitato al personale tecnico e operativo autorizzato Microsoft ed è disciplinato dai criteri di controllo degli accessi interni di Microsoft. I dati nei log non sono accessibili ad altri clienti o terze parti.
• I log vengono archiviati nell'infrastruttura di produzione di Microsoft e sono soggetti ai controlli di sicurezza standard di Microsoft, inclusi il controllo degli accessi in base al ruolo e gli audit trail.
• I log vengono crittografati in transito (HTTPS) e a riposo usando le procedure di crittografia standard di Microsoft.

Microsoft opera come titolare del trattamento dei dati ai sensi dell'Informativa sulla privacy Microsoft.

Quanto tempo vengono conservate le query?

La conservazione dei dati di telemetria delle query è disciplinata dalla sezione 4 delle Condizioni per l'uso di Web IQ, che stabilisce che il trattamento dei dati da parte di Microsoft è soggetto all'Informativa sulla privacy di Microsoft. Non esiste un impegno di conservazione specifico di IQ Web separato oltre a quanto descritto dall'Informativa sulla privacy.

È possibile disattivare la registrazione delle query per carichi di lavoro regolamentati o sensibili?

Il testo della query viene acquisito come parte dei dati di telemetria standard delle richieste e l'elaborazione è disciplinata dall'Informativa sulla privacy Microsoft e dalla sezione 4 delle Condizioni per l'utilizzo di Web IQ.

Se si dispone di un driver normativo o di conformità specifico, Web IQ offre Zero Query Logging, che elimina il testo della query dai dati di telemetria. Non è una funzionalità self-service; ogni caso d'uso viene esaminato e approvato singolarmente e può essere applicato a tutte le applicazioni o solo a quelle specifiche. Per richiederlo, contattare il team dell'account Microsoft e condividere:

• Framework normativo o di conformità applicabile (ad esempio, GLBA, HIPAA, GDPR o APPI).
• Una breve descrizione del tuo scenario di implementazione.

Quali garanzie di data residency offre Web IQ?

Niente oggi. L'IQ Web non prevede impegni di residenza dei dati specifici dell'area o di elaborazione nell'area e il routing tra aree all'endpoint più vicino disponibile è il comportamento previsto. La privacy è coperta dall'informativa sulla privacy Microsoft.

Web IQ è coperto dall'addendum per la protezione dei dati di Azure o dal Confine dei dati dell'UE?

No. La sezione 4.1 delle Condizioni per l'utilizzo di Web IQ esclude il servizio dall'addendum Microsoft Products and Services Data Protection Addendum.

Invece, Microsoft e il cliente agiscono come titolari del trattamento dei dati indipendenti per i dati personali elaborati in base alle condizioni per l'utilizzo (sezione 4.4). Il trattamento da parte di Microsoft è disciplinato dall'Informativa sulla privacy di Microsoft (sezione 4.2) e l'utente è responsabile di fornire un'adeguata informativa agli utenti finali.

Per i trasferimenti internazionali, le Condizioni per l'utilizzo includono clausole contrattuali standard, se necessario (sezione 4.6.1). Tale meccanismo di trasferimento passa attraverso le Condizioni d'uso, che rientrano nel Contratto del cliente Microsoft, non tramite l'addendum di protezione dei dati.

Web IQ non prevede attualmente impegni relativi a EU Data Boundary, alla residenza dei dati specifica per area geografica o all'elaborazione all'interno dell'area.

L'IQ Web rileva o maschera i dati personali nelle query?

No. L'IQ Web non esegue il rilevamento lato server o il mascheramento dei dati personali nelle query in ingresso. Se un carico di lavoro può inviare dati personali o sensibili, eseguirne lo scrub prima di chiamare Web IQ, ad esempio con Lingua di Azure AI PII Detection come fase di pre-elaborazione. In questo modo, nulla di sensibile lascia il tuo ambiente e si mantiene il controllo completo su ciò che raggiunge l'API.

Web IQ supporta i settori regolamentati?

Yes. Web IQ supporta una gamma di casi d'uso aziendali e soggetti a regolamentazione. Se si hanno requisiti di conformità, governance o settore specializzati, contattare Web IQ Support.

Sicurezza e copertura dei contenuti

Quali controlli di sicurezza dei contenuti vengono applicati?

Web IQ applica la classificazione della qualità e della sicurezza in fase di crawling, il filtro dei contenuti per adulti e le regole di idoneità per i contenuti per cliente. SafeSearch viene applicato sul lato server su strict per impostazione predefinita. I risultati di Ricerca Web includono anche un isAdult campo per una gestione aggiuntiva lato client.

Web IQ protegge un LLM dalla prompt injection nel contenuto recuperato?

Microsoft Web IQ recupera e classifica il contenuto dal Web; non esegue, interpreta o agisce sulle istruzioni incorporate nel contenuto recuperato. L'IQ Web integra questo comportamento di recupero delle informazioni con la qualità, l'attendibilità, lo spam e lo screening dei contenuti dannosi di Bing.

La protezione contro l'inserimento indiretto di richieste, i tentativi di jailbreak e gli attacchi basati sull’esecuzione di istruzioni è principalmente responsabilità del modello downstream e del livello di orchestrazione. Considerare i prompt e il contenuto recuperato come input non attendibili e applicare controlli a più livelli, ad esempio Prompt Shields, Sicurezza dei contenuti di Azure AI, isolamento del prompt del sistema, accesso agli strumenti con privilegi minimi, convalida del grounding e convalida dell'output. Web IQ non deve essere considerato come l'unico punto di applicazione per la mitigazione della prompt injection.

Come viene elaborato il contenuto Web prima che Web IQ lo restituisca? È stata ripulita da istruzioni simili a prompt?

Microsoft Web IQ non opera direttamente sul codice HTML della pagina non elaborata in fase di recupero. Durante l'indicizzazione, il contenuto Web viene normalizzato in una rappresentazione di documento strutturata progettata per mantenere contenuto significativo e struttura di documenti. I passaggi restituiti da Web IQ vengono selezionati da tale rappresentazione, ed è questo che consente un'estrazione e un recupero più coerenti nell'intera API. La qualità, la sicurezza, la posta indesiderata e lo screening dei contenuti dannosi di Bing si applicano anche come parte della pipeline di indicizzazione.

Questa normalizzazione non deve essere interpretata come garanzia che il testo simile al prompt venga identificato o rimosso. Considerare il contenuto recuperato come input non attendibile e applicare le protezioni del livello di orchestrazione e del modello descritte nella risposta precedente.

L'IQ Web restituisce contenuto nascosto o non rivolto all'utente?

Microsoft Web IQ tenta di restituire contenuto visibile tramite l'interazione normale dell'utente, incluso il contenuto rivelato tramite i normali controlli pagina o il rendering lato client. Questo non è garantito. La struttura e l'implementazione delle pagine variano, pertanto le applicazioni non devono presumere che ogni passo restituito sia visibile nello stato iniziale della pagina o che ogni elemento nascosto venga sempre escluso.

In che modo Microsoft mantiene la qualità dell'indice?

Le pagine vengono valutate per qualità, autorità e attendibilità. Il contenuto dannoso, spam e phishing viene rilevato ed escluso e l'indice viene aggiornato continuamente. È lo stesso indice da cui dipendono i prodotti di intelligenza artificiale di Microsoft.

In che modo l'IQ Web rispetta le preferenze del contenuto dell'editore?

Web IQ è progettato per rispettare i controlli dell'editore supportati, incluse le direttive di robots.txt applicabili e altri segnali dell'editore riconosciuti da Microsoft.

Esiste un elenco pubblicato di siti esclusi o categorie bloccate?

No. I controlli di esclusione includono la conformità a robots.txt, rimozioni legali e di conformità (ad esempio avvisi DMCA e ordini giudiziari), posta indesiderata, malware, e il filtraggio del phishing e dei contenuti per adulti. Gli elenchi stessi sono proprietari e aggiornati continuamente. In caso di dubbi su categorie specifiche di contenuti visualizzati o non visualizzati nei risultati, contattare Web IQ Support per stabilire se la configurazione del profilo applicazione soddisfa tali requisiti.

Quali contenuti vengono trattati dall'IQ Web e quanto è aggiornato?

Web IQ raccoglie continuamente informazioni aggiornate tra pagine Web, notizie e risultati di immagini e video per aiutare l'agente di intelligenza artificiale o l'applicazione a rispondere a domande oltre i dati di training del modello.

Disponibilità e aggiornamento variano in base all'API, al tipo di origine e al caso d'uso; non esiste una singola garanzia di freschezza per tutto il contenuto. Considera i requisiti di recency del carico di lavoro quando scegli le fonti e le impostazioni di recupero dati.

Quali lingue e mercati supporta Web IQ?

Web IQ deriva dal Web globale, ma la copertura varia in base a lingua, mercato, argomento e tipo di origine. Esaminare la pagina Lingue e aree supportate per i codici accettati da ogni API e valutare la copertura in base alle informazioni necessarie agli utenti desiderati.

È possibile configurare elenchi di domini consentiti o negati?

Per singoli domini o elenchi di piccole dimensioni, usare operatori di query standard, ad site:example.com esempio per includere un dominio e -site:example.com escluderne uno. Gli elenchi configurabili più grandi non sono attualmente disponibili come funzionalità gestita dal cliente.

Perché non vengono visualizzati i risultati di LinkedIn?

I risultati di LinkedIn sono attualmente esclusi.

Cosa accade quando viene chiamato Browse per un URL escluso?

La funzione Browse restituisce HTTP 403. L'elenco di esclusione sottostante non è esposto.

Come è possibile rendere individuabile il sito Web per Web IQ?

Web IQ si basa sullo stesso indice Web che Microsoft usa per i propri prodotti di intelligenza artificiale. Usare procedure standard per l'individuazione Web, ad esempio le mappa del sito Web, IndexNow, Strumenti per webmaster di Bing e un criterio di robots.txt appropriato. Non esiste un percorso di invio di IQ Web separato.

Comportamento delle query e qualità dei risultati

È consigliabile usare query in linguaggio naturale o con parole chiave?

Entrambi funzionano. Le query in linguaggio naturale spesso funzionano bene con contentFormat=passage, mentre le query con parole chiave sono utili per ricerche precise, ad esempio nomi di società, ticker o argomenti specifici. Evitare query eccessivamente lunghe o composte; suddividere esigenze informative multiple in chiamate API separate.

Qual è la lunghezza massima della query?

Il valore massimo è 1.000 caratteri e le query più lunghe vengono rifiutate. Le query incentrate più brevi generano in genere risultati migliori: se una query contiene un sacco di contesto, il recupero delle informazioni potrebbe non concentrarsi sul segnale corretto.

È possibile filtrare i risultati di Ricerca Web in base alla data?

Ricerca Web non offre oggi un filtro di intervallo di date ed è consigliabile evitare un filtro di data rigido, a meno che non ne sia effettivamente necessario uno. La freschezza è già stata considerata nella classificazione in base alla query e l'aggiunta di un vincolo di data rigido quasi sempre penalizza la pertinenza. Per gli scenari di notizie, usare News API anziché filtrare i risultati di Ricerca Web in base alla data.

lastUpdatedAt è la data dell'ultimo aggiornamento del contenuto da parte dell'editore, non la data dell'ultima volta in cui Web IQ ha controllato la pagina, quindi una data precedente non indica che la pagina non è stata controllata di recente. Viene restituito nella risposta, non è un filtro di richiesta e non tutti i risultati lo includono. È possibile usarlo per ordinare o filtrare i risultati nell'applicazione.

Ricerca Web può gestire una richiesta contenente diverse domande?

Ogni richiesta di Ricerca Web gestisce una query. Se una richiesta contiene diverse domande o finalità, suddividerla in query separate nell'applicazione, chiamare Ricerca Web per ognuna e combinare i risultati prima di generare la risposta.

Web IQ può supportare workflow agente in più fasi?

Yes. Un agente può chiamare Web IQ ogni volta che richiede ulteriori prove Web durante un'attività. La latenza di recupero è particolarmente importante nei flussi di lavoro che effettuano diverse chiamate prima di produrre una risposta.

In che modo il mio agente di intelligenza artificiale o la mia applicazione deve gestire le evidenze recuperate?

Usare le prove rilevanti per la domanda e tenere traccia delle fonti che supportano la risposta. Mantenere il contenuto recuperato separato dalle istruzioni che controllano l'agente. Quando le fonti sono in conflitto o le prove sono incomplete, rendere chiara l'incertezza anziché colmare lacune con dichiarazioni non supportate.

In che modo viene confrontata la qualità della messa a terra?

Microsoft segnala la soddisfazione del grounding più elevata nel confronto pubblicato, con un punteggio pari a 79,05. I risultati dipendono dal set di query, dal modello e dal metodo di valutazione, quindi convalidare la qualità nei propri scenari.

Fonte: risultati del benchmark Web IQ. 3K Global, Blind Queries prelevate da prod, Config: 10 risultati, 10.000 caratteri per risultato (o equivalente).

Perché i risultati differiscono da Bing.com?

Web IQ è ottimizzato per la fruizione da parte degli LLM, la densità fattuale, la qualità dei passaggi e la bassa latenza. Bing.com è un'esperienza per i consumatori con segnali di classificazione aggiuntivi, personalizzazione, risposte visive e contenuto che potrebbe non essere ridistribuibile tramite un'API. Sono previste alcune differenze di classificazione.

Le richieste identiche possono restituire risultati diversi?

È prevista una variazione perché l'indice viene aggiornato continuamente e gli aggiornamenti vengono propagati tra data center. I risultati per le richieste identiche effettuate a breve distanza di tempo dovrebbero rimanere ampiamente stabili. Se viene visualizzata una varianza significativa nelle query identiche entro pochi secondi, contattare Web IQ Support.

Perché una query restituisce meno risultati del previsto?

Controllare la risposta IQ Web non elaborata prima di contare i risultati. La causa più comune è un'impostazione lato client o un passaggio della pipeline downstream che esclude i risultati validi prima che vengano misurati. Verificare anche maxResults, idoneità del contenuto, comportamento SafeSearch e qualsiasi operatore site: o -site: nella query.

Contenuto della risposta

Perché Ricerca Web e Ricerca notizie non restituiscono un campo snippet?

Questo è intenzionale. Entrambi restituiscono content come estrazione dipendente dalla query (passage) anziché come oggetto separato indipendente dalla query snippet.

Quali formati di contenuto sono supportati da Web Search?

Con passage, ogni risultato restituisce le parti del documento più rilevanti per la query, fino a maxLength caratteri (senza accesso completo al documento, al massimo 3.000). È il formato consigliato per la messa a terra. Le applicazioni con accesso completo ai documenti possono anche usare text, htmle markdown. Vedi Passaggi e formati di contenuto.

Che cos'è passagee perché usarlo?

Imposta contentFormat=passage e l'API restituisce, per ogni risultato, solo i segmenti del documento più rilevanti per la query, non il documento completo. Il documento completo viene elaborato sul lato Web IQ e ciò che viene restituito è un estratto mirato alla query, quindi l'LLM non deve scorrere rapidamente oltre i paragrafi non correlati per trovare la frase pertinente.

• Risparmio di token: l'LLM riceve una frazione del documento anziché tutto.
• Maggiore accuratezza fattuale: con meno contenuto off-topic nel contesto, è meno probabile che il modello si ancori a un paragrafo tangenziale.

Imposta contentFormat=passage su ogni richiesta di ricerca Web e notizie. Browse non supporta passage, perché recupera un URL specifico già scelto e non esiste alcuna query da estrarre.

Qual è il valore massimo maxResults per Ricerca Web?

Ricerca Web supporta fino a 50 risultati per richiesta.

Quali parametri di richiesta è possibile configurare?

Ricerca Web espone maxResults, language e region, contentFormat (passage, text, htmlo markdown), maxLengthe safeSearch. Vedere le informazioni di riferimento sull'API per l'elenco completo dei parametri.

Qual è la differenza tra lastUpdatedAt e crawledAt?

lastUpdatedAt è la data di aggiornamento del contenuto segnalata dall'editore, restituita da Ricerca Web, Notizie, Video, Immagini, Sfoglia e Auto, se disponibile. crawledAt è l'ora in cui Web IQ ha recuperato la pagina, restituita da Ricerca Web, Browse, Notizie e Auto. La copertura di entrambi i campi varia in base al risultato.

Come è consigliabile ottimizzare maxResults e maxLength per gestire i costi della finestra di contesto e dei token?

L'IQ Web può classificare in ordine di priorità i passaggi rilevanti per una query invece di fornire un contesto di pagina non necessario. Ciò può ridurre la quantità di testo passato al modello e ridurre i costi dei token di input. I vantaggi dipendono dal modello, dalle richieste, dalla combinazione di query e dalle impostazioni di recupero.

Per la maggior parte degli scenari di grounding, più risultati con passaggi più brevi offrono un output migliore rispetto a un minor numero di risultati con passaggi più lunghi per circa lo stesso budget totale dei token. Un buon punto di partenza è maxResults=10 costituito da maxLength circa 3.000 caratteri in passage formato. Benchmark con le tue query e il tuo modello.

Che cos'è Browse Live Crawl e quando è consigliabile usarlo?

Sfoglia restituisce contenuto dall'indice Web Bing, che viene aggiornato continuamente mentre i crawler osservano le modifiche nel Web. Questo è il funzionamento della ricerca Web in generale: i risultati della ricerca vengono serviti da un indice anziché recuperando ogni URL live su ogni richiesta ed è ciò che fornisce a Browse la velocità e la coerenza.

Per gli scenari che richiedono in modo specifico un recupero just-in-time dell'URL in fase di richiesta, ad esempio il monitoraggio in tempo reale, i controlli competitivi o i flussi di lavoro che si attivano in seguito a una modifica che sai essere appena avvenuta, Browse supporta Live Crawl. Impostare liveCrawl: "fallback" sulla richiesta per attivare un recupero live quando la copia indicizzata è mancante o non aggiornata. Omettendo il parametro (o impostando liveCrawl: "none") viene restituito solo il contenuto indicizzato. Per informazioni complete sui parametri, vedere il riferimento dell'API Browse.

Live Crawl è disponibile per impostazione predefinita in Web IQ Browse ed è dotato di un modesto limite di capacità al secondo, separato dal QPS complessivo di Browse. Questo limite massimo è condiviso tra tutte le chiavi API sotto l’AppID. La maggior parte dei carichi di lavoro Browse non richiede Live Crawl e viene gestita al meglio dal percorso indicizzato standard; usare Live Crawl per il set ristretto di scenari precedenti.

Browse può recuperare le pagine di cui è stato eseguito il rendering in JavaScript?

Yes. Usare renderDynamicPages: true insieme a liveCrawl: "fallback". Per informazioni dettagliate sul set di parametri completo e sulla risposta, vedere il riferimento dell'API Browse. Testa gli URL rappresentativi prima di dipendere da questo comportamento nell'ambiente di produzione.

Browse può estrarre file PDF disponibili online?

I PDF ospitati online non sono oggi uno scenario di esplorazione documentato. Se si dispone di un caso d'uso PDF specifico, contattare Web IQ Support con un URL rappresentativo e il comportamento previsto e si otterrà una risposta definitiva.

Fatturazione e aspetti legali

Quali sono i costi di Web IQ?

Web IQ usa prezzi per chiamata basati sul consumo. I prezzi dipendono dalle API abilitate per l'account, l'utilizzo e le condizioni commerciali. Vedere Prezzi per le tariffe correnti.

Web IQ include un SLA, un RTO o un impegno RPO?

No. Microsoft IQ Web non include un contratto di servizio. Le condizioni per l'utilizzo di Web IQ non garantiscono tempi di attività, latenza, obiettivo del tempo di ripristino (RTO) o obiettivi del punto di ripristino (RPO) e i termini del contratto di servizio non vengono aggiunti per i singoli clienti.

Devo visualizzare le citazioni?

Yes. L'Allegato A, sezione 1 (utilizzo LLM) delle Condizioni d'uso di Web IQ richiede l'attribuzione dell'origine e un collegamento a ogni origine usata per il contenuto LLM visualizzato, vicino a tale contenuto.

• Cite solo le fonti effettivamente usate per generare la risposta. Se l'IQ Web ha restituito 10 risultati e il modello ne ha usati 3, visualizzare questi 3.
• Le citazioni devono rimanere visibili con la risposta e essere raggiungibili con una singola azione. Non visualizzarli solo brevemente, nasconderli dietro più schermate o richiedere agli utenti di richiedere fonti separatamente.
• Per interfacce vincolate, ad esempio automobili, dispositivi indossabili, dispositivi vocali o chioschi multimediali, usare un codice QR permanente che rimanda a una pagina che elenca ogni citazione usata per la risposta corrente, un'app complementare che mostra la risposta con citazioni selezionabili o un elenco su schermo che l'utente può aprire direttamente.

È possibile archiviare citazioni come parte della cronologia delle chat di un singolo utente finale per un massimo di 30 giorni. Vedi la domanda sulla memorizzazione nella cache qui sotto.

Quanti contenuti di origine possono essere visualizzati dal mio agente IA o dalla mia applicazione?

L'Allegato A delle Condizioni d'uso di Web IQ limita i Contenuti di grounding visualizzati da una singola fonte al minore tra 200 caratteri e il massimo specificato dal proprietario del sito web o dal webmaster. Per le esperienze vocali o audio, applicare lo stesso limite all'output parlato. Le restrizioni aggiuntive si applicano ai riepiloghi e alla visualizzazione. Esaminare le Condizioni per l'utilizzo prima di progettare estratti; questo limite non autorizza a riprodurre intere pagine di origine.

I risultati di immagini e video possono essere usati per fornire contesto a un LLM?

I metadati di immagine e video e il testo alternativo sono inclusi nella definizione di Grounding Content. Tuttavia, i Web IQ Terms of Use vietano l'uso di immagini o video effettivi dai risultati per il grounding, la loro inclusione nell'output LLM o la creazione di immagini o video derivati da essi. Consulta i termini e le condizioni per l'implementazione prevista.

È possibile memorizzare nella cache o archiviare il contenuto di Web IQ?

Come regola generale, no. Le Condizioni d'uso di Web IQ vietano la copia, l'archiviazione, la memorizzazione nella cache, l'archiviazione o la creazione di un database di contenuto, ad eccezione di eccezioni limitate (sezione 3.2.15 e sezione 4 degli Allegati A e B):

• Cronologia chat dell'utente finale (fino a 30 giorni): il contenuto può essere archiviato in modo non aggregato per utente finale per la cronologia delle chat di un singolo utente finale per un massimo di 30 giorni. Per LLM Use (Allegato A) questo argomento riguarda il contenuto in generale; per l'uso della ricerca (allegato B) copre gli URL di immagini e video.
• Elaborazione temporanea dell'azione atomica: il contenuto può essere mantenuto in uno stato di elaborazione temporaneo solo come strettamente necessario per completare una singola richiesta logica o flusso di lavoro avviato da un LLM (un'azione atomica, che può comportare più passaggi interni o interazioni agentiche). Il contenuto deve essere eliminato tempestivamente al termine dell'Atomic Action.
• Il proprio prodotto: nella misura consentita dalla legge sul copyright, il contenuto può essere copiato o archiviato come parte integrata del proprio prodotto, purché il prodotto non venga creato per sostituire i Servizi (ad esempio, creare un database di Contenuti, l'indicizzazione dei collegamenti per il crawling o l'offerta di una ricerca separata).

Al di fuori di queste eccezioni, le Condizioni per l'utilizzo non consentono database derivati, memorizzazione nella cache permanente o archiviazione a lungo termine del contenuto.

Dove è possibile leggere le Condizioni per l'utilizzo di IQ Web?

Le condizioni correnti vengono pubblicate presso Microsoft Web IQ Condizioni per l'utilizzo. Si applicano insieme al Contratto del cliente Microsoft esistente.

Accesso completo al documento

Perché si ottiene HTTP 403 quando si imposta contentFormat su html?

In Ricerca Web e Ricerca notizie, text, htmle markdown restituiscono il documento completo e sono disponibili per le applicazioni con accesso completo ai documenti. Altre applicazioni ottengono HTTP 403 con il codice AuthContentFormatForbiddendi errore . passage funziona per ogni applicazione. Vedi Passaggi e formati del contenuto.

Come si richiede l'accesso completo ai documenti?

Aprire una richiesta di supporto IQ Web tramite Azure Supporto e scegliere la categoria di contenuto Pagina completa. Applicazioni che già usano html o text continuano a funzionare come oggi.