🤖 Poe协议：AI对话的新纪元

在我们开始这场AI冒险之前，先让我们认识一下舞台上的主角们：

1. Poe服务器：想象它是一个超级智能的交通指挥中心，接收来自用户的请求，然后将这些请求巧妙地转化并发送给合适的bot服务器。
2. Bot服务器：这就像是无数个专业领域的AI专家，随时待命，准备回答用户的各种奇思妙想。

看，这就是Poe的核心舞台！用户提问，Poe服务器指挥，Bot服务器解答，一场完美的智能对话就此展开。

🎭 概念剖析：Poe的独门秘笈

身份识别：每个”演员”都有自己的独特标记

在Poe的世界里，每个角色都有自己的”身份证”，这就是所谓的标识符。它们看起来可能像这样：m-a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6。

这串看似随机的字符实际上暗藏玄机：

• 前面的字母（如m）告诉我们这是什么类型的对象
• 后面的32个字符则确保了它的唯一性

就像在一个大型音乐节上，每个表演者都有自己独特的编号，方便统筹安排。

安全保障：只有”VIP”才能进入后台

创建bot时，创作者会得到一个由32个字符组成的访问密钥。这就像是进入后台的VIP通行证，确保只有经过授权的请求才能被处理。

内容类型：纯文本还是华丽排版？

Poe支持两种主要的内容类型：

1. text/plain：就像一张白纸，朴实无华。
2. text/markdown：能够实现丰富的排版效果，就像给白纸加上了五彩缤纷的装饰。

版本控制：与时俱进的秘诀

Poe的版本号（如1.0）包含两个重要信息：

• 第一个数字代表请求版本，变化意味着可能需要重大调整。
• 第二个数字是响应版本，增加则意味着新功能的加入，但不会影响现有的bot。

这就像软件更新，有时候需要重新安装（大版本更新），有时候只是增加新功能（小版本更新）。

限制：保证演出质量的”剧场规则”

为了确保表演的流畅性，Poe设置了一些限制，比如：

• 初始响应必须在5秒内返回
• 总响应时间不超过600秒
• 单次响应不超过100,000字符
• 单次查询事件数不超过10,000个

这些规则就像是剧场的时间限制，确保每一场表演都精彩纷呈又不至于拖沓。

🎬 请求与响应：Poe的”对话艺术”

请求：观众的提问

Poe服务器向bot服务器发送的请求，就像观众向演员提问。这些请求主要有四种类型：

1. query：用户的提问
2. settings：询问bot的偏好设置
3. report_feedback：报告用户的反馈
4. report_error：报告错误情况

响应：演员的精彩表演

Bot服务器的响应就像演员的即兴表演，主要包括以下几种事件：

1. meta：设置舞台，告诉Poe如何处理接下来的响应
2. text：演员的台词，逐步呈现给观众
3. suggested_reply：为观众准备的互动环节
4. error：表演出现失误时的应对
5. done：谢幕，表演结束

🎨 设置的艺术：为每个Bot量身定制

通过settings请求，每个Bot都能设置自己的独特风格：

• 是否允许附件？
• 是否需要图像理解能力？
• 要不要一个酷炫的自我介绍？

这就像每个演员都有自己的化妆间，可以根据角色需求进行精心打扮。

🎭 实例演示：Poe的舞台魔法

想象一下，观众问道：”尼泊尔的首都是哪里？”

Poe服务器立即将这个问题转化为一个精心设计的JSON请求，发送给相应的Bot服务器。Bot服务器接收到请求后，开始了它的”表演”：

event: meta
data: {"content_type": "text/markdown", "linkify": true}

event: text
data: {"text": "尼泊尔的"}

event: text
data: {"text": "首都是"}

event: text
data: {"text": "加德满都。"}

event: done
data: {}

这种分段式的响应，就像魔术师慢慢揭开神秘的面纱，让观众充满期待，同时也确保了反应的即时性。

🚀 结语：AI交互的新篇章

Poe协议为AI与人类的对话开辟了一条崭新的道路。它不仅仅是一个技术规范，更是一个充满无限可能的创新平台。通过Poe，每个人都可以成为AI世界的导演，创造出独一无二的交互体验。

想象一下，在不久的将来，你可能会和一个由你自己设计的AI助手进行深入交流，讨论哲学、探讨科技、或者仅仅是闲聊生活。这就是Poe为我们描绘的未来图景。

让我们一起期待，在Poe的舞台上，会有更多精彩纷呈的AI表演！

📚 参考文献

1. Poe Protocol Specification. (2023). Retrieved from https://creator.poe.com/docs/poe-protocol-specification
2. GitHub Flavored Markdown Spec. (n.d.). Retrieved from https://github.github.com/gfm/
3. WhatWG Server-Sent Events Specification. (n.d.). Retrieved from https://html.spec.whatwg.org/multipage/server-sent-events.html
4. OpenAI Function Calling. (2023). OpenAI API Documentation.
5. FastAPI Documentation. (n.d.). Retrieved from https://fastapi.tiangolo.com/

---

Poe 服务器机器人快速入门指南 🚀

欢迎您来到 Poe 服务器机器人快速入门指南！如果您对如何创建自己的聊天机器人充满好奇，那么您来对地方了。本文将带您一探究竟，帮助您快速上手，构建属于自己的机器人。

🛠️ 启动代码的准备

本仓库旨在为我们的 教程 提供配套的启动代码，让您能够迅速启动一个机器人。请注意，启动代码假设您已经为部署设置了 Modal（关于这一点的详细说明，请参考上述教程）。

🤖 EchoBot：我们的第一个小伙伴

EchoBot 是您构建服务器机器人的理想起点。它有什么特点呢？

• 这个机器人简单地重复用户的查询，仿佛您在和一面镜子对话。
• 在您创建任何服务器机器人之前，首先重现这个机器人是至关重要的。
• 这将确保您拥有一个正常工作的 fastapi_poe 和 Modal 设置。
• 部署命令为 modal deploy echobot.py。

想看看它的正确实现吗？请访问 EchoBotDemo。

🌸 PromptBot：诗意的选择

PromptBot 是一个实现了提示机器人的服务器机器人。它有什么独特之处呢？

• 该机器人展示了如何利用 Poe 平台来覆盖您的聊天机器人的推理成本。
• 它使用 Claude-3-Haiku，并通过系统提示指示机器人创作俳句。
• 如果您打算调用 Poe 服务器以构建机器人的响应，确保先复现这个机器人。
• 部署命令为 modal deploy prompt_bot.py。

如果您想一睹 PromptBot 的风采，请查看 PromptBotDemo。

🛡️ WrapperBot：自定义的保护者

WrapperBot 允许您使用自己的模型提供者 API 密钥。它的特点包括：

• 该机器人展示了如何将 OpenAI API 包装。
• 您需要拥有 OpenAI API 密钥。
• 部署命令为 modal deploy wrapper_bot.py。

想要查看示例实现？访问 WrapperBotDemo。

🐱 CatBot：可爱的Markdown大师

CatBot 是一个演示 Poe API 的 Markdown 能力的示例机器人。它的魅力何在？

• 请查看 这里 的说明。
• 部署命令为 modal deploy catbot.py。

想看看 CatBot 的表现吗？点击 CatBotDemo。

🖼️ ImageResponseBot：图像的魔法

ImageResponseBot 展示了如何在响应中使用 Markdown 渲染图像。您可以简单地将图像渲染成文字的视觉盛宴。

• 部署命令为 modal deploy image_response_bot.py。

查看它的实现效果请访问 ImageResponseBotDemo。

🎥 VideoBot：动态的文件分享

VideoBot 是一个展示如何将文件附加到机器人的响应的机器人。虽然这个示例使用的是视频，但输出其他类型的文件也非常相似。

• 部署命令为 modal deploy video_bot.py。

想看看 VideoBot 的精彩表现？请访问 VideoBotDemo。

📄 PDFCounterBot：文件上传的助手

PDFCounterBot 让用户可以上传文件。它的使用场景非常广泛，绝对是个好帮手。

• 部署命令为 modal deploy pdf_counter_bot.py。

要查看它的实现，请访问 PDFCounterBotDemo。

📞 FunctionCallingBot：功能调用的先锋

FunctionCallingBot 演示了如何使用 Poe API 进行功能调用。想象一下，您可以通过这个机器人轻松访问各种功能。

• 部署命令为 modal deploy function_calling_bot.py。

想了解更多？请查看 FunctionCallingDemo。

📜 LogBot：日志记录的智慧

LogBot 旨在展示 QueryRequest 对象中的内容。它是记录并分析数据的绝佳助手。

• 部署命令为 modal deploy log_bot.py。

请访问 LogBotDemo 以了解更多。

🌐 HTTPRequestBot：网络请求的探索者

HTTPRequestBot 提供了如何在您的机器人中访问 HTTP 请求信息的示例。它就像一个网络侦探，帮助您获取所需的信息。

• 部署命令为 modal deploy http_request_bot.py。

查看它的实例请访问 HTTPRequestBotDemo。

💬 TurboAllCapsBot：字母的狂欢

TurboAllCapsBot 使用 GPT-3.5-Turbo 来回应用户的查询。这是一个展示 Poe 平台如何覆盖您的聊天机器人推理成本的绝佳示例。

• 部署命令为 modal deploy turbo_allcapsbot.py。

想要体验 TurboAllCapsBot 的魅力吗？请查看 AllCapsBotDemo。

⚖️ TurboVsClaudeBot：实时对比的较量

TurboVsClaudeBot 是一个更高级的示例，演示了如何实时渲染输出，比较两个不同的机器人。

• 部署命令为 modal deploy turbo_vs_claude.py。

想要看看这场精彩的对决吗？访问 TurboVsClaudeBotDemo。

---

通过以上示例，您应该对如何使用 Poe 平台构建自己的服务器机器人有了更深入的了解。无论您是想创建一个简单的 EchoBot，还是一个复杂的功能调用机器人，Poe 平台都能为您提供强大的支持。快去试试吧，开启您的机器人之旅！

---

🐱 Catbot：一只小猫模型的奇妙之旅

在这个科技飞速发展的时代，许多人都在寻求更智能的助手。大多数使用Poe协议的用户都希望借助大型语言模型（LLMs）来完成某些实用任务。然而，今天我们要给大家介绍的是一只“小猫模型”（Small Cat Model，SCM），它的目标并不是提供令人惊艳的用户体验，而是让大家领略Poe协议的各种功能。

🐾 小猫的基本特性

这只小猫模型可不是普通的猫咪，它有着几种特别的行为：

🥳 吃纸板的乐趣

小猫最喜欢的食物，居然是纸板！只要收到包含“cardboard”这个词的消息，它就会兴奋地回应：“crunch crunch”。想象一下，一只小猫啃着纸板的模样，真是让人忍俊不禁。

🍽️ 乞求食物的技巧

当小猫看到“kitchen”、“meal”或“food”这些关键词时，它会开始乞求：“meow meow”。更有意思的是，它还会建议你回复“Feed the cat”，仿佛在说：“快来喂我吧，我饿了！”

👀 见到陌生人就躲藏

小猫可不喜欢陌生人，如果它发现消息中有“stranger”，就会用“peek”这个词回应十次，每次之间隔一秒。我们可以想象一下，猫咪在偷偷观察陌生人的模样，既紧张又可爱。

⚠️ 对方块零食的拒绝

提到“square”时，小猫就会显得不知所措，回应一个错误信息；而如果是“cube”，它更是会发出一个不允许重试的错误信息。看来，这只小猫对食物的形状有着严格的审美标准！

📜 Markdown的高手

小猫在文本渲染技术方面可是个专家哦！默认情况下，它会使用Markdown格式回应，但如果收到“plain”的消息，它就会转为普通文本回应。如果看到“markdown”这个词，它更是兴奋得展示自己的Markdown知识，让人不得不感叹这只小猫的多才多艺。

🔢 数数的乐趣

当小猫看到“count”这个词时，它会从1数到10，每数一个都要等一秒钟。如果你加上“quickly”，它就会不再停顿，迅速完成数数任务。想象一下，小猫在数数时的样子，真是可爱极了！

💤 最后，还是要睡觉

如果没有任何刺激，小猫就会选择沉沉入睡，回应“zzz”。这也许是小猫的一种自我保护机制，因为在这个快节奏的世界中，休息总是必不可少的。

🎉 Catbot的应用示例

通过这个小猫模型的行为，我们不仅能够体验到Poe协议的丰富功能，还能够借此构建更有趣的聊天机器人。你可以在CatBotDemo上亲自体验这只小猫的魅力，或许会让你忍不住想对它说：“喵！”

🚀 结论

总之，这只小猫模型虽然简单，但却展示了Poe协议的多样性和灵活性。希望通过这个有趣的例子，能够激发大家的创意，构建出更实用、更有趣的聊天机器人。毕竟，技术和幽默感从来都是不可分割的，正如小猫与纸板的关系一样！

📝 参考文献

1. Poe协议官方文档
2. Markdown语法指南
3. 小猫行为研究
4. 计算机辅助学习与机器人设计
5. 人工智能与用户体验

希望大家在使用Poe协议时，能够像这只小猫一样，保持好奇心与探索精神！

---