在当今的数字时代,聊天机器人已经成为了与用户互动的关键工具。通过本文,我们将引导你一步步创建一个基于 Python 的机器人,并将其集成到 Poe 平台上。你将能够让任何 Poe 用户与之互动。准备好了吗?让我们开始吧!
📦 第一步:项目设置
首先,你需要确保你的计算机上安装了 Python。如果你还没有安装,请访问 Python 官网 进行下载。
接下来,在你的终端中运行以下命令来克隆示例项目:
git clone https://github.com/poe-platform/server-bot-quick-start
cd server-bot-quick-start
pip3 install -r requirements.txt
在 server-bot-quick-start
项目目录中,你会看到几个不同的示例服务器机器人。为了本指南的目的,我们将专注于 echobot.py
文件。打开该文件,接下来我们将进行机器人的部署。
🚀 第二步:部署你的机器人
使用 Modal
我们建议使用 Modal 来部署你的 echobot.py
,但如果你有其他的部署方式,也可以选择使用。若你已经将机器人部署到公共 URL,可以跳过此步骤,直接进行 Poe 的集成。
首先,安装 Modal 客户端。在终端中运行以下命令:
pip3 install modal-client
接下来,需要设置 Modal 的访问令牌。这一步只需要在你的计算机上进行一次。在终端中运行以下命令:
modal token new --source poe
如果运行后出现“命令未找到”的错误,请参考 此链接 解决。
如果命令成功运行,你将被引导到一个网页,在那里用你的 Github 账号登录 Modal。登录后,点击 “create token”,然后关闭浏览器窗口。
部署到 Modal
在终端中,从 server-bot-quick-start
目录运行以下命令:
modal serve echobot.py
modal serve
将部署你应用的临时版本,并在你对 echobot.py
进行任何代码更改时实时更新。这个选项主要用于开发目的,当该命令停止运行时,你的应用也会关闭。一旦你的应用准备好投入生产,可以使用 modal deploy
来持久化你的应用。
在终端输出中,你应该会看到你的应用部署的 URL。你将在下一步中需要这个 URL。
🔗 第三步:与 Poe 集成
接下来,导航到 Poe 的机器人创建页面,并选择“服务器机器人”作为机器人类型。这将带你到一个表单。
在表单中填写你的机器人详情,记下机器人的名称(可以在之后进行编辑)和生成的访问密钥。你将在下一步中需要这两个值。将之前步骤中的 URL 粘贴到“服务器 URL”中。点击“创建机器人”完成机器人创建。
⚠️ 警告:如果你的机器人托管的端点发生变化,别忘了更新服务器 URL!通常 Modal 会在每次部署时重用相同的 URL,但如果你在向机器人发送消息时遇到问题,请确认 URL 是否正确。
配置访问凭证
在 echobot.py
文件的底部,你应该看到以下代码行:
app = fp.make_app(bot, allow_without_key=True)
将这行代码更改为以下内容(将 <YOUR_ACCESS_KEY>
和 <YOUR_BOT_NAME>
替换为你在上一步中复制的值):
app = fp.make_app(bot, access_key=<YOUR_ACCESS_KEY>, bot_name=<YOUR_BOT_NAME>)
现在你的机器人已配置好正确的凭证!保存对 echobot.py
的更改,Modal 将会自动检测到并部署这些更改。就这样!你应该能够在 Poe 上与自己的机器人对话了。
🌟 接下来该做什么?
在 Poe 上构建机器人的一个优势是能够调用其他 Poe 机器人。想要了解如何做到这一点,可以查看 访问其他 Poe 机器人 的指南。
此外,还可以查看其他详细指南,了解如何启用特定功能,例如 在响应中渲染图像,为你的机器人启用文件上传,以及 设置介绍消息。
最后,查看 Poe 协议规范 以了解 Poe 服务器机器人提供的全部功能。
📚 参考文献
- Poe Creator Guide. (n.d.). Retrieved from Poe
- Modal Documentation. (n.d.). Retrieved from Modal
- Python Official Documentation. (n.d.). Retrieved from Python
- GitHub Repository for Poe Server Bot Example. (n.d.). Retrieved from GitHub
- Poe Protocol Specification. (n.d.). Retrieved from Poe
通过以上步骤,你已经成功创建并部署了一个基于 Poe 平台的聊天机器人。希望这篇指南能帮助你在机器人的世界中更进一步,期待你的机器人能够带来更多有趣的互动!