Łączenie narzędzi agenta sztucznej inteligencji z usługami zewnętrznymi

Dowiedz się, jak połączyć narzędzia agenta sztucznej inteligencji z aplikacjami zewnętrznymi, takimi jak Slack, Google Calendar lub dowolna usługa z interfejsem API przy użyciu żądań HTTP. Agenci mogą używać zewnętrznych narzędzi do automatyzowania zadań, wysyłania komunikatów i pobierania danych z platform innych firm.

Requirements

• Utwórz połączenie HTTP do Unity Catalog dla aplikacji zewnętrznej. Połączenia Unity Catalog zapewniają bezpieczne zarządzanie poświadczeniami i obsługują wiele standardowych metod uwierzytelniania, w tym uwierzytelnianie użytkownik-maszyna OAuth 2.0 oraz uwierzytelnianie maszyna-maszyna.

Korzystanie z narzędzi z zewnętrznych serwerów MCP

Jeśli usługa zewnętrzna, z którą chcesz nawiązać połączenie, ma dostępny serwer MCP, najprostszym sposobem połączenia agenta jest za pośrednictwem zewnętrznych serwerów MCP. Takie podejście zapewnia:

• Automatyczne odnajdywanie narzędzi: serwer MCP uwidacznia wszystkie dostępne narzędzia przy użyciu standardowych interfejsów API.
• Uproszczona integracja: łączenie i wykonywanie narzędzi przy użyciu standardowych zestawów SDK.
• Ograniczona konserwacja: definicje narzędzi są zarządzane centralnie przez zewnętrzny serwer MCP.

Aby uzyskać szczegółowe instrukcje, zobacz Używanie zewnętrznych serwerów MCP .

Tworzenie narzędzia w kodzie agenta

Aby wysyłać żądania HTTP do usług zewnętrznych za pomocą języka Python, użyj funkcji http_request z databricks-sdk biblioteki. Ta funkcja wysyła żądanie HTTP do usługi zewnętrznej przy użyciu połączenia Unity Catalog do uwierzytelnienia.

Wymagane uprawnienia:USE CONNECTION w obiekcie połączenia.

Poniższy przykład tworzy zewnętrzne żądanie HTTP z poziomu kodu agenta.

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: obiekt połączenia określający hosta, port, base_path i poświadczenia dostępu.
• method: metoda żądania HTTP użyta do wykonania wywołania. Na przykład: GET, POST, PUT, DELETE
• path: ścieżka do dołączenia po base_path w celu wywołania zasobu usługi.
• json: Treść JSON do wysłania z żądaniem.
• headers: Mapa określająca nagłówki żądań.

Utwórz narzędzie funkcji katalogu Unity

Po utworzeniu połączenia HTTP i przetestowaniu, czy działa prawidłowo, utwórz funkcję wykazu aparatu Unity korzystającą z połączenia. Poniższy przykład tworzy narzędzie funkcji katalogu Unity, którego agent może użyć do zamieszczenia wiadomości w usłudze Slack.

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

Zobacz CREATE FUNCTION (SQL i Python).

Przykładowe notatniki

Łączenie agenta z usługą Slack

Zobacz Łączenie agenta sztucznej inteligencji z usługą Slack.

Łączenie agenta z usługą Microsoft Teams

Zobacz Łączenie agenta sztucznej inteligencji z usługą Microsoft Teams.

Narzędzia połączeń zewnętrznych

W poniższych notesach przedstawiono tworzenie narzędzi agenta sztucznej inteligencji łączących się z usługami Slack, OpenAI i Azure AI search.

Narzędzie agenta obsługi komunikatów usługi Slack

Pobierz laptopa

Narzędzie agenta interfejsu API programu Microsoft Graph

Pobierz laptopa

Narzędzie agenta usługi Azure AI Search

Pobierz laptopa

Ograniczenia

• Prywatna łączność z zasobami w programie VPC przy użyciu usługi Private Link nie jest obsługiwana w przypadku połączeń zewnętrznych MCP. Jeśli agenci sztucznej inteligencji muszą łączyć się z zasobami w programie VPC, skontaktuj się z zespołem pomocy technicznej.