Een AI-agent verbinden met Slack

Meer informatie over het maken van een AI-agent die berichten naar Slack kan posten met behulp van HTTP Unity Catalog-verbindingen. Op deze pagina ziet u gebruikers-naar-machine-verificatie voor externe services, zodat uw agent kan communiceren met Slack.

Requirements

Controleer voordat u begint of u het volgende hebt:

• Beheerdersbevoegdheden voor werkruimten voor het maken van Unity Catalog-verbindingen.
• Toegang tot een Slack-werkruimte waar u apps kunt maken.
• De mogelijkheid om Unity Catalog-functies te maken in uw werkruimte.

Een Slack-app maken

Maak een Slack-app en configureer machtigingen, zodat uw agent de app kan gebruiken om namens u te posten.

1. Ga naar slack-API en klik op Nieuwe app>maken en geef een app-naam en een werkruimte op.
2. Kopieer op de pagina App-referenties de client-id en het clientgeheim.
3. Voeg in de sectie OAuth & Machtigingen het volgende toe:
   • Omleidings-URLhttps://<your_databricks_workspace_host_URL>.com/login/oauth/http.html.
   • Bot-tokenbereik, chat:write.
   • Beperk gebruik van API-tokens (optioneel), alleen allowlist Databricks Serverless-uitgaande IP-adressen. Zie ip-acceptatielijst.
4. Klik op Installeren in werkruimte en autoriseer de app.

De HTTP-verbinding voor de Unity-catalogus maken

Een Unity Catalog-verbinding biedt uw agent een veilige en herbruikbare manier om verbinding te maken met de Slack-app. Zie Verbinding maken met externe HTTP-services voor meer informatie over HTTP-verbindingen.

1. Klik in uw Azure Databricks-werkruimte op Catalogus.

2. Klik bovenaan het deelvenster Catalogus op het Toevoegen- of pluspictogram, Een verbinding maken.

3. Voer een gebruiksvriendelijke verbindingsnaam in.

4. Selecteer een verbindingstype van HTTP .

5. Selecteer OAuth-gebruiker naar machine per gebruiker.

6. Voer op de pagina Verificatie de volgende verbindingseigenschappen in voor de HTTP-verbinding:

   • Gastheer:https://slack.com
   • Haven:443
   • Geheim:<YOUR_CLIENT_SECRET>
   • Client-id:<YOUR_CLIENT_ID>
   • Autorisatie-eindpunt:https://slack.com/oauth/v2/authorize
   • OAuth-bereik:
   • Tokeneindpunt:https://slack.com/api/oauth.v2.access

7. Voer op de pagina Verbindingsgegevens het volgende in:

   • Tokeneindpunt:https://slack.com/api/oauth.v2.access
   • Basispad:/api
   • OAuth-methode voor het uitwisselen van credentials:Header and body

8. Nadat u de verbinding hebt gemaakt, klikt u op Aanmelden om de verbinding te verifiëren.

   

Voorbeeld van agentcode

Nadat u de Slack-app en de Unity Catalog-verbinding hebt gemaakt, gebruikt u de Slack SDK met het proxy-eindpunt voor Unity Catalog-verbindingen om Slack aan te roepen vanuit uw agent. Wijs de SDK's base_url naar de proxy en verifieer met uw Azure Databricks-token: Azure Databricks injecteert het Slack OAuth-token automatisch vanuit de verbinding:

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!")

Het volgende notebook heeft een volledig voorbeeld:

Slack Messaging Agent-hulpprogramma

Notebook krijgen

Volgende stappen

• Meer informatie over AI-agenthulpprogramma's
• Documentatie over Slack-API bekijken voor aanvullende mogelijkheden