Slack 工具包

这将帮助您开始使用 Slack 工具包。有关所有 SlackToolkit 功能和配置的详细文档，请参阅API 参考。

设置

要使用此工具包，您需要获取一个令牌，如 Slack API 文档中所述。收到 SLACK_USER_TOKEN 后，您可以将其作为环境变量输入到下方。

import getpass
import os

if not os.getenv("SLACK_USER_TOKEN"):
    os.environ["SLACK_USER_TOKEN"] = getpass.getpass("Enter your Slack user token: ")

为了启用单个工具的自动追踪，请设置您的 LangSmith API 密钥

# os.environ["LANGSMITH_API_KEY"] = getpass.getpass("Enter your LangSmith API key: ")
# os.environ["LANGSMITH_TRACING"] = "true"

安装

此工具包位于 langchain-community 包中。我们还需要 Slack SDK。

%pip install -qU langchain-community slack_sdk

另外，我们可以选择安装 beautifulsoup4 来协助解析 HTML 消息。

%pip install -qU beautifulsoup4 # This is optional but is useful for parsing HTML messages

实例化

现在我们可以实例化我们的工具包

from langchain_community.agent_toolkits import SlackToolkit

toolkit = SlackToolkit()

API 参考：SlackToolkit

工具

查看可用工具

tools = toolkit.get_tools()

tools

[SlackGetChannel(client=<slack_sdk.web.client.WebClient object at 0x113caa8c0>),
 SlackGetMessage(client=<slack_sdk.web.client.WebClient object at 0x113caa4d0>),
 SlackScheduleMessage(client=<slack_sdk.web.client.WebClient object at 0x113caa440>),
 SlackSendMessage(client=<slack_sdk.web.client.WebClient object at 0x113caa410>)]

此工具包加载

• SlackGetChannel
• SlackGetMessage
• SlackScheduleMessage
• SlackSendMessage

在代理中使用

让我们为代理装备 Slack 工具包并查询频道信息。

from langchain_openai import ChatOpenAI
from langgraph.prebuilt import create_react_agent

llm = ChatOpenAI(model="gpt-4o-mini")

agent_executor = create_react_agent(llm, tools)

API 参考：ChatOpenAI | create_react_agent

example_query = "When was the #general channel created?"

events = agent_executor.stream(
    {"messages": [("user", example_query)]},
    stream_mode="values",
)
for event in events:
    message = event["messages"][-1]
    if message.type != "tool":  # mask sensitive information
        event["messages"][-1].pretty_print()

================================ Human Message =================================

When was the #general channel created?
================================== Ai Message ==================================
Tool Calls:
  get_channelid_name_dict (call_NXDkALjoOx97uF1v0CoZTqtJ)
 Call ID: call_NXDkALjoOx97uF1v0CoZTqtJ
  Args:
================================== Ai Message ==================================

The #general channel was created on timestamp 1671043305.

example_query = "Send a friendly greeting to channel C072Q1LP4QM."

events = agent_executor.stream(
    {"messages": [("user", example_query)]},
    stream_mode="values",
)
for event in events:
    message = event["messages"][-1]
    if message.type != "tool":  # mask sensitive information
        event["messages"][-1].pretty_print()

================================ Human Message =================================

Send a friendly greeting to channel C072Q1LP4QM.
================================== Ai Message ==================================
Tool Calls:
  send_message (call_xQxpv4wFeAZNZgSBJRIuaizi)
 Call ID: call_xQxpv4wFeAZNZgSBJRIuaizi
  Args:
    message: Hello! Have a great day!
    channel: C072Q1LP4QM
================================== Ai Message ==================================

I have sent a friendly greeting to the channel C072Q1LP4QM.

API 参考

有关所有 SlackToolkit 功能和配置的详细文档，请参阅 API 参考。

相关

• 工具概念指南
• 工具操作指南