Compartir vía

Conexión de un agente de IA a Slack

Important

Esta característica está en versión preliminar pública.

Obtenga información sobre cómo crear un agente de IA que pueda publicar mensajes en Slack mediante conexiones del catálogo http de Unity. En esta página se muestra la autenticación de usuario a máquina para servicios externos, lo que permite al agente interactuar con Slack.

Requirements

Antes de comenzar, compruebe que tiene:

  • Privilegios de administrador del área de trabajo para crear conexiones del Catálogo de Unity.
  • Acceso a un área de trabajo de Slack donde puede crear aplicaciones.
  • La capacidad de crear funciones de Catálogo de Unity en tu espacio de trabajo.

Crear una aplicación de Slack

Cree una aplicación de Slack y configure permisos para que el agente pueda usar la aplicación para publicarla en su nombre.

  1. Vaya a La API de Slack y haga clic en Crear nueva aplicación>desde cero y proporcione un nombre de aplicación y un área de trabajo.
  2. En la página Credenciales de la aplicación, copie el identificador de cliente y el secreto de cliente.
  3. En la sección OAuth & Permissions , agregue lo siguiente:
    • URL de redireccionamientohttps://<your_databricks_workspace_host_URL>.com/login/oauth/http.html.
    • Ámbito del token de bot, chat:write.
    • Restrinja el uso de tokens de API (opcional), solo permita las IP salientes de Databricks Serverless en la lista blanca. Consulte Lista de permitidos de IP.
  4. Haga clic en Instalar en el área de trabajo y autorice la aplicación.

Creación de la conexión HTTP del catálogo de Unity

Una conexión de Catálogo de Unity proporciona al agente una manera segura y reutilizable de conectarse a la aplicación slack. Para más información sobre las conexiones HTTP, consulte Conexión a servicios HTTP externos.

  1. En el área de trabajo de Azure Databricks, haga clic en el icono Datos.Catálogo.

  2. En la parte superior del panel Catálogo, haga clic en el icono Agregar o másAgregar>Crear una conexión.

  3. Escriba un nombre de conexión fácil de usar .

  4. Seleccione un Tipo de conexión de HTTP.

  5. Seleccione OAuth de usuario a máquina por usuario.

  6. En la página Autenticación , escriba las siguientes propiedades de conexión para la conexión HTTP:

    • Anfitrión:https://slack.com
    • Puerto:443
    • Secreto:<YOUR_CLIENT_SECRET>
    • Id. de cliente:<YOUR_CLIENT_ID>
    • Punto de conexión de autorización:https://slack.com/oauth/v2/authorize
    • Ámbito de OAuth:chat:write
    • Punto de conexión del token:https://slack.com/api/oauth.v2.access

  7. En la página Detalles de conexión, escriba lo siguiente:

    • Punto de conexión del token:https://slack.com/api/oauth.v2.access
    • Ruta de acceso base:/api
    • Método de intercambio de credenciales de OAuth:Header and body

  8. Después de crear la conexión, haga clic en Iniciar sesión para autenticar la conexión.

    Inicio de sesión en la conexión de Slack

Ejemplo de código de agente

Después de crear la aplicación de Slack y la conexión al Catálogo de Unity, use el SDK de Slack con el punto de conexión proxy de las conexiones del Catálogo de Unity para llamar a Slack desde su agente. Apunte el SDK base_url al proxy y autentíquese con el token de Azure Databricks: Azure Databricks inserta automáticamente el token de OAuth de Slack desde la conexión:

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

El cuaderno siguiente tiene un ejemplo completo:

Herramienta de agente de mensajería de Slack

Obtener el cuaderno

Pasos siguientes

  • Last updated on