Teilen über

Verbinden von KI-Agent-Tools mit externen Diensten

Important

Dieses Feature befindet sich in der Public Preview.

Erfahren Sie, wie Sie KI-Agent-Tools mit externen Anwendungen wie Slack, Google Calendar oder einem beliebigen Dienst mit einer API mithilfe von HTTP-Anforderungen verbinden. Agents können extern verbundene Tools verwenden, um Aufgaben zu automatisieren, Nachrichten zu senden und Daten von Drittanbieterplattformen abzurufen.

Requirements

  • Erstellen Sie eine Unity-Katalog-HTTP-Verbindung für Ihre externe Anwendung. Unity Catalog-Verbindungen bieten sichere, geregelte Anmeldeinformationsverwaltung und unterstützen mehrere Standardauthentifizierungsmethoden, einschließlich OAuth 2.0-Benutzer-zu-Computer- und Computer-zu-Computer-Authentifizierung.

Verwenden von Tools von externen MCP-Servern

Wenn der externe Dienst, mit dem Sie eine Verbindung herstellen möchten, über einen MCP-Server verfügbar ist, besteht die einfachste Möglichkeit, den Agent über externe MCP-Server zu verbinden. Dieser Ansatz bietet Folgendes:

  • Automatische Toolermittlung: Der MCP-Server macht alle verfügbaren Tools mit Standard-APIs verfügbar.
  • Vereinfachte Integration: Verbinden und Ausführen von Tools mithilfe von Standard-SDKs.
  • Reduzierte Wartung: Tooldefinitionen werden zentral vom externen MCP-Server verwaltet.

Ausführliche Anweisungen finden Sie unter Verwenden externer MCP-Server .

Erstellen eines Tools im Agentcode

Verwenden Sie die http_request-Funktion aus der databricks-sdk Bibliothek, um HTTP-Anforderungen an externe Dienste mit Python zu senden. Diese Funktion sendet eine HTTP-Anforderung an einen externen Dienst mithilfe einer Unity Catalog-Verbindung zur Authentifizierung.

Erforderliche Berechtigungen:USE CONNECTION auf dem Verbindungsobjekt.

Im folgenden Beispiel wird eine externe HTTP-Anforderung aus dem Agent-Code erstellt.

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: Das Verbindungsobjekt, das den Host, Port, base_path und die Zugriffsanmeldeinformationen angibt.
  • method: Die HTTP-Anforderungsmethode, die zum Ausführen des Aufrufs verwendet wird. Beispiel: GET, POST, PUT, DELETE
  • path: Der Pfad, der nach dem base_path verketten wird, um die Dienstressource aufzurufen.
  • json: Der JSON-Text, der mit der Anforderung gesendet werden soll.
  • headers: Eine Zuordnung zur Angabe der Header der Anfrage.

Erstellen eines Unity Catalog-Funktionstools

Note

SQL-Zugriff mit http_request ist für den Verbindungstyp "Benutzer-zu-Maschine für jeden Nutzer" blockiert. Verwenden Sie stattdessen das Python Databricks SDK.

Nachdem Sie die HTTP-Verbindung erstellt und getestet haben, dass sie ordnungsgemäß funktioniert, erstellen Sie eine Unity-Katalogfunktion, die die Verbindung verwendet. Im folgenden Beispiel wird ein Unity Catalog-Funktionstool erstellt, mit dem ein Agent eine Nachricht an Slack bereitstellen kann:

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

Siehe CREATE FUNCTION (SQL und Python).

Beispielnotebooks

Verbinden eines Agents mit Slack

Siehe Verbinden eines AI-Agents mit Slack.

Verbinden eines Agents mit Microsoft Teams

Siehe Verbinden eines KI-Agents mit Microsoft Teams.

Externe Verbindungstools

Die folgenden Notizbücher veranschaulichen das Erstellen von KI-Agent-Tools, die eine Verbindung mit der Slack-, OpenAI- und Azure AI-Suche herstellen.

Messagingagententool von Slack

Notebook abrufen

Microsoft Graph-API-Agent-Tool

Notebook abrufen

KI-Agent-Tool für Azure KI-Suche

Notebook abrufen

Einschränkungen

  • Last updated on