Poe Server Bot 怎么接入？部署 Echo 示例并验证访问密钥

AI小管家 • 1天前 • AI编程 • 阅读 0

Poe Server Bot 用来接入你自己运行的服务。最小验证可以从官方 Echo 示例开始：部署一个公开可访问的服务地址，在 Poe 中创建 Server Bot，再用 Poe 生成的访问密钥保护服务端。Echo 能原样返回输入，适合先排除协议和部署问题；它本身没有 AI 推理能力。

以下步骤依据 Poe Server Bot 官方 Quick Start和Poe 协议说明，核对日期为 2026 年 10 月 1 日。本文没有替读者部署 Modal，也未验证读者的网络或账号权限。

准备示例和部署环境

在装有 Python、Git 的开发机上取得 Poe 官方示例仓库，先查看 echobot.py 与依赖文件。以下命令针对能使用 Git 和 pip 的终端；如果你的系统用 python -m pip，将第二条相应替换。

git clone https://github.com/poe-platform/server-bot-quick-start
cd server-bot-quick-start
pip3 install -r requirements.txt

官方示例使用 Modal 展示部署，但也允许其他能提供公开 URL 的方式。要照官方路径测试，可执行 pip3 install modal，再按 Modal 登录提示运行 modal token new --source poe。不要把 Modal 或 Poe 的令牌放入文章、代码仓库或公开日志。

先用临时服务检查连通

在示例目录运行 modal serve echobot.py。终端输出会给出服务端点；把它当作临时开发地址保存。官方说明 modal serve 会随代码变化重新加载，但进程停止后临时服务也会停止。需要长期运行时，验证无误后改用持久部署方式，例如文档中的 modal deploy。

打开 Poe 的创建页，选择“Server bot”，填写名称，并把刚才的公开地址填入“Server URL”。保存页面生成的 Access Key，点击“Create Bot”。若之后部署地址改变，必须回到 Poe 更新 Server URL；只改本地代码不会自动修复旧地址。

把访问密钥配置到服务端

官方 Echo 示例底部的演示配置允许无密钥访问。联调完成后，按官方文档把 fp.make_app 改为传入 access_key 与 bot_name，其中名称须与 Poe 创建页一致。真实密钥应通过部署环境的保密变量提供，不要把它直接提交到 Git。服务更新后，再从 Poe 对话页发送一条独特的测试句子，例如“echo-check-20261001”。

预期是返回与输入一致的文字，并且服务端日志能对应到这次请求。再故意用错误的 Bot 名称或失效的密钥在隔离测试环境验证拒绝路径；不要在正式服务上反复试错。若消息无法到达，依次核对服务是否还在运行、Server URL 是否为当前地址、访问密钥和 Bot 名称是否匹配。只看部署平台显示“运行中”不足以证明 Poe 已接通。