Agents verbinden met hulpprogramma's

Het verbinden van uw agents met hulpprogramma's biedt praktische mogelijkheden buiten het genereren van tekst, zoals het doorzoeken van documenten, het uitvoeren van query's op tabellen, het aanroepen van externe API's of het uitvoeren van aangepaste code.

In het diagram ziet u de MCP-route, die Azure Databricks aanbeveelt voor de meeste integraties. MCP is een van de verschillende manieren om agents te verbinden met externe services. Naast MCP-services kunt u REST API's rechtstreeks aanroepen via een HTTP-verbinding van Unity Catalog. Kies Beheerde OAuth voor authenticatie per gebruiker, de proxy voor Unity Catalog-verbindingen om API's aan te roepen vanuit agentcode, of functiehulpmiddelen van Unity Catalog die http_request() verpakken. De volgende tabel bevat een overzicht van elke manier om verbinding te maken, van Azure Databricks gegevens naar externe services:

Approach	Aanbevolen gebruikssituatie
Beheerde MCP-servers voor Azure Databricks gegevens	Gebruik deze methode om query's uit te voeren op Azure Databricks gegevens en beheerde functies uit te voeren met de kant-en-klare Genie-, Databricks AI Search-, Databricks SQL- en Unity Catalog-functie MCP-servers.
Externe MCP-servers	Gebruik deze methode voor services die een MCP-server publiceren. Het biedt automatische detectie van hulpprogramma's en beheerde toegang via Unity AI Gateway.
Beheerde OAuth	Gebruik deze methode voor Google Drive- of SharePoint-integraties. Azure Databricks beheert de OAuth-referenties, dus er is geen app-registratie vereist.
Proxy voor Unity Catalog-verbindingen	Gebruik deze methode om directe REST API-aanroepen uit agentcode uit te voeren met behulp van de eigen client-SDK van de externe service.
Hulpmiddelen voor Unity Catalog-functies	Gebruik deze methode voor op SQL gebaseerde hulpprogrammadefinities waarmee de `http_request()` functie wordt verpakt.

Beheerde MCP-servers voor Azure Databricks gegevens

Azure Databricks biedt kant-en-klare beheerde MCP-servers die agents toegang geven tot gegevens en functies in uw werkruimte, zonder dat er een server hoeft te worden gebouwd of gehost. Elke server heeft een toegewezen URL en OAuth-bereik en Unity Catalog bepaalt de toegang:

Genie: Query's uitvoeren op gestructureerde gegevens in Genie Agents en Unity Catalog-tabellen met natuurlijke taal.
Databricks AI Search (vector search): zoek documenten in vectorzoekindexen.
Databricks SQL: SQL-query's uitvoeren op Unity Catalog-tabellen.
Unity Catalog-functies: aangepaste Python en SQL-functies aanroepen die zijn geregistreerd in Unity Catalog.

Zie Azure Databricks beheerde MCP-servers voor server-URL's, OAuth-bereiken en de volledige catalogus. Zie MCP-servers in agents gebruiken om deze servers aan te roepen vanuit agentcode.

Externe MCP-servers

Verbind uw agents met externe toepassingen, zoals Slack, Google Calendar of een service met een API. Azure Databricks biedt verschillende mogelijkheden, afhankelijk van of de externe service een MCP-server heeft, of u authenticatie per gebruiker nodig hebt, of dat u API's liever rechtstreeks vanuit de agentcode aanroept. Alle benaderingen zijn afhankelijk van een UNITY Catalog HTTP-verbinding, die beveiligd, beheerd referentiebeheer biedt en ondersteuning biedt voor meerdere verificatiemethoden, waaronder OAuth 2.0 U2M-verificatie (user-to-machine) en M2M-verificatie (machine-to-machine).

Als er een MCP-server beschikbaar is voor de externe service, raadt Azure Databricks u aan deze te registreren als een MCP-service in Unity Catalog. MCP-services bieden automatische detectie van hulpprogramma's, verificatie per gebruiker en governance via Unity AI Gateway met subsidies, selectie van hulpprogramma's en servicebeleid.

Zie Een externe MCP-server registreren om een externe MCP-server te registreren als een MCP-service en deze te beheren. Zie stap 1 voor het instellen van verbindingen en verificatie . Maak een verbinding.
Zie MCP-servers gebruiken in agents voor codevoorbeelden per agentframework (OpenAI Agents SDK, LangGraph, Model Serving).

Voor veelgebruikte SaaS-hulpprogramma's (software-as-a-service), zoals Slack, GitHub en Google Drive, biedt Azure Databricks gebruiksklare MCP-services zonder installatie. Zie MCP-services van Databricks.

Beheerde OAuth

Azure Databricks biedt beheerde OAuth-stromen voor geselecteerde API-hulpprogrammaproviders. U hoeft uw eigen OAuth-app niet te registreren of referenties te beheren. Azure Databricks raadt Managed OAuth aan voor ontwikkeling en testen. Als voor productiegebruiksscenario's aangepaste OAuth-referenties moeten worden gegenereerd, raadpleegt u de documentatie van de providers voor meer informatie.

De volgende integraties maken gebruik van OAuth-referenties die veilig worden beheerd en opgeslagen in de back-end Azure Databricks.

Provider	Configuratieopmerkingen	Ondersteunde toepassingsgebieden	Description
Google Drive-API	Geen	`https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/spreadsheets.readonly offline_access`	Alleen-lezentoegang tot Google Drive-bestanden, waaronder Google Docs en Google Sheets.
Gmail-API	Geen	`https://www.googleapis.com/auth/gmail.readonly offline_access`	Alleen-leestoegang tot Gmail-berichten, gespreksreeksen, concepten en labels.
Google Agenda-API	Geen	`https://www.googleapis.com/auth/calendar.readonly offline_access`	Alleen-lezentoegang tot agenda-items, agenda's en beschikbaarheidsinfo van Google Agenda.
SharePoint-API	Geen	https://graph.microsoft.com/User.Read https://graph.microsoft.com/User.ReadBasic.All https://graph.microsoft.com/Sites.Read.All https://graph.microsoft.com/Files.Read https://graph.microsoft.com/Files.Read.All https://graph.microsoft.com/Mail.Read https://graph.microsoft.com/Mail.ReadBasic https://graph.microsoft.com/Mail.Read.Shared https://graph.microsoft.com/MailboxFolder.Read https://graph.microsoft.com/MailboxItem.Read https://graph.microsoft.com/Calendars.Read https://graph.microsoft.com/Calendars.Read.Shared https://graph.microsoft.com/Chat.Read https://graph.microsoft.com/Chat.ReadBasic https://graph.microsoft.com/ChatMember.Read https://graph.microsoft.com/ChatMessage.Read https://graph.microsoft.com/Channel.ReadBasic.All https://graph.microsoft.com/ChannelMessage.Read.All https://graph.microsoft.com/OnlineMeetings.Read https://graph.microsoft.com/OnlineMeetingTranscript.Read.All https://graph.microsoft.com/OnlineMeetingAiInsight.Read https://graph.microsoft.com/OnlineMeetingArtifact.Read.All https://graph.microsoft.com/OnlineMeetingRecording.Read.All offline_access openid profile email	Alleen-lezen-toegang via Microsoft Graph tot SharePoint- en OneDrive-bestanden, Outlook-e-mail en -agenda, en Microsoft Teams-chats, -kanalen en -vergaderingen.

Als u beheerde OAuth wilt instellen, maakt u een HTTP-verbinding met het verificatietype OAuth-gebruiker naar machine per gebruiker en selecteert u uw provider in de vervolgkeuzelijst OAuth-provider . Zie Een verbinding met de externe service maken voor gedetailleerde stappen.

De provider vraagt elke gebruiker om toestemming te geven voor het eerste gebruik.

Indien nodig, voegt u de volgende redirect URI's toe aan de toelatingslijst die door beheerde OAuth worden gebruikt:

Wolk	Omleidings-URL
AWS	`https://oregon.cloud.databricks.com/api/2.0/http/oauth/redirect`
Azure	`https://westus.azuredatabricks.net/api/2.0/http/oauth/redirect`
GCP	`https://us-central1.gcp.databricks.com/api/2.0/http/oauth/redirect`

Voor beheerde OAuth-providers met een gepubliceerde MCP-server, zoals Glean, GitHub, Atlassian en Slack, kunnen Azure Databricks de OAuth-referenties beheren wanneer u de server registreert als een MCP-service. Zie Beheerde OAuth-providers.

Proxy-eindpunt voor Unity Catalog-verbindingen

Gebruik het proxy-eindpunt voor Unity Catalog-verbindingen met de eigen client-SDK van de externe service om REST API's rechtstreeks vanuit agentcode aan te roepen. Wijs de basis-URL van de SDK naar het proxy-eindpunt en gebruik uw Azure Databricks-token als de API-sleutel. Azure Databricks verifieert de aanvraag en injecteert automatisch de referenties van de externe service vanuit de Unity Catalog-verbinding. Uw code verwerkt de tokens van de externe service niet rechtstreeks.

Vereiste machtigingen:USE CONNECTION op het verbindingsobject.

OpenAI

Gebruik DatabricksOpenAI om oproepen naar externe OpenAI te routeren via de Unity Catalog-verbindingen proxy. Maak eerst een UNITY Catalog HTTP-verbinding met behulp van uw OpenAI API-sleutel die is opgeslagen als een Databricks-geheim:

CREATE CONNECTION openai_connection TYPE HTTP
OPTIONS (
  host 'https://api.openai.com',
  base_path '/v1',
  bearer_token secret ('<secret-scope>', '<secret-key>')
);

Installeer vervolgens het databricks-openai pakket en gebruik de proxy-URL en werkruimteclient in uw agentcode:

pip install databricks-openai

from databricks_openai import DatabricksOpenAI
from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

client = DatabricksOpenAI(
    workspace_client=w,
    base_url=f"{w.config.host}/api/2.0/unity-catalog/connections/openai_connection/proxy/",
)

response = client.chat.completions.create(
    model="gpt-4o",
    messages=[{"role": "user", "content": "Hello!"}],
)
print(response.choices[0].message.content)

Slack

Configureer de Slack SDK om te routeren via de Unity Catalog-verbindingenproxy. Maak een Unity Catalog HTTP-verbinding met host https://slack.com en basispad /apien gebruik vervolgens de proxy-URL als de SDK-basis-URL:

from slack_sdk import WebClient
from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

client = WebClient(
    token=w.config.authenticate()["Authorization"].split(" ")[1],
    base_url=f"{w.config.host}/api/2.0/unity-catalog/connections/slack_connection/proxy/",
)

result = client.chat_postMessage(channel="C123456", text="Hello from Databricks!")
print(result["message"]["text"])

Algemene HTTP

Voor services zonder een toegewezen SDK gebruikt u de requests bibliotheek rechtstreeks met de proxy-URL:

import requests
from databricks.sdk import WorkspaceClient

w = WorkspaceClient()

response = requests.post(
    f"{w.config.host}/api/2.0/unity-catalog/connections/my_connection/proxy/api/v1/resource",
    headers={
        **w.config.authenticate(),
        "Content-Type": "application/json",
    },
    json={"key": "value"},
)

Zie Aanvragen doorsturen via de HTTP-verbindingsproxy voor meer informatie over het proxy-eindpunt, ondersteunde verificatiemethoden en het instellen van verbindingen.

Hulpprogramma's voor Unity Catalog-functies

Note

Azure Databricks raadt u aan MCP Services of de Proxy voor Unity Catalog-verbindingen te gebruiken voor nieuwe integraties. Functiehulpmiddelen van Unity Catalog met http_request worden nog steeds ondersteund, maar zijn niet langer de aanbevolen aanpak.

U kunt een Unity Catalog-functie maken die wordt verpakt http_request() om externe services aan te roepen. Deze methode is handig voor op SQL gebaseerde hulpprogrammadefinities, zoals een functie die een bericht in Slack plaatst. Zie Externe API's aanroepen met http_request (verouderd) voor het volledige overzicht, inclusief het SQL-voorbeeld en de beperkingen van het verbindingstype.

Voorbeeldnotitieboeken

De volgende notebooks laten zien hoe u AI-agenthulpprogramma's maakt die verbinding maken met Slack, OpenAI en Azure AI Zoeken.

Zie Een AI-agent verbinden met Microsoft Teams voor een overzicht van het verbinden van een agent met Microsoft Teams.

Aanvullende bronnen

Verbind agents met hulpprogramma's van derden met MCP-services om externe MCP-servers te registreren en te beheren.
Maak AI-agenthulpprogramma's met behulp van Unity Catalog-functies om hulpprogramma's voor Unity Catalog-functies te bouwen, inclusief de verouderde http_request benadering.
Integreer Unity Catalog-hulpprogramma's met generatieve AI-frameworks van derden om Unity Catalog-hulpprogramma's te gebruiken met LangChain, LlamaIndex, OpenAI en Anthropic.
Maak verbinding met externe HTTP-services om HTTP-verbindingen en de proxy voor verbindingen te configureren.

Feedback

Is deze pagina nuttig?

Last updated on 2026-07-09