Webbsökning på Azure Databricks

Denna sida beskriver hur man förankrar svar med realtidsinformation från webben på Azure Databricks. Använd en webbsökserver med Model Context Protocol (MCP) för att koppla MCP-kompatibla klienter och agenter till webbsökverktyg.

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.

Vad är webbsökning?

Med webbsökning kan grundmodeller hämta uppdaterad information från internet under svarsgenerering. När webbsökning är aktiverat kan modellen söka på webben för att hitta relevant information och införliva den i svaret. Detta är användbart för frågor om aktuella händelser, senaste data eller något ämne där realtidsinformation förbättrar svaret.

Använda webbsökning

Aktivera webbsökning för MCP-kompatibla klienter och agenter genom att använda en webbsöknings-MCP-server, såsom You.com från Azure Databricks Marketplace.

Webbsökning via MCP

MCP-kompatibla klienter och agenter kan anropa ett webbsökverktyg oberoende av sin modellleverantör. Koppla din klient eller agent till en webbsök-MCP-tjänst eller server med MCP.

Anthropics interna webbsökningsverktyg är inte tillgängligt via api:erna för Azure Databricks Foundation Model. Använd MCP för att tillhandahålla webbsökverktyg till agenter som använder Anthropic-modeller.

Konfigurera You.com MCP-servern

You.com är ett tredjepartsalternativ för MCP-kompatibla klienter och agenter.

1. Gå till Marketplace > Agents > MCP-Servrar på din Azure Databricks-arbetsyta.
2. Sök efter You.com och klicka på Installera.
3. Konfigurera anslutningen:

• Anslutningsnamn: Ange ett namn (till exempel youcom_web_search).
• Bearer-token: Ange din You.com API-nyckel.

4. Klicka på Installera.
5. Bevilja BEHÖRIGHETER FÖR ANVÄNDNINGSANSLUTNING till lämpliga användare eller grupper under Kataloganslutningar >> [din anslutning] > Behörigheter.

Efter installationen är MCP-servern tillgänglig som ett verktyg i AI Playground, agenter och andra MCP-kompatibla klienter. Url:en för proxyslutpunkten för anslutningen är:

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

Använd You.com med Claude Code

För att använda You.com med Claude Code och Azure Databricks Foundation Model API:er, lägg till den You.com MCP-servern:

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>"

Kontrollera att servern har lagts till med claude mcp list.

Du kan också lägga till servern direkt i ~/.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>"
      }
    }
  }
}

Modeller som stöds

MCP-webbsökning kräver en klient eller agent som kan anropa MCP-verktyg. Det är inte begränsat till en specifik modellleverantör. För agentintegration, se Använd MCP-verktyg i en Python-agent.

Dataskydd och lagring

När du aktiverar webbsökning via Azure Databricks Foundation Model API:er körs sökningen på en Azure Databricks-hostad Foundation Model-endpoint. Sökfrågan och resultaten bearbetas av den hostade modellen oavsett vilken modell din applikation anropar. Samma villkor för dataskydd och lagring som styr Model Serving gäller för dessa förfrågningar:

• Azure Databricks använder inte indata som skickas till Model Serving, eller utdata från den, för att träna modeller. Se Model Serving dataskydd.
• All tillfällig lagring för missbruksdetektering förvaras i samma region som din arbetsplats och är tidsbegränsad. Se Databevarande.

Modellen formulerar sökfrågor från din prompt och skickar dem till en extern sökleverantör för att hämta resultat. Behandla promptinnehåll som når webbsökning som data som lämnar Azure Databricks för sökleverantören, och begränsa vad din applikation skickar därefter.

Begränsningar

• Webbsökning är inte tillgängligt för arbetsytor med HIPAA/BAA-efterlevnad aktiverat eftersom webbsökningsfrågor skickas till externa söktjänster som inte är HIPAA-kompatibla.
• Webbsökningsresultat beror på modellens förmåga att formulera sökfrågor och syntetisera resultat. Svarskvaliteten kan variera.

Ytterligare resurser

• Funktionsanrop på Azure Databricks.
• Fråga en chattmodell.