Ansluta en AI-agent till Slack

Important

Den här funktionen finns som allmänt tillgänglig förhandsversion.

Lär dig hur du skapar en AI-agent som kan skicka meddelanden till Slack med hjälp av HTTP Unity Catalog-anslutningar. Den här sidan visar autentisering från användare till dator för externa tjänster, så att din agent kan interagera med Slack.

Requirements

Innan du börjar kontrollerar du att du har:

  • Administratörsbehörigheter för arbetsytan för att skapa Unity Catalog-anslutningar.
  • Åtkomst till en Slack-arbetsyta där du kan skapa appar.
  • Möjligheten att skapa Unity Catalog-funktioner på din arbetsyta.

Skapa en Slack-app

Skapa en Slack-app och konfigurera behörigheter så att din agent kan använda appen för att publicera åt dig.

  1. Gå till Slack API och klicka på Skapa ny app>från grunden och ange ett appnamn och en arbetsyta.
  2. På sidan Appautentiseringsuppgifter kopierar du klient-ID och klienthemlighet.
  3. I avsnittet OAuth & Permissions (OAuth - behörigheter ) lägger du till följande:
    • Omdirigerings-URLhttps://<your_databricks_workspace_host_URL>.com/login/oauth/http.html.
    • Omfång för bottoken, chat:write.
    • Begränsa API-tokenanvändning (valfritt) och tillåt endast databricks serverlösa utgående IP-adresser. Se IP-tillåtna listor.
  4. Klicka på Installera på arbetsyta och auktorisera appen.

Skapa HTTP-anslutningen för Unity-katalogen

En Anslutning till Unity Catalog ger din agent ett säkert och återanvändbart sätt att ansluta till Slack-appen. Mer information om HTTP-anslutningar finns i Ansluta till externa HTTP-tjänster.

  1. På din Azure Databricks-arbetsyta klickar du på dataikonen.Katalog.

  2. Längst upp i fönstret Katalog klickar du på ikonen Lägg till eller plusLägg till ikonen >Skapa en anslutning.

  3. Ange ett användarvänligt anslutningsnamn.

  4. Välj en anslutningstyp för HTTP.

  5. Välj OAuth-användare till maskin per användare.

  6. På sidan Autentisering anger du följande anslutningsegenskaper för HTTP-anslutningen:

    • Värd:https://slack.com
    • Hamn:443
    • Hemlig:<YOUR_CLIENT_SECRET>
    • Klient-ID:<YOUR_CLIENT_ID>
    • Auktoriseringsslutpunkt:https://slack.com/oauth/v2/authorize
    • OAuth-omfång:chat:write
    • Tokenslutpunkt:https://slack.com/api/oauth.v2.access
  7. På sidan Anslutningsinformation anger du följande:

    • Tokenslutpunkt:https://slack.com/api/oauth.v2.access
    • Bassökväg:/api
    • Utbytesmetod för OAuth-autentiseringsuppgifter:Header and body
  8. När du har skapat anslutningen klickar du på Logga in för att autentisera anslutningen.

    Logga in på Slack-anslutning

Exempel på agentkod

När du har skapat Slack-appen och Unity Catalog-anslutningen använder du Slack SDK med proxyslutpunkten för Unity Catalog-anslutningar för att anropa Slack från din agent. Peka SDK:n base_url mot proxyn och autentisera med din Azure Databricks-token — Azure Databricks matar automatiskt in Slack OAuth-tokenen från anslutningen.

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/<connection-name>/proxy/",
)

result = client.chat_postMessage(channel="<channel-id>", text="Hello from your agent!")

Följande notebook-fil har ett fullständigt exempel:

Verktyg för Slack-meddelandeagent

Hämta anteckningsbok

Nästa steg