Ajanları araçlara bağlayın

Aracılarınızı araçlara bağlamak, belge arama, tabloları sorgulama, dış API'leri çağırma veya özel kod çalıştırma gibi metin oluşturmanın ötesinde pratik özellikler sunar.

Diyagramda, tümleştirmelerin çoğu için öneren Azure Databricks MCP yolu gösterilmektedir. MCP, aracıları dış hizmetlere bağlamanın çeşitli yollarından biridir. MCP Hizmetleri'nin yanı sıra REST API'lerini doğrudan Unity Kataloğu HTTP bağlantısı üzerinden çağırabilirsiniz. Kullanıcı başına kimlik doğrulaması için Managed OAuth'u, aracı kodundan API'leri çağırmak için Unity Catalog connections proxy'sini veya http_request() sarmalayan Unity Catalog function tools'u seçin. Aşağıdaki tabloda, Azure Databricks verilerden dış hizmetlere bağlanmanın her yolu özetlenmektedir:

Approach	Önerilen kullanım örneği
Azure Databricks verileri için yönetilen MCP sunucuları	Kullanıma hazır Genie, Databricks AI Search, Databricks SQL ve Unity Catalog işlevi MCP sunucularıyla Azure Databricks verileri sorgulamak ve idare edilen işlevleri çalıştırmak için bu yaklaşımı kullanın.
Dış MCP sunucuları	McP sunucusu yayımlayan hizmetler için bu yaklaşımı kullanın. Unity AI Gateway aracılığıyla araçların otomatik olarak keşfedilmesini ve yönetilen erişimi sunar.
Yönetimli OAuth	Google Drive veya SharePoint tümleştirmeleri için bu yaklaşımı kullanın. Azure Databricks OAuth kimlik bilgilerini yönetir, bu nedenle uygulama kaydı gerekmez.
Unity Kataloğu bağlantıları ara sunucusu	Dış hizmetin kendi istemci SDK'sını kullanarak aracı kodundan doğrudan REST API çağrıları yapmak için bu yaklaşımı kullanın.
Unity Catalog işlev araçları	İşlevi sarmalayan `http_request()` SQL tabanlı araç tanımları için bu yaklaşımı kullanın.

Azure Databricks verileri için yönetilen MCP sunucuları

Azure Databricks, aracılara çalışma alanınızdaki verilere ve işlevlere idare edilen erişim sağlayan, derlemek veya barındırmak için sunucusu olmayan kullanıma hazır yönetilen MCP sunucuları sunar. Her sunucunun ayrılmış bir URL'si ve OAuth kapsamı vardır ve Unity Kataloğu erişimi yönetir:

Genie: Genie Aracıları ve Unity Kataloğu tablolarında yapılandırılmış verileri doğal dille sorgulama.
Databricks AI Arama (vektör araması): Vektör arama dizinlerinde belgeleri arayın.
Databricks SQL: Unity Kataloğu tablolarında SQL sorguları çalıştırın.
Unity Kataloğu işlevleri: Unity Kataloğu'nda kayıtlı özel Python ve SQL işlevlerini çağır.

Sunucu URL'leri, OAuth kapsamları ve tam katalog için bkz. Azure Databricks yönetilen MCP sunucuları. Aracı kodundan bu sunucuları çağırmak için bkz. Aracılarda MCP sunucularını kullanma.

Dış MCP sunucuları

Aracılarınızı Slack, Google Takvim gibi dış uygulamalara veya API ile herhangi bir hizmete bağlayın. Azure Databricks, dış hizmetin BIR MCP sunucusuna sahip olup olmadığına, kullanıcı başına kimlik doğrulamasına ihtiyacınız olup olmadığına veya API'leri doğrudan aracı kodundan çağırmayı tercih etmenize bağlı olarak çeşitli yaklaşımlar sunar. Tüm yaklaşımlar, güvenli, yönetilen kimlik bilgileri yönetimi sağlayan ve OAuth 2.0 kullanıcıdan makineye (U2M) ve makineden makineye (M2M) kimlik doğrulaması dahil olmak üzere birden çok kimlik doğrulama yöntemini destekleyen bir Unity Kataloğu HTTP bağlantısına dayanır.

Dış hizmetin kullanılabilir bir MCP sunucusu varsa, Azure Databricks bunu Unity Kataloğu'nda MCP Hizmeti olarak kaydetmenizi önerir. MCP Hizmetleri, Unity AI Gateway aracılığıyla izinler, araç seçimi ve hizmet ilkeleriyle birlikte otomatik araç keşfi, kullanıcı başına kimlik doğrulaması ve yönetişim sağlar.

Bir harici MCP sunucusunu MCP hizmeti olarak kaydetmek ve yönetmek için Harici bir MCP sunucusunu kaydetme bölümüne bakın. Bağlantı ve kimlik doğrulaması kurulumu için bkz . 1. Adım. Bağlantı oluşturun.
Aracı çerçevesi başına kod örnekleri için bkz. Aracılarda MCP sunucularını kullanma (OpenAI Aracıları SDK'sı, LangGraph, Model Sunma).

Slack, GitHub ve Google Drive gibi yaygın olarak kullanılan hizmet olarak yazılım (SaaS) araçları için Azure Databricks, sıfır kurulumla kullanıma hazır MCP Hizmetleri sağlar. Bkz. Databricks tarafından sağlanan MCP Hizmetleri.

Yönetilen OAuth

Azure Databricks, belirli API aracı sağlayıcıları için yönetilen OAuth akışları sunar. Kendi OAuth uygulamanızı kaydetmeniz veya kimlik bilgilerini yönetmeniz gerekmez. Azure Databricks, geliştirme ve test için Yönetilen OAuth'u önerir. Üretim kullanım örnekleri özel OAuth kimlik bilgileri oluşturulmasını gerektiriyorsa daha fazla bilgi için sağlayıcıların belgelerine bakın.

Aşağıdaki tümleştirmeler, Azure Databricks tarafından arka uçta güvenli bir şekilde yönetilen ve depolanan OAuth kimlik bilgilerini kullanır.

Provider	Yapılandırma notları	Desteklenen kapsamlar	Açıklama
Google Drive API'si	Hiçbiri	`https://www.googleapis.com/auth/drive.readonly https://www.googleapis.com/auth/documents.readonly https://www.googleapis.com/auth/spreadsheets.readonly offline_access`	Google Docs ve Google E-Tablolar da dahil olmak üzere Google Drive dosyalarına salt okunur erişim.
Gmail API'si	Hiçbiri	`https://www.googleapis.com/auth/gmail.readonly offline_access`	Gmail iletilerine, yazışmalara, taslaklara ve etiketlere salt okunur erişim.
Google Takvim API'si	Hiçbiri	`https://www.googleapis.com/auth/calendar.readonly offline_access`	Google Takvim etkinliklerine, takvimlerine ve serbest/meşgul bilgilerine salt okunur erişim.
SharePoint API'si	Hiçbiri	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	Microsoft Graph aracılığıyla SharePoint ve OneDrive dosyalarına, Outlook e-postası ve takvimine, ayrıca Microsoft Teams sohbetlerine, kanallarına ve toplantılarına salt okunur erişim.

Yönetilen OAuth'u ayarlamak için, OAuth Kullanıcıdan Makineye Kullanıcı Başına Makine kimlik doğrulaması türüyle bir HTTP bağlantısı oluşturun ve OAuth Sağlayıcısı açılan menüsünden sağlayıcınızı seçin. Ayrıntılı adımlar için bkz. Dış hizmete bağlantı oluşturma.

Sağlayıcı, her kullanıcıdan ilk kullanımda yetkilendirmesini ister.

Gerekirse, yönetilen OAuth tarafından kullanılan aşağıdaki yeniden yönlendirme URI'lerini izin verilenler listesine ekleyin:

Bulut	Yeniden yönlendirme URI'si
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`

Glean, GitHub, Atlassian ve Slack gibi yayımlanmış bir MCP sunucusuna sahip yönetilen OAuth sağlayıcıları için, Azure Databricks sunucuyu BIR MCP Hizmeti olarak kaydettiğinizde OAuth kimlik bilgilerini yönetebilir. Bkz. Yönetilen OAuth sağlayıcıları.

Unity Catalog bağlantıları için proxy uç noktası

REST API'lerini doğrudan agent kodundan çağırmak için Unity Kataloğu bağlantıları proxy uç noktasını dış hizmetin kendi istemci SDK'sı ile kullanın. SDK'nın temel URL'sini ara sunucu uç noktasına işaret edin ve API anahtarı olarak Azure Databricks belirtecinizi kullanın. Azure Databricks isteğin kimliğini doğrular ve Unity Kataloğu bağlantısından dış hizmetin kimlik bilgilerini otomatik olarak ekler. Kodunuz dış hizmetin belirteçlerini doğrudan işlemez.

Gerekli izinler:USE CONNECTION bağlantı nesnesi üzerinde.

OpenAI

OpenAI'ye harici çağrıları yönlendirmek için Unity Kataloğu bağlantılarının ara sunucusunu DatabricksOpenAI kullanarak kullanın. İlk olarak, Databricks "secret" olarak saklanan OpenAI API anahtarınızı kullanarak bir Unity Catalog HTTP bağlantısı oluşturun:

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

Ardından paketi yükleyin databricks-openai ve aracı kodunuzda proxy URL'sini ve çalışma alanı istemcisini kullanın:

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

Slack SDK'sını Unity Kataloğu bağlantıları ara sunucusu üzerinden yönlendirecek şekilde yapılandırın. Ana bilgisayar https://slack.com ve temel dizin /api ile bir Unity Catalog HTTP bağlantısı oluşturun ve ardından SDK temel URL'si olarak proxy URL'sini kullanın.

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

Genel HTTP

Ayrılmış SDK'sı olmayan hizmetler için requests kitaplığını doğrudan proxy URL'si ile kullanın.

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"},
)

Ara sunucu uç noktası, desteklenen kimlik doğrulama yöntemleri ve bağlantı kurulumuyla ilgili ayrıntılar için bkz. İstekleri HTTP bağlantı ara sunucusu aracılığıyla iletme.

Unity Kataloğu işlev araçları

Note

Azure Databricks, yeni tümleştirmeler için MCP Hizmetleri'nin veya Unity Kataloğu bağlantı ara sunucusunun kullanılmasını önerir. Unity Catalog fonksiyon araçları http_request ile desteklenmeye devam ediyor, ancak artık önerilen yöntem değildir.

Dış hizmetleri çağırmak için http_request() sarmalayan bir Unity Kataloğu işlevi oluşturabilirsiniz. Bu yaklaşım, Slack'e ileti gönderen bir işlev gibi SQL tabanlı araç tanımları için kullanışlıdır. SQL örneği ve bağlantı türü sınırlamaları dahil olmak üzere tam izlenecek yol için bkz. Dış API'leri (eski) ile http_request çağırma.

Örnek not defterleri

Aşağıdaki notebook’lar, Slack, OpenAI ve Azure Yapay Zeka Arama’e bağlanan yapay zekâ aracı araçlarının nasıl oluşturulacağını gösterir.

Aracıyı Microsoft Teams bağlama konusunda izlenecek yol için bkz. Yapay zeka aracısını Microsoft Teams bağlama.

Ek kaynaklar

Dış MCP sunucularını kaydetmek ve yönetmek için MCP Hizmetleri ile aracıları üçüncü taraf araçlara bağlayın.
Unity Catalog işlevlerini kullanarak yapay zeka aracısı araçları oluşturun; buna Unity Catalog işlevi araçlarını oluşturmaya yönelik eski http_request yaklaşım da dahildir.
Unity Kataloğu araçlarını LangChain, LlamaIndex, OpenAI ve Anthropic ile kullanmak için Unity Kataloğu araçlarını üçüncü taraf oluşturucu yapay zeka çerçeveleriyle tümleştirin.
HTTP bağlantılarını ve bağlantı ara sunucusunu yapılandırmak için dış HTTP hizmetlerine bağlanın.

Geri Bildirim

Bu sayfayı yararlı buldunuz mu?

Last updated on 2026-07-09

Ajanları araçlara bağlayın

Azure Databricks verileri için yönetilen MCP sunucuları

Dış MCP sunucuları

Yönetilen OAuth

Unity Catalog bağlantıları için proxy uç noktası

OpenAI

Slack

Genel HTTP

Unity Kataloğu işlev araçları

Örnek not defterleri

Slack mesajlaşma aracı

Microsoft Graph API aracı

Azure AI Arama aracı

Ek kaynaklar

Geri Bildirim

Ek kaynaklar