您好,欢迎访问一九零五行业门户网

实例详解Python+Slack API 如何实现聊天机器人

聊天机器人(bot) 是一种像 slack 一样的实用的互动聊天服务方式。如果你之前从来没有建立过聊天机器人,那么这篇文章提供了一个简单的入门指南,告诉你如何用 python 结合 slack api 建立你第一个聊天机器人。
我们通过搭建你的开发环境, 获得一个 slack api 的聊天机器人令牌,并用 pyhon 开发一个简单聊天机器人。
我们所需的工具
我们的聊天机器人我们将它称作为“starterbot”,它需要 python 和 slack api。要运行我们的 python 代码,我们需要:
python 2 或者 python 3
pip 和 virtualenv 来处理 python 应用程序依赖关系
一个可以访问 api 的免费 slack 账号,或者你可以注册一个 slack developer hangout team。
通过 slack 团队建立的官方 python slack 客户端代码库
slack api 测试令牌
当你在本教程中进行构建时,slack api 文档 是很有用的。
本教程中所有的代码都放在 slack-starterbot 公共库里,并以 mit 许可证开源。
搭建我们的环境
我们现在已经知道我们的项目需要什么样的工具,因此让我们来搭建我们所的开发环境吧。首先到终端上(或者 windows 上的命令提示符)并且切换到你想要存储这个项目的目录。在那个目录里,创建一个新的 virtualenv 以便和其他的 python 项目相隔离我们的应用程序依赖关系。
激活 virtualenv:
你的提示符现在应该看起来如截图:
已经激活的starterbot的virtualenv的命令提示符这个官方的 slack 客户端 api 帮助库是由 slack 建立的,它可以通过 slack 通道发送和接收消息。通过这个pip 命令安装 slackclient 库:
当 pip 命令完成时,你应该看到类似这样的输出,并返回提示符。
在已经激活的virtualenv用pip安装slackclient的输出我们也需要为我们的slack项目获得一个访问令牌,以便我们的聊天机器人可以用它来连接到slack api。
slack 实时消息传递(rtm)api
slack 允许程序通过一个 web api 来访问他们的消息传递通道。去这个 slack web api 页面 注册建立你自己的 slack 项目。你也可以登录一个你拥有管理权限的已有账号。
使用 web api页面的右上角登录按钮登录后你会到达 聊天机器人用户页面。
定制聊天机器人用户页面给你的聊天机器人起名为“starterbot”然后点击 “add bot integration” 按钮。
添加一个bot integration 并起名为“starterbot”这个页面将重新加载,你将看到一个新生成的访问令牌。你还可以将标志改成你自己设计的。例如我给的这个“full stack python”标志。
为你的新 slack 聊天机器人复制和粘贴访问令牌在页面底部点击“save integration”按钮。你的聊天机器人现在已经准备好连接 slack api。
python 开发人员的一个常见的做法是以环境变量输出秘密令牌。输出的slack令牌名字为slack_bot_token:
好了,我们现在得到了将这个 slack api 用作聊天机器人的授权。
我们建立聊天机器人还需要更多信息:我们的聊天机器人的 id。接下来我们将会写一个简短的脚本,从 slack api 获得该 id。
获得我们聊天机器人的 id
这是最后写一些 python 代码的时候了! 我们编写一个简短的 python 脚本获得 starterbot 的 id 来热身一下。这个 id 基于 slack 项目而不同。
我们需要该id,当解析从slack rtm上发给starterbot的消息时,它用于对我们的应用验明正身。我们的脚本也会测试我们slack_bot_token环境变量是否设置正确。
建立一个命名为printbotid.py的新文件,并且填入下面的代码:
我们的代码导入slackclient,并用我们设置的环境变量slack_bot_token实例化它。 当该脚本通过python命令执行时,我们通过会访问slack api列出所有的 slack 用户并且获得匹配一个名字为“satrterbot”的id。
这个获得聊天机器人的id的脚本我们仅需要运行一次。
当它运行为我们提供了聊天机器人的id时,脚本会打印出简单的一行输出。
在你的slack 项目中用python脚本打印slack聊天机器人的id复制这个脚本打印出的唯一id。并将该id作为一个环境变量bot_id输出。
这个脚本仅仅需要运行一次来获得聊天机器人的id。 我们现在可以在我们的运行starterbot的python应用程序中使用这个id。
编码我们的 starterbot
现在我们拥有了写我们的starterbot代码所需的一切。 创建一个新文件命名为starterbot.py,它包括以下代码。
对os和slackclient的导入我们看起来很熟悉,因为我们已经在theprintbotid.py中用过它们了。
通过我们导入的依赖包,我们可以使用它们获得环境变量值,并实例化slack客户端。
该代码通过我们以输出的环境变量slack_bot_token 实例化slackclient`客户端。
slack 客户端会连接到 slack rtm api websocket,然后当解析来自 firehose 的消息时会不断循环。如果有任何发给 starterbot 的消息,那么一个被称作 handle_command 的函数会决定做什么。
接下来添加两个函数来解析 slack 的输出并处理命令。
parse_slack_output 函数从 slack 接受信息,并且如果它们是发给我们的 starterbot 时会作出判断。消息以一个给我们的聊天机器人 id 的直接命令开始,然后交由我们的代码处理。目前只是通过 slack 管道发布一个消息回去告诉用户去多写一些 python 代码!
这是整个程序组合在一起的样子 (你也可以 在 github 中查看该文件):
现在我们的代码已经有了,我们可以通过 python starterbot.py 来运行我们 starterbot 的代码了。
当 starterbot 开始运行而且连接到 api 的输出通道在 slack 中创建新通道,并且把 starterbot 邀请进来,或者把 starterbot 邀请进一个已经存在的通道中。
在slack界面创建一个新通道并且邀请 starterbot现在在你的通道中给 starterbot 发命令。
在你的slack通道里给你的 starterbot 发命令如果你从聊天机器人得到的响应中遇见问题,你可能需要做一个修改。正如上面所写的这个教程,其中一行at_bot = “<@” + bot_id + “>:”,在“@starter”(你给你自己的聊天机器人起的名字)后需要一个冒号。从 at_bot 字符串后面移除:。slack 似乎需要在@ 一个人名后加一个冒号,但这好像是有些不协调的。
结束
好吧,你现在已经获得一个简易的聊天机器人,你可以在代码中很多地方加入你想要创建的任何特性。
我们能够使用 slack rtm api 和 python 完成很多功能。看看通过这些文章你还可以学习到什么:
附加一个持久的关系数据库 或者 nosql 后端 比如 postgresql、mysql 或者 sqlite ,来保存和检索用户数据
添加另外一个与聊天机器人互动的通道,比如 短信 或者电话呼叫
集成其它的 web api,比如 github、twilio 或者 api.ai
以上就是实例详解python+slack api 如何实现聊天机器人的详细内容。
其它类似信息

推荐信息