🚀 从 Gradio 应用创建 Slack 机器人 🚀

你可以将 Gradio 应用作为一个 Slack 机器人，让你的 Slack 工作区用户直接与它互动。

它是如何工作的？

Slack 机器人将监听频道中提及它的消息。当它收到一条消息（可以包含文本和文件）时，它将通过 Gradio 的内置 API 将其发送到你的 Gradio 应用。你的机器人将回复从 API 接收到的响应。

由于 Gradio 的 API 非常灵活，你可以非常轻松地创建支持文本、图像、音频、流媒体、聊天历史记录以及各种其他功能的 Slack 机器人。

前提条件

安装最新版本的 gradio 和 slack-bolt 库

pip install --upgrade gradio slack-bolt~=1.0

拥有一个正在运行的 Gradio 应用。这个应用可以在本地运行，也可以在 Hugging Face Spaces 上运行。在这个例子中，我们将使用 Gradio Playground Space，它接收图像和/或文本并生成相应的 Gradio 应用代码。

现在，我们准备开始！

1. 创建一个 Slack 应用

前往 api.slack.com/apps 并点击“Create New App”（创建新应用）。
选择“From scratch”（从头开始）并为你的应用命名。
选择你想要开发应用的 Workspace（工作区）。
在“OAuth & Permissions”（OAuth 和权限）下，滚动到“Scopes”（范围）并添加以下机器人令牌范围：
- app_mentions:read
- chat:write
- files:read
- files:write
在同一个“OAuth & Permissions”（OAuth 和权限）页面，向上滚动并点击按钮将应用安装到你的工作区。
记下出现的“Bot User OAuth Token”（机器人用户 OAuth 令牌，以 xoxb- 开头），我们稍后会用到它。
在菜单栏中点击“Socket Mode”（套接字模式）。页面加载后，点击切换按钮“Enable Socket Mode”（启用套接字模式）。
给你的令牌命名，例如 socket-token，并复制生成的令牌（以 xapp- 开头），我们稍后会用到它。
最后，转到菜单栏中的“Event Subscription”（事件订阅）选项。点击切换按钮“Enable Events”（启用事件）并订阅 app_mention 机器人事件。

2. 编写一个 Slack 机器人

让我们从编写一个非常简单的 Slack 机器人开始，以确保一切正常。将以下 Python 代码写入名为 bot.py 的文件中，并粘贴上一节中第 6 步和第 8 步的两个令牌。

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler

SLACK_BOT_TOKEN = # PASTE YOUR SLACK BOT TOKEN HERE
SLACK_APP_TOKEN = # PASTE YOUR SLACK APP TOKEN HERE

app = App(token=SLACK_BOT_TOKEN)

@app.event("app_mention")
def handle_app_mention_events(body, say):
    user_id = body["event"]["user"]
    say(f"Hi <@{user_id}>! You mentioned me and said: {body['event']['text']}")

if __name__ == "__main__":
    handler = SocketModeHandler(app, SLACK_APP_TOKEN)
    handler.start()

如果这部分工作正常，我们就可以添加 Gradio 特定的代码了。我们将使用 Gradio Python 客户端来查询上面提到的 Gradio Playground Space。这是更新后的 bot.py 文件：

from slack_bolt import App
from slack_bolt.adapter.socket_mode import SocketModeHandler

SLACK_BOT_TOKEN = # PASTE YOUR SLACK BOT TOKEN HERE
SLACK_APP_TOKEN = # PASTE YOUR SLACK APP TOKEN HERE

app = App(token=SLACK_BOT_TOKEN)
gradio_client = Client("abidlabs/gradio-playground-bot")

def download_image(url, filename):
    headers = {"Authorization": f"Bearer {SLACK_BOT_TOKEN}"}
    response = httpx.get(url, headers=headers)
    image_path = f"./images/{filename}"
    os.makedirs("./images", exist_ok=True)
    with open(image_path, "wb") as f:
        f.write(response.content)
    return image_path

def slackify_message(message):   
    # Replace markdown links with slack format and remove code language specifier after triple backticks
    pattern = r'\[(.*?)\]\((.*?)\)'
    cleaned = re.sub(pattern, r'<\2|\1>', message)
    cleaned = re.sub(r'```\w+\n', '```', cleaned)
    return cleaned.strip()

@app.event("app_mention")
def handle_app_mention_events(body, say):
    # Extract the message content without the bot mention
    text = body["event"]["text"]
    bot_user_id = body["authorizations"][0]["user_id"]
    clean_message = text.replace(f"<@{bot_user_id}>", "").strip()
    
    # Handle images if present
    files = []
    if "files" in body["event"]:
        for file in body["event"]["files"]:
            if file["filetype"] in ["png", "jpg", "jpeg", "gif", "webp"]:
                image_path = download_image(file["url_private_download"], file["name"])
                files.append(handle_file(image_path))
                break
    
    # Submit to Gradio and send responses back to Slack
    for response in gradio_client.submit(
        message={"text": clean_message, "files": files},
    ):
        cleaned_response = slackify_message(response[-1])
        say(cleaned_response)

if __name__ == "__main__":
    handler = SocketModeHandler(app, SLACK_APP_TOKEN)
    handler.start()

3. 将机器人添加到你的 Slack 工作区

现在，在你的 Slack 工作区中创建一个新频道或导航到现有频道，你希望在那里使用机器人。点击 Slack 侧边栏中“Channels”（频道）旁边的“+”按钮，然后按照提示创建一个新频道。

最后，邀请你的机器人加入频道

在你的新频道中，输入 /invite @YourBotName
从下拉菜单中选择你的机器人
点击“Invite to Channel”（邀请加入频道）

4. 完成！

现在你可以在机器人所在的任何频道中提及它，选择性地附加一张图片，它将用生成的 Gradio 应用代码进行响应！

机器人将：

监听提及
处理任何附加的图像
将文本和图像发送到你的 Gradio 应用
将响应流式传输回 Slack 频道

这只是一个基本示例——你可以扩展它来处理更多类型的文件、添加错误处理，或与不同的 Gradio 应用集成！

如果你从 Gradio 应用构建了 Slack 机器人，请随时在 X 上分享并@ Gradio 账号，我们很乐意帮助你进行推广！