Ricerca Web in Azure Databricks

Questa pagina descrive come basare le risposte su informazioni in tempo reale dal web su Azure Databricks. Utilizzare un server di ricerca web con Model Context Protocol (MCP) per collegare client e agenti compatibili MCP a strumenti di ricerca web.

Suggerimento

Genie Code (modalità agente) può farlo per te. Provare questo prompt di esempio:

Query the databricks-gemini-3-1-pro model using the OpenAI client with the google_search parameter enabled, ask a question about a current event, and print the response.

La ricerca web consente ai modelli fondativi di recuperare informazioni aggiornate da Internet durante la generazione della risposta. Quando la ricerca Web è abilitata, il modello può cercare nel Web informazioni pertinenti e incorporarlo nella risposta. Ciò è utile per domande sugli eventi correnti, sui dati recenti o su qualsiasi argomento in cui le informazioni in tempo reale migliorano la risposta.

Abilita la ricerca web per client e agenti compatibili con MCP utilizzando un server MCP di ricerca web, come You.com su Azure Databricks Marketplace.

Ricerca web tramite MCP

I clienti e gli agenti compatibili MCP possono chiamare uno strumento di ricerca web indipendentemente dal loro fornitore di modello. Collega il tuo client o agente a un servizio o server MCP di ricerca web usando MCP.

Lo strumento di ricerca Web nativo di Anthropic non è disponibile tramite le API Azure Databricks Foundation Model. Usa MCP per fornire strumenti di ricerca web agli agenti che utilizzano modelli Anthropic.

Configurare il server MCP You.com

You.com è un'alternativa di terze parti per clienti e agenti compatibili con MCP.

  1. Passare a Marketplace > Agents > MCP Servers nell'area di lavoro Azure Databricks.
  2. Cercare You.com e fare clic su Installa.
  3. Configurare la connessione:
  • Nome connessione: immettere un nome , ad esempio youcom_web_search.
  • Token portatore: Inserire la chiave API di You.com.
  1. Fare clic su Installa.
  2. Concedere i USE CONNECTION privileges ad utenti o gruppi appropriati sotto Catalogo > Connessioni > [la tua connessione] > Autorizzazioni.

Dopo l'installazione, il server MCP è disponibile come strumento in AI Playground, agenti e altri client compatibili con MCP. L'URL dell'endpoint proxy per la connessione è:

https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>

Usa You.com con Claude Code

Per utilizzare You.com con Claude Code e le API Foundation Model di Azure Databricks, aggiungi il server MCP You.com:

claude mcp add youcom-search \
  --transport http \
  --url "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>" \
  --header "Authorization: Bearer <your-databricks-pat>"

Verificare che il server sia stato aggiunto con claude mcp list.

In alternativa, aggiungere il server direttamente a ~/.claude.json:

{
  "mcpServers": {
    "youcom-search": {
      "type": "http",
      "url": "https://<workspace_host>.databricks.com/api/2.0/mcp/external/<connection_name>",
      "headers": {
        "Authorization": "Bearer <your-databricks-pat>"
      }
    }
  }
}

Modelli supportati

La ricerca web MCP richiede un cliente o un agente che possa chiamare gli strumenti MCP. Non è limitato a uno specifico provider di modelli. Per l'integrazione con agenti, vedi Usa strumenti MCP in un agente Python.

Privacy e conservazione dei dati

Quando abiliti la ricerca web tramite le API del modello Foundation di Azure Databricks, la ricerca viene eseguita su un endpoint di modello di fondazione ospitato su Azure Databricks. La query di ricerca e i risultati vengono elaborati dal modello ospitato indipendentemente dal modello chiamato dalla tua applicazione. Gli stessi termini di protezione e conservazione dei dati che regolano il Model Serving si applicano a queste richieste:

  • Azure Databricks non utilizza input inviati a Model Serving, né output da esso per addestrare i modelli. Vedi Protezione dei dati Model Served.
  • Qualsiasi archiviazione temporanea per il rilevamento di abusi viene conservata nella stessa regione del tuo spazio di lavoro ed è limitata nel tempo. Vedi Conservazione dei dati.

Il modello formula le query di ricerca dal tuo prompt e le invia a un fornitore di ricerca esterno per recuperare i risultati. Considera i contenuti prompt che arrivano nella ricerca web come dati che escono da Azure Databricks per il provider di ricerca, e definisci di conseguenza ciò che la tua applicazione invia.

Limitazioni

  • La ricerca Web non è disponibile per le aree di lavoro con conformità HIPAA/BAA abilitata perché le query di ricerca Web vengono inviate a servizi di ricerca esterni non conformi a HIPAA.
  • I risultati della ricerca Web dipendono dalla capacità del modello di formulare query di ricerca e sintetizzare i risultati. La qualità della risposta può variare.

Risorse aggiuntive

  • Ultimo aggiornamento: