Zoeken op internet op Azure Databricks

Deze pagina beschrijft hoe je antwoorden kunt baseren op realtime informatie van het web op Azure Databricks. Gebruik een webzoekserver met Model Context Protocol (MCP) om MCP-compatibele clients en agents te verbinden met webzoektools.

Tip

Genie Code kan dit voor je doen. Probeer dit voorbeeldprompt:

Query the system.ai.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.

Met een webzoekopdracht kunnen fundamentele modellen actuele informatie van het internet ophalen tijdens het genereren van reacties. Wanneer zoeken op internet is ingeschakeld, kan het model op internet zoeken naar relevante informatie en deze opnemen in het antwoord. Dit is handig voor vragen over actuele gebeurtenissen, recente gegevens of een onderwerp waarin realtime informatie het antwoord verbetert.

Schakel webzoeken in voor MCP-compatibele clients en agenten door gebruik te maken van een webzoek-MCP-server, zoals You.com van Azure Databricks Marketplace.

Webzoekopdracht via MCP

MCP-compatibele clients en agenten kunnen onafhankelijk van hun modelprovider een webzoektool aanroepen. Verbind je client of agent met een webzoekdienst of -server met MCP.

Het systeemeigen hulpprogramma voor zoeken op internet van Antropic is niet beschikbaar via Azure Databricks Foundation Model-API's. Gebruik MCP om webzoektools te bieden aan agenten die Anthropic-modellen gebruiken.

Het instellen van de You.com MCP-server

You.com is een alternatief van derden voor MCP-compatibele clients en agenten.

  1. Navigeer naar Marketplace > Agents > MCP Servers in uw Azure Databricks werkruimte.
  2. Zoek You.com en klik op Installeren.
  3. De verbinding configureren:
  • Verbindingsnaam: Voer een naam in (bijvoorbeeld youcom_web_search).
  • Bearer-token: voer uw You.com API-sleutel in.
  1. Klik op Installeren.
  2. Ververleent USE CONNECTION-bevoegdheden aan de juiste gebruikers of groepen onder Catalogusverbindingen >> [uw verbinding] > Machtigingen.

Na de installatie is de MCP-server beschikbaar als een hulpprogramma in AI Playground, agents en andere MCP-compatibele clients. De URL van het proxy-eindpunt voor uw verbinding is:

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

Gebruik You.com met Claude Code

Om You.com te gebruiken met Claude Code en Azure Databricks Foundation Model API's, voeg je de You.com MCP-server toe:

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

Controleer of de server is toegevoegd met claude mcp list.

U kunt de server ook rechtstreeks toevoegen aan ~/.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>"
      }
    }
  }
}

Ondersteunde modellen

MCP-webzoekopdracht vereist een klant of agent die MCP-tools kan aanroepen. Het is niet beperkt tot een specifieke modelaanbieder. Voor agentintegratie, zie Gebruik MCP-tools in een Python-agent.

Gegevensprivacy en -behoud

Wanneer je webzoekopdracht inschakelt via Azure Databricks Foundation Model API's, draait de zoekopdracht op een door Azure Databricks gehoste Foundation Model endpoint. De zoekopdracht en resultaten worden verwerkt door het gehoste model, ongeacht welk model je applicatie aanroept. Dezelfde gegevensbeschermings- en bewaringsvoorwaarden die Model Serving regelen, gelden voor deze verzoeken:

  • Azure Databricks gebruikt geen invoer die naar Model Serving wordt gestuurd, of uitvoer daarvan, om modellen te trainen. Zie Model Serving gegevensbescherming.
  • Elke tijdelijke opslag voor misbruikdetectie wordt in dezelfde regio als je werkruimte bewaard en is tijdsgebonden. Zie gegevensretentie.

Het model formuleert zoekopdrachten op basis van je prompt en stuurt deze naar een externe zoekprovider om resultaten op te halen. Behandel promptinhoud die bij webzoekopdrachten terechtkomt als gegevens die Azure Databricks verlaten en naar de zoekprovider gaan, en beperk daarom welke gegevens je toepassing verzendt.

Beperkingen

  • Zoeken op internet is niet beschikbaar voor werkruimten waarvoor HIPAA/BAA-naleving is ingeschakeld, omdat webzoekquery's worden verzonden naar externe zoekservices die niet compatibel zijn met HIPAA.
  • Webzoekresultaten zijn afhankelijk van de mogelijkheid van het model om zoekquery's te formuleren en resultaten te synthetiseren. De responskwaliteit kan variëren.

Aanvullende bronnen

  • Laatst bijgewerkt om