Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Gli strumenti di ancoraggio web nel Microsoft Foundry Agent Service connettono gli agenti ai dati Web pubblici in tempo reale, superando il limite di conoscenza del modello Foundry dell'agente. Ad esempio, è possibile porre domande come "what is the top AI news today" e ricevere risposte aggiornate e citate.
Funzionamento del web grounding
Il processo di base prevede diversi passaggi chiave:
- Formulazione di query: l'agente identifica le lacune delle informazioni e costruisce query di ricerca in base all'input dell'utente.
- Esecuzione della ricerca: lo strumento di base invia query a Bing e recupera i risultati.
- Sintesi delle informazioni: l'agente elabora i risultati della ricerca e integra i risultati nelle risposte.
- Attribuzione dell'origine: l'agente fornisce trasparenza citando origini di ricerca con URL.
Prerequisiti
Prima di utilizzare qualsiasi strumento di messa a terra web, assicurati di avere:
- Un ambiente agente di base o standard.
- Il pacchetto SDK più recente per il linguaggio (Python:
azure-ai-projects, C#:Azure.AI.ProjectseAzure.AI.Extensions.OpenAI, JavaScript:@azure/ai-projects). Vedere la guida introduttiva per la procedura di installazione. - Una distribuzione del modello OpenAI Azure nel progetto Foundry.
Nota
Ricerca Web non richiede ruoli aggiuntivi oltre l'accesso al progetto Foundry. Per Grounding con Ricerca Bing e Grounding con Ricerca personalizzata di Bing è necessario il ruolo Contributor o Owner per creare risorse Bing, e il ruolo Azure AI Project Manager per creare connessioni di progetto. Per informazioni dettagliate, vedere Configurazione dell'ambiente agente.
Importante
Ricerca Web, Base con Ricerca Bing e Base con Ricerca personalizzata Bing sono Servizi di consumo di prima parte con termini per i servizi online. Sono disciplinati dal Grounding con condizioni per l'utilizzo di Bing e dall'informativa sulla privacy Microsoft.
Il Microsoft Data Protection Addendum non si applica ai dati inviati a Grounding con Bing Search o Grounding con Bing Custom Search. Quando si usano questi servizi, i dati vengono trasmessi all'esterno del limite di conformità Azure e geografico. Questo significa anche che l'uso di questi servizi rinuncia a tutti gli impegni elevati per la sicurezza e la conformità del cloud per enti pubblici, tra cui la sovranità dei dati e il supporto basato sulla cittadinanza/schermata, a seconda delle esigenze.
Nota
L'uso della messa a terra con la ricerca Bing e della messa a terra con la ricerca personalizzata Bing comporta costi. Vedere i dettagli dei prezzi. Gli amministratori di Azure possono limitare l'accesso a questi strumenti. Per informazioni dettagliate, vedere Controllo amministratore per lo strumento Ricerca Web.
Determinare lo strumento migliore per i casi d'uso
Se si è appena iniziato, usare Ricerca Web. Non richiede risorse aggiuntive Azure ed è il modo più semplice per aggiungere il web grounding all'agente.
Se si esegue la migrazione da Grounding con Ricerca Bing sulla piattaforma degli agenti classici, sia Ricerca Web che Grounding con Ricerca Bing sono opzioni GA nella nuova API degli agenti. Ricerca Web non richiede alcuna risorsa Bing separata. Il grounding con Ricerca Bing offre più parametri e supporta modelli non OpenAI distribuiti direttamente in Azure.
I casi d'uso seguenti consentono di confrontare gli strumenti disponibili. Il caso d'uso 1 riguarda la ricerca sul Web generale, in cui sia la Ricerca sul Web che il collegamento con la Ricerca Bing possono recuperare i risultati dal Web pubblico. Il caso d'uso 2 riguarda la ricerca con restrizioni di dominio, supportata solo da Integrazione con la Ricerca personalizzata Bing.
Caso d'uso 1: Fondamento dal Web generale indicizzato da Bing
| Ricerca Web (scelta consigliata) | Integrazione con Ricerca Bing | |
|---|---|---|
| Palco | GA | GA |
| Collegamento utilizzando la risorsa Bing | Gestito da Microsoft | Gestito dall'utente — richiede prima la creazione di una risorsa di base con Bing Search |
| Parametri supportati |
-
user_location: fornisce risultati rilevanti per l'area geografica- search_context_size: basso/medio/alto (impostazione predefinita: medio)Altre informazioni sui parametri di Ricerca Web |
-
count: il numero massimo di risultati restituiti da Bing - freshness: specifica il periodo per i risultati della ricerca- market: specifica l'area per i risultati della ricerca - set_lang: specifica la lingua per i risultati della ricerca Altre informazioni sui parametri di Ricerca Bing |
| Limite dati | Flussi di dati all'esterno del limite di conformità Azure | Flussi di dati all'esterno del limite di conformità Azure |
| Modelli supportati | Azure modelli OpenAI | Azure modelli OpenAI e modelli diretti Azure (modelli non OpenAI distribuiti direttamente in Azure) |
Ancoraggio dai domini specifici che hai definito
| Ricerca Web (scelta consigliata) | Connessione con Ricerca personalizzata Bing | |
|---|---|---|
| Palco | GA (Disponibilità generale, richiede un'istanza di Ricerca personalizzata Bing) | Anteprima |
| Limitare i domini personalizzati | Supportato: usare custom_search_configuration per pre-definire domini consentiti o bloccati (richiede la creazione di una risorsa e un'istanza di Ricerca personalizzata Bing) |
Supportato: usare custom_search_configuration per pre-definire domini consentiti o bloccati (richiede la creazione di una risorsa e un'istanza di Ricerca personalizzata Bing) |
| Altri parametri |
-
user_location: fornisce risultati rilevanti per l'area geografica- search_context_size: basso/medio/alto (impostazione predefinita: medio)Altre informazioni sui parametri di Ricerca Web |
-
count: numero massimo di risultati restituiti da Bing - freshness: specifica il periodo per i risultati della ricerca- market: specifica l'area per i risultati della ricerca - set_lang: specifica la lingua per i risultati della ricerca Altre informazioni sui parametri di Ricerca personalizzata Bing |
| Modelli supportati | Azure modelli OpenAI | modelli Azure OpenAI e modelli Azure diretti |
Domande comuni
Quale strumento è consigliabile usare se si è appena iniziato?
Usare Ricerca Web. Non richiede risorse aggiuntive Azure, gestisce automaticamente la gestione delle risorse Bing e fornisce risultati rilevanti per l'area geografica con il parametro user_location.
È possibile usare strumenti di web grounding con progetti Foundry protetti dalla rete?
Gli strumenti di web grounding non rispettano gli endpoint VPN o privati. Agiscono come endpoint pubblici. Prendere in considerazione questa implicazione per la sicurezza quando si usa Foundry protetto dalla rete con questi strumenti.
Come si limitano i risultati della ricerca a siti Web specifici?
Usare Ricerca Web. Questo strumento consente di definire un elenco di domini consentiti o bloccati, in modo che i risultati della ricerca provengano solo dalle origini approvate.
Sono previsti costi aggiuntivi per il web grounding?
Sì. La ricerca Web, il grounding con Ricerca Bing e il grounding con Ricerca personalizzata Bing (anteprima) comportano costi oltre l'utilizzo standard di Azure OpenAI. Vedere i dettagli dei prezzi.
Risoluzione dei problemi
| Problema | Probabile causa | Risoluzione |
|---|---|---|
| Agent non usa il web grounding | Lo strumento non configurato o il modello non supporta lo strumento. | Verificare che lo strumento venga aggiunto alla definizione dell'agente. Usa tool_choice="required" per forzare l’utilizzo dello strumento. Verificare che la distribuzione del modello supporti lo strumento. |
| Nessuna citazione in risposta | Il modello ha generato una risposta senza usare i risultati della ricerca. | Aggiungere istruzioni esplicite per citare sempre le origini. Usare tool_choice="required" per garantire la chiamata allo strumento. |
| I risultati della ricerca non sono rilevanti | La formulazione della query non ha catturato l'intento dell'utente. | Migliorare le istruzioni per gli agenti per guidare la costruzione di query. Per gli strumenti Bing, modificare market e set_lang parametri. |
| Strumento bloccato dall'amministratore | La tua organizzazione ha disabilitato gli strumenti di web grounding. | Contattare l'amministratore Azure per abilitare l'accesso. Vedere il Controllo amministratore. |
| Costi imprevisti | Gli strumenti di base Web hanno prezzi basati sull'utilizzo. | Esaminare i dettagli dei prezzi e implementare la limitazione della frequenza, se necessario. |