Aracılığıyla paylaş

Yapay zeka aracısı araçlarını dış hizmetlere bağlama

Important

Bu özellik Genel Önizleme aşamasındadır.

HTTP isteklerini kullanarak yapay zeka aracı araçlarını Slack, Google Takvim gibi dış uygulamalara veya API ile herhangi bir hizmete nasıl bağlayacağınızı öğrenin. Aracılar görevleri otomatikleştirmek, ileti göndermek ve üçüncü taraf platformlardan veri almak için dışarıdan bağlı araçları kullanabilir.

Requirements

  • Dış uygulamanız için Unity Kataloğu HTTP bağlantısı oluşturun. Unity Kataloğu bağlantıları güvenli, yönetilen kimlik bilgileri yönetimi sağlar ve OAuth 2.0 kullanıcıdan makineye ve makineden makineye kimlik doğrulaması dahil olmak üzere birden çok standart kimlik doğrulama yöntemini destekler.

Dış MCP sunucularından araçları kullanma

Bağlanmak istediğiniz dış hizmette kullanılabilir bir MCP sunucusu varsa, aracınızı bağlamanın en kolay yolu dış MCP sunucularıdır. Bu yaklaşım şunu sağlar:

  • Otomatik araç bulma: MCP sunucusu standart API'leri kullanarak tüm kullanılabilir araçları kullanıma sunar.
  • Basitleştirilmiş tümleştirme: Standart SDK'ları kullanarak araçları bağlama ve yürütme.
  • Azaltılmış bakım: Araç tanımları dış MCP sunucusu tarafından merkezi olarak yönetilir.

Ayrıntılı yönergeler için bkz. Dış MCP sunucularını kullanma .

Ajan kodunda araç oluşturma

Python ile dış hizmetlere HTTP istekleri göndermek için kitaplıktan databricks-sdk işlevini kullanın. Bu işlev, kimlik doğrulaması için Unity Kataloğu bağlantısı kullanarak bir dış hizmete HTTP isteği gönderir.

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

Aşağıdaki örnek, ajanın kodundan dışarıya bir HTTP isteği gönderir.

from databricks.sdk import WorkspaceClient
from databricks.sdk.service.serving import ExternalFunctionRequestHttpMethod

WorkspaceClient().serving_endpoints.http_request(
  conn="connection_name",
  method=ExternalFunctionRequestHttpMethod.POST,
  path="/api/v1/resource",
  json={"key": "value"},
  headers={"extra_header_key": "extra_header_value"},
)
  • conn: Sunucu, bağlantı noktası, base_path ve erişim kimlik bilgilerini belirten bağlantı nesnesi.
  • method: Çağrıyı yapmak için kullanılan HTTP istek yöntemi. Örneğin: GET, POST, PUT, DELETE
  • path: Hizmet kaynağını çağırmak için base_path sonrası birleştirme yolu.
  • json: İstekle birlikte gönderilecek JSON gövdesi.
  • headers: İstek üst bilgilerini belirtmek için bir harita.

Unity Kataloğu işlev aracı oluştur

Note

Kullanıcıdan Makineye Kullanıcı Başına bağlantı türü için http_request ile SQL erişimi engellenmiştir. Bunun yerine Python Databricks SDK'sını kullanın.

HTTP bağlantısını oluşturduktan ve düzgün çalışıp çalışmadığını test ettikten sonra, bağlantıyı kullanan bir Unity Kataloğu işlevi oluşturun. Aşağıdaki örnek, bir aracının Slack'e ileti göndermek için kullanabileceği bir Unity Kataloğu işlev aracısını oluşturur:

CREATE OR REPLACE FUNCTION main.default.slack_post_message(
  text STRING COMMENT 'message content'
)
RETURNS STRING
COMMENT 'Sends a Slack message by passing in the message and returns the response received from the external service.'
RETURN (http_request(
  conn => 'test_sql_slack',
  method => 'POST',
  path => '/api/chat.postMessage',
  json => to_json(named_struct(
    'channel', "C032G2DAH3",
    'text', text
  ))
)).text

bkz. CREATE FUNCTION (SQL ve Python).

Örnek not defterleri

Slack'e aracı bağlama

Bkz. Slack'e yapay zeka aracısını bağlama.

Bir aracıyı Microsoft Teams'e bağlama

Bkz . Microsoft Teams'e yapay zeka aracısı bağlama.

Dış bağlantı araçları

Aşağıdaki not defterleri Slack, OpenAI ve Azure AI aramasına bağlanan yapay zeka aracısı araçları oluşturmayı gösterir.

Slack mesajlaşma aracı

Dizüstü bilgisayar al

Microsoft Graph API aracı aracı

Dizüstü bilgisayar al

Azure AI Search aracı aracı

Dizüstü bilgisayar al

Sınırlamalar

  • Last updated on