Ricerca Web in Azure Databricks

Questa pagina descrive la ricerca Web in Azure Databricks e come usarla per modellare le risposte con informazioni in tempo reale dal Web. La ricerca Web è disponibile per i modelli Anthropic tramite il protocollo MCP (Model Context Protocol).

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.

Abilitare la ricerca Web per i modelli Anthropic usando un server MCP di ricerca Web, ad esempio You.com da Azure Databricks Marketplace.

Modelli antropici con MCP

Lo strumento di ricerca Web nativo di Anthropic non è disponibile tramite le API Azure Databricks Foundation Model. È invece possibile aggiungere la ricerca Web ai modelli Anthropic usando il protocollo MCP (Model Context Protocol) con un provider di ricerca, ad esempio You.com.

Configurare il server MCP You.com

  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>

Usare con il Claude Code

Se si utilizza Claude Code con le API del modello Foundation di Azure Databricks, aggiungere il server MCP di You.com per abilitare la ricerca sul Web.

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

Modelli Anthropic (tramite MCP)

La ricerca Web tramite MCP è supportata in tutti i modelli di base Anthropic che supportano l'uso dello strumento.

  • databricks-claude-sonnet-4-6
  • databricks-claude-sonnet-4-5
  • databricks-claude-opus-4-7
  • databricks-claude-opus-4-6
  • databricks-claude-opus-4-5
  • databricks-claude-opus-4-1
  • databricks-claude-sonnet-4

Limitazioni

  • La ricerca Web è disponibile solo sugli endpoint del modello di base con pagamento in base al token. Gli endpoint di throughput con provisioning non supportano la ricerca web.
  • I modelli esterni non supportano la ricerca Web tramite Azure Databricks.
  • 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

  • Last updated on