Grounding con Ricerca Bing

Il Grounding con Ricerca Bing consente agli agenti di Azure AI di incorporare dati Web pubblici in tempo reale durante la generazione di risposte. È necessario creare una risorsa di base con la risorsa Ricerca Bing e quindi connettere questa risorsa agli agenti di intelligenza artificiale di Azure. Quando un utente invia una query, gli agenti di Azure AI decidono se usare o meno il Grounding con Ricerca Bing. Se la decisione è positiva, Bing verrà usato per eseguire ricerche su dati Web pubblici e restituire blocchi pertinenti. Infine, gli agenti di intelligenza artificiale di Azure useranno blocchi restituiti per generare una risposta.

È possibile porre domande come "qual è la notizia principale di oggi" o "qual è l'aggiornamento recente nell'industria al dettaglio negli Stati Uniti?", che richiedono dati pubblici in tempo reale.

Gli sviluppatori e gli utenti finali non hanno accesso al contenuto non elaborato restituito da Grounding con Ricerca Bing. La risposta del modello, tuttavia, include citazioni con collegamenti ai siti Web usati per generare la risposta e un collegamento alla query Bing usata per la ricerca. È possibile recuperare la risposta del modello accedendo ai dati nel thread creato. Questi due riferimenti devono essere conservati e visualizzati nel formato esatto fornito da Microsoft, in base ai requisiti di utilizzo e visualizzazione di Ricerca Bing. Per informazioni dettagliate, vedere la sezione Come visualizzare il grounding con i risultati di Ricerca Bing.

Importante

1. L'utilizzo di grounding con Ricerca Bing può comportare dei costi. Per i dettagli, vedi la pagina dei prezzi.
2. Creando e usando una risorsa di Grounding con Ricerca Bing attraverso un'esperienza code-first, come l'interfaccia della riga di comando di Azure o tramite un modello di distribuzione, si accettano le condizioni disponibili in https://www.microsoft.com/en-us/bing/apis/grounding-legal, che possono essere aggiornate sporadicamente.
3. Quando si usa il servizio Grounding con Bing Search, i dati dei clienti vengono trasferiti al di fuori dell'ambito di conformità di Azure al servizio Grounding con Bing Search. Il processo con Ricerca Bing non è soggetto agli stessi termini di elaborazione dei dati (incluso il luogo di elaborazione) e non ha gli stessi standard e certificazioni di conformità del Servizio Agente di Azure AI Foundry, come descritto nei Termini di Utilizzo di Grounding con Ricerca Bing. È responsabilità dell'utente valutare se l'utilizzo del sistema di Grounding con la Ricerca Bing nel proprio agente soddisfa le sue esigenze e i requisiti.

Come funziona il Grounding con Ricerca Bing

La query dell'utente è il messaggio che un utente finale invia a un agente, ad esempio "Dovrei prendere un ombrello con me oggi? Sono a Seattle. Le istruzioni sono il messaggio di sistema che uno sviluppatore può fornire per condividere il contesto e fornire istruzioni al modello di intelligenza artificiale su come usare vari strumenti o comportamento.

Quando un utente invia una query, la distribuzione del modello di intelligenza artificiale del cliente la elabora prima (usando le istruzioni fornite) per eseguire successivamente una query di ricerca Bing ( visibile agli sviluppatori). Il collegamento con Bing restituisce risultati di ricerca pertinenti per la distribuzione del modello del cliente, che poi genera l'output finale.

Annotazioni

Quando si usa Grounding con Ricerca Bing, solo la query di ricerca Bing, i parametri dello strumento e la chiave di risorsa vengono inviate a Bing e non sono incluse informazioni specifiche dell'utente finale. La chiave della risorsa viene inviata a Bing esclusivamente a scopo di fatturazione e limitazione della tariffa.

L'autorizzazione avverrà tra il servizio Grounding con il servizio Ricerca Bing e il servizio agente di Azure AI Foundry. Qualsiasi query di Ricerca Bing generata e inviata a Bing per scopi di grounding viene trasferita, insieme alla chiave di risorsa, al di fuori del limite di conformità di Azure al servizio Grounding con Ricerca Bing. L'utilizzo della Ricerca Bing è soggetto ai termini di Bing e non ha gli stessi standard di conformità e certificazioni del servizio agente di Azure AI Foundry, come descritto nei Termini di utilizzo di Grounding con Ricerca Bing. È responsabilità dell'utente valutare se l'uso di Grounding con Ricerca Bing nel proprio agente soddisfi le esigenze e i requisiti.

Funzionalità supportate e problemi noti

• Il grounding con lo strumento di ricerca Bing è progettato per recuperare informazioni in tempo reale dal Web, NON da domini Web specifici.
• NON Consigliato per riepilogare un'intera pagina Web.
• In un'unica esecuzione, il modello di intelligenza artificiale valuterà gli output dello strumento e potrebbe decidere di richiamare nuovamente lo strumento per altre informazioni e contesto. Il modello di intelligenza artificiale può anche decidere quali parti degli output degli strumenti vengono usate per generare la risposta.
• Il servizio Agente di intelligenza artificiale di Azure restituirà la risposta generata dal modello di intelligenza artificiale come output, quindi la latenza end-to-end sarà influenzata dalla pre-/post-elaborazione dei modelli di linguaggio di grandi dimensioni (LLM).
• Il grounding con lo strumento Ricerca Bing non restituisce l'output dello strumento agli sviluppatori e agli utenti finali.

Supporto per l'utilizzo

Supporto di Azure AI per le fonderie	Python SDK	SDK di C#	JavaScript SDK	REST API (Interfaccia di Programmazione delle Applicazioni REST)	Configurazione dell'agente di base	Configurazione dell'agente standard
✔️	✔️	✔️	✔️	✔️	✔️	✔️

Configurazione

Annotazioni

1. Il grounding con Ricerca Bing funziona con tutti i modelli OpenAI di Azure supportati dal servizio Azure AI Foundry Agent, ad eccezione di gpt-4o-mini, 2024-07-18.

1. Creare un agente Intelligenza Artificiale di Azure seguendo i passaggi nella guida introduttiva.

2. Creare una risorsa di Grounding con Ricerca Bing. Per crearlo, è necessario avere il ruolo di owner o contributor nella sottoscrizione o nel gruppo di risorse.

   1. È possibile crearne uno nel portale di Azure e selezionare i diversi campi nel modulo di creazione. Assicurarsi di creare questa risorsa di Grounding con Ricerca Bing nello stesso gruppo di risorse dell'agente di Azure AI, del progetto di intelligenza artificiale e di altre risorse.

   

   1. È anche possibile crearne uno tramite l'esperienza code-first. In tal caso, è necessario registrare manualmente Ricerca Bing come provider di risorse di Azure. È necessario avere l'autorizzazione per eseguire l'operazione /register/action per il provider di risorse. L'autorizzazione è inclusa nei ruoli Collaboratore e Proprietario .

       az provider register --namespace 'Microsoft.Bing'
   

3. Dopo aver creato una risorsa Grounding con ricerca Bing, è possibile trovarla nel portale di Azure. Passare al gruppo di risorse in cui hai creato la risorsa, quindi cerca la risorsa "Grounding with Bing Search" che hai creato.

   

Parametri facoltativi

Quando si aggiunge lo strumento di Grounding con Ricerca Bing all'agente, è possibile passare i seguenti parametri. Questi parametri influiranno sull'output dello strumento di Grounding con Ricerca Bing, e il modello di intelligenza artificiale potrebbe non utilizzare appieno tutti i risultati. Vedere gli esempi di codice per informazioni sul supporto della versione dell'API e su come passare questi parametri.

Nome	Valore	TIPO	Obbligatorio
count	Numero di risultati della ricerca da restituire nella risposta. Il valore predefinito è 5 e il valore massimo è 50. Il numero effettivo recapitato può essere minore di quello richiesto. È possibile che più pagine includano alcune sovrapposizioni nei risultati. Questo parametro influisce solo sui risultati della pagina Web. È possibile che il modello di intelligenza artificiale non usi tutti i risultati della ricerca restituiti da Bing.	UnsignedShort	NO
freshness	Filtrare i risultati della ricerca in base ai valori di età senza distinzione tra maiuscole e minuscole seguenti: Giorno: restituisce le pagine Web individuate da Bing nelle ultime 24 ore. Settimana: restituisce le pagine Web individuate da Bing negli ultimi 7 giorni. Mese: restituisce le pagine Web individuate da Bing negli ultimi 30 giorni. Per ottenere articoli individuati da Bing durante un intervallo di tempo specifico, specificare un intervallo di date nel formato : YYYY-MM-DD..YYYY-MM-DD. Ad esempio: freshness=2019-02-01..2019-05-30. Per limitare i risultati a una singola data, impostare questo parametro su una data specifica. Ad esempio: freshness=2019-02-04.	Stringa	NO
market	Il mercato da cui provengono i risultati. In genere, mkt è il paese in cui l'utente effettua la richiesta. Tuttavia, potrebbe trattarsi di un paese diverso se l'utente non si trova in un paese in cui Bing fornisce risultati. Il mercato deve essere nel formato : <language>-<country/region>. Ad esempio: en-US. La stringa non fa distinzione tra maiuscole e minuscole. Per un elenco dei possibili valori di mercato, vedere Codici di mercato. Se noto, si consiglia di specificare sempre il mercato. Specificare il mercato consente a Bing di indirizzare la richiesta e restituire una risposta appropriata e ottimale. Se si specifica un mercato non elencato nei codici di mercato, Bing usa un codice di mercato più adatto in base a un mapping interno soggetto a modifiche.	Stringa	NO
set_lang	Lingua da usare per le stringhe dell'interfaccia utente. È possibile specificare la lingua usando un codice di 2 o 4 lettere. È preferibile usare codici a 4 lettere. Per un elenco dei codici di lingua supportati, vedere Lingue supportate da Bing. Bing carica le stringhe localizzate se setlang contiene un codice di impostazioni cultura indipendente da 2 lettere valido (fr) o un codice di impostazioni cultura specifico di 4 lettere valido (fr-ca). Ad esempio, per fr-ca, Bing carica le stringhe di codice delle impostazioni di cultura neutrale fr. Se setlang non è valido (ad esempio, zh) o Bing non supporta la lingua (ad esempio, af, af-na), l'impostazione predefinita en di Bing è (inglese). Per specificare il codice di 2 lettere, impostare questo parametro su un codice di lingua ISO 639-1. Per specificare il codice di 4 lettere, usare la forma <language>-<country/region> in cui <language> è un codice lingua ISO 639-1 (impostazioni cultura neutre) e <country/region> è un codice ISO 3166 paese/regione (impostazioni cultura specifiche). Ad esempio, usare per l'inglese en-US degli Stati Uniti. Anche se facoltativo, è consigliabile specificare sempre la lingua. In genere, si imposta setLang sulla stessa lingua specificata da mkt a meno che l'utente non voglia visualizzare le stringhe dell'interfaccia utente in una lingua diversa.	Stringa	NO

Come visualizzare i risultati di Grounding con Ricerca Bing

Secondo le condizioni d'uso e i requisiti di utilizzo e visualizzazione di Grounding con Bing, è necessario visualizzare sia gli URL del sito Web che gli URL delle query di ricerca Bing nell'interfaccia personalizzata. È possibile trovare gli URL dei siti Web tramite il parametro annotations nella risposta dell'API e gli URL delle query di ricerca Bing tramite i dettagli runstep. Per eseguire il rendering della pagina Web, è consigliabile sostituire l'endpoint degli URL di query di ricerca Bing con www.bing.com e l'URL della query di ricerca Bing sarà simile a "https://www.bing.com/search?q={search query}"

run_steps = project_client.agents.list_run_steps(run_id=run.id, thread_id=thread.id)
run_steps_data = run_steps['data']
print(f"Last run step detail: {run_steps_data}")

Passaggi successivi

Vedere gli esempi di codice per l'uso dello strumento Grounding con Bing a livello di codice.