Websuche auf Azure Databricks

Diese Seite beschreibt, wie man Antworten auf Azure Databricks mit Echtzeitinformationen aus dem Web untermauert. Verwenden Sie einen Websuchserver mit Model Context Protocol (MCP), um MCP-kompatible Clients und Agenten mit Websuchwerkzeugen zu verbinden.

Tip

Genie Code kann das für dich übernehmen. Probieren Sie diese Beispielaufforderung aus:

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.

Die Websuche ermöglicht es Foundation-Modellen, während der Generierung von Antworten aktuelle Informationen aus dem Internet abzurufen. Wenn die Websuche aktiviert ist, kann das Modell das Web durchsuchen, um relevante Informationen zu finden und in seine Antwort zu integrieren. Dies ist nützlich für Fragen zu aktuellen Ereignissen, aktuellen Daten oder themen, in denen Echtzeitinformationen die Antwort verbessern.

Aktivieren Sie die Websuche für MCP-kompatible Clients und Agenten durch die Nutzung eines Websuch-MCP-Servers, wie You.com von Azure Databricks Marketplace.

Websuche über MCP

MCP-kompatible Clients und Agenten können unabhängig von ihrem Modellanbieter ein Web-Suchtool aufrufen. Verbinde deinen Client oder Agent mit einem Websuch-MCP-Dienst oder -Server über MCP.

Das systemeigene Websuchtool von Anthropic ist über Azure Databricks Foundation Model-APIs nicht verfügbar. Nutzen Sie MCP, um Agenten, die Anthropic-Modelle verwenden, Websuchwerkzeuge bereitzustellen.

Einrichten des You.com MCP-Servers

You.com ist eine Drittanbieter-Alternative für MCP-kompatible Clients und Agenten.

  1. Navigieren Sie zu Marketplace > Agents > MCP Servers in Ihrem Azure Databricks Arbeitsbereich.
  2. Suchen Sie nach You.com , und klicken Sie auf "Installieren".
  3. Konfigurieren Sie die Verbindung:
  • Verbindungsname: Geben Sie einen Namen ein (z. B youcom_web_search. ).
  • Bearertoken: Geben Sie Ihren You.com API-Schlüssel ein.
  1. Klicke auf Installieren.
  2. Gewähren Sie USE CONNECTION-Berechtigungen für die entsprechenden Benutzer oder Gruppen unter Katalog > Verbindungen > [Ihre Verbindung] > Berechtigungen.

Nach dem Setup ist der MCP-Server als Tool in AI Playground, Agents und anderen MCP-kompatiblen Clients verfügbar. Die Proxyendpunkt-URL für Ihre Verbindung lautet:

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

Verwenden Sie You.com mit Claude Code

Um You.com mit Claude Code und Azure Databricks Foundation Model APIs zu verwenden, fügen Sie den You.com MCP-Server hinzu:

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

Überprüfen Sie, ob der Server mit claude mcp list hinzugefügt wurde.

Alternativ können Sie den Server direkt zu ~/.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>"
      }
    }
  }
}

Unterstützte Modelle

Die MCP-Websuche erfordert einen Client oder Agenten, der die MCP-Tools aufrufen kann. Es ist nicht auf einen bestimmten Modellanbieter beschränkt. Für die Agentenintegration siehe Verwendung von MCP-Tools in einem Python-Agenten.

Datenschutz und Aufbewahrung von Daten

Wenn Sie die Websuche über Azure Databricks Foundation Model APIs aktivieren, wird die Suche auf einem von Azure Databricks gehosteten Foundation-Modell-Endpunkt durchgeführt. Die Suchanfrage und die Ergebnisse werden vom gehosteten Modell verarbeitet, unabhängig davon, welches Modell Ihre Anwendung aufruft. Die gleichen Datenschutz- und Aufbewahrungsbedingungen, die Model Serving gelten, gelten für diese Anfragen:

  • Azure Databricks verwendet keine Eingaben, die an Model Serving gesendet werden, oder Ausgaben davon, um Modelle zu trainieren. Siehe Datenschutz bei Model Serving.
  • Jede temporäre Speicherung zur Missbrauchserkennung wird in derselben Region wie Ihr Arbeitsbereich aufbewahrt und zeitlich begrenzt. Siehe Datenaufbewahrung.

Das Modell formuliert Suchanfragen aus Ihrem Prompt und sendet sie an einen externen Suchanbieter, um Ergebnisse abzurufen. Behandle Prompt-Inhalte, die die Websuche erreichen, als Daten, die Azure Databricks für den Suchanbieter verlassen, und plane entsprechend, was deine Anwendung sendet.

Einschränkungen

  • Die Websuche ist für Arbeitsbereiche mit aktivierter HIPAA/BAA-Compliance nicht verfügbar, da Websuchabfragen an externe Suchdienste gesendet werden, die nicht HIPAA-kompatibel sind.
  • Websuchergebnisse hängen von der Fähigkeit des Modells ab, Suchabfragen zu formulieren und Ergebnisse zu synthetisieren. Die Antwortqualität kann variieren.

Weitere Ressourcen

  • Zuletzt aktualisiert um