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

Ważny

Ta funkcja jest dostępna w publicznej wersji zapoznawczej.

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.

Wymagania

• Utwórz połączenie HTTP wykazu aparatu Unity. Zobacz Łączenie z zewnętrznymi usługami HTTP.

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).

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 biblioteki databricks-sdk. Ta funkcja wysyła żądanie HTTP do usługi zewnętrznej przy użyciu połączenia Unity Catalog do uwierzytelnienia.

Wymagane uprawnienia:USE CONNECTION na 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ń.

Przykładowe zeszyty

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

Weź notatnik

Narzędzie agenta interfejsu API programu Microsoft Graph

Weź notatnik

Narzędzie agenta usługi Azure AI Search

Weź notatnik