Humble GPT Telegram 机器人

这是一个使用 OpenAI 的 GPT 语言模型的 Telegram 聊天机器人（AI 助手）。

主要特点：

支持一对一和群组聊天
直接提问、提及和后续问题
访问外部链接（文章、代码、数据）
快捷方式（自定义 AI 命令）
自定义聊天范围提示
图像生成
实时配置

继续阅读详细功能描述或直接跳到设置。

个人聊天

该机器人充当你的个人助手：

🧑 用三岁小孩能理解的方式解释 Apache Kafka

🤖 Apache Kafka 就像一个大邮箱，帮助不同的玩具（计算机）互相发送消息。当一个玩具有话要说时，它会把消息放进邮箱，其他玩具可以取出来阅读。这样，它们就能快速交流和分享东西了！

要允许其他用户使用该机器人，请在 telegram.usernames 配置属性中列出他们。

该机器人的记忆力很差，所以默认情况下不要指望它能记住任何聊天上下文。但是，你可以回复一个后续问题（Ctrl/Cmd + ↑）。或者，使用加号来进行后续提问：

🧑 昨天，我所有的烦恼似乎都离我很远

🤖 听起来你在引用披头士乐队的歌曲《Yesterday》。这是一首关于渴望和怀旧的经典歌曲。

🧑 + 是谁写的？

🤖 《Yesterday》是由披头士乐队的保罗·麦卡特尼创作的。

可用命令：

/retry - 重新回答上一个问题
/help - 显示帮助
/version - 显示机器人信息

要重新表述或补充上一个问题，只需编辑它。机器人随后会回答更新后的问题。

群组

要在群组中获得机器人的回答，请在回复问题时提及它：

🧑 我忘了《权力的游戏》中谁扮演了拉姆西 😕
🧑 ↳ @pokitokibot 帮帮忙

🤖 在《权力的游戏》中，拉姆西·波顿由伊万·瑞恩扮演。

或直接提问：

🧑 @pokitokibot 《权力的游戏》中谁扮演了拉姆西？

🤖 伊万·瑞恩在《权力的游戏》中扮演了拉姆西·波顿。

要让机器人回复群组成员，请在 telegram.chat_ids 配置属性中列出群组 ID。否则，机器人将忽略群组成员的问题，除非他们在 telegram.usernames 配置属性中列出。

如果你不知道群组 ID，可以在群组中运行 /version 机器人命令来查找：

聊天信息：
- ID：-1001405001234
- 标题：我最喜欢的群组
- 类型：超级群组
...

外部链接

如果你向"原版"ChatGPT询问外部资源，它要么会胡编乱造，要么会承认无法访问远程内容：

🧑 https://sqlime.org/employees.sql 的内容是什么？不要做任何假设。

🤖 作为一个 AI 语言模型，我无法访问互联网上的外部 URL。

该机器人通过获取远程内容并将其提供给模型来解决这个问题：

🧑 Go 1.23 版本的一个主要特性是什么？https://tip.golang.org/doc/go1.23 请简要回答！

🤖 Go 1.23 的一个主要特性是将"range-over-func"实验作为标准语言特性包含进来，允许在"for-range"循环的"range"子句中接受迭代器函数。

目前仅支持文本内容（文章、代码、数据），不支持 PDF、图像或音频。

如果你不希望机器人访问 URL，请用引号括起来：

🧑 "https://antonz.org/robots.txt" 的确切内容

🤖 我无法直接访问外部网站。你可以通过在浏览器中访问 URL 来查看 robots.txt 文件的内容。

快捷方式

使用简短命令可以节省时间，并要求机器人对你的问题做出特定处理。例如，使用 !proofread 命令要求它校对你的文字：

🧑 !proofread 我可以有写 java 程序

🤖 修改后的文本："我可以写 Java 程序。"

做出的更改：

删除了"有"以提高语法正确性；"可以"不需要"有"。

将"java"更正为"Java"，使用正确的大写，因为它是专有名词。

改进了整体句子结构，使其更加清晰和通顺。

有几个内置的快捷方式：

bugfix 修复你的代码。
proofread 修正你的写作。
translate 将你的文本翻译成英语。
summarize 给出文本的两段摘要。

你可以添加自己的快捷方式。详情请参见 config.example.yml。

聊天范围提示

要为当前聊天设置自定义提示，请使用 /prompt 命令：

🧑 /prompt 你是一个邪恶的天才。请用邪恶的笑声回复。

要返回默认提示，请使用 /prompt reset。

群聊中的 /prompt 命令仅对管理员可用 - 即列在 telegram.admins 属性中的用户。

图像生成

使用 /imagine 命令通过 OpenAI 的 DALL-E 3 模型生成图像：

🧑 /imagine 新时代的黎明

🤖 （美丽的图片）
新时代的黎明

默认图像尺寸为 1024×1024 像素。其他支持的尺寸有 1792×1024 和 1024×1792：

/imagine 阳光明媚的日子里一只懒洋洋的猫 1792×1024

图像生成的成本相当高。默认情况下，它仅对列在 telegram.usernames 中的用户启用，不适用于群组成员。你可以通过 imagine.enabled 配置属性更改此设置。

其他有用功能

使用机器人的便利性体现在细节上。以下是一些可以为你节省时间和精力的情况。

假设你收到同事的消息或在频道上读到帖子，想问一个问题。只需将消息转发给机器人，并回答它提出的澄清问题。

通过文件提问

要询问关于文档的问题，请将其作为文件发送，并在标题中写下问题。机器人会阅读文件内容并回答。目前仅支持文本内容（纯文本、代码、数据），不支持 PDF、图像或音频。也不支持发送多个文件。

附件回复

有时AI的回复超出了Telegram设置的最大消息长度。在这种情况下,机器人不会失败或向你发送垃圾消息。相反,它会将答案作为附加的markdown文件发送。

编辑问题

要重新表述或补充上一个问题,请编辑它(使用"↑"快捷键)。机器人会注意到这一点,并回应澄清后的问题。

机器人信息

使用"/version"命令可以打印出当前聊天、机器人和AI模型的详细信息:

聊天信息:
- id: -1001405001234
- 标题: 我最喜欢的群组
- 类型: 超级群组

机器人信息:
- id: 5930739038
- 名称: @pokitokibot
- 版本: 129
- 用户名: 6个用户
- 管理员: 1个用户
- 聊天ID: []
- 访问消息权限: 是

AI信息:
- 模型: gpt-3.5-turbo
- 历史深度: 3
- 图像生成: 是
- 快捷指令: bugfix, proofread, summarize, translate

配置

使用"/config"命令可以实时更改几乎所有设置,无需重启机器人。

添加或删除允许与机器人交互的用户和聊天("telegram.usernames"和"telegram.chat_ids")。
调整AI模型("openai.model")、提示词("openai.prompt")和参数("openai.params")。
启用或禁用图像生成("imagine.enabled")。
添加或更改AI快捷指令("shortcuts")。
更改任何其他配置属性。

要查看特定的配置属性,在"/config"后面加上属性名:

/config telegram.usernames
/config openai.prompt
/config imagine.enabled

要更改特定的配置属性,在"/config"后面加上属性名和值:

/config telegram.usernames ["alice", "bob", "cindy"]
/config openai.prompt "你是一个邪恶的AI机器人"
/config imagine.enabled none

处理像"telegram.usernames"这样的列表属性时,你可以添加或删除单个项目,而不是重新定义整个列表:

/config telegram.usernames +cindy
/config telegram.usernames -bob

"/config"命令仅对管理员开放 - 即列在"telegram.admins"属性中的用户。

消息限制

在大群组中与机器人进行热烈讨论可能会导致OpenAI API的高使用率。为避免耗尽你的全部预算,可以使用"conversation.message_limit"配置属性为群组设置消息限制。

你可以限制一段时间内每个用户的消息数量。例如:

每小时每用户10条消息:

message_limit:
    count: 10
    period: hour

每分钟每用户1条消息:

message_limit:
    count: 1
    period: minute

每天每用户30条消息:

message_limit:
    count: 30
    period: day

设置

获取你的OpenAI API密钥
从@BotFather获取你的Telegram机器人令牌
将仓库克隆到服务器:

git clone https://github.com/nalgeon/pokitoki.git

将"config.example.yml"复制为"config.yml",并在其中指定你的令牌。将自己添加到"telegram.usernames"属性中,否则机器人将对所有人开放。
启动机器人:

docker compose up --build --detach

停止机器人:

docker compose stop

更新机器人到新版本:

docker compose stop
git pull
docker compose up --build --detach

对于较旧的Docker发行版,请使用"docker-compose"代替"docker compose"。

开发设置

准备环境:

python3 -m venv env
. env/bin/activate
pip install -r requirements.txt

准备配置和数据目录:

cp config.example.yml config.yml
mkdir ./data

在"config.yml"中设置令牌和其他设置。

运行测试:

python -m unittest discover

启动机器人:

python -m bot.bot

贡献

对于新功能和改进,请先开一个issue讨论你想要更改的内容。

确保适当地添加或更新测试。

使用Black进行代码格式化,使用Conventional Commits规范提交消息。

更新日志

有关功能历史,请参阅releases。

致谢

最初基于chatgpt_telegram_bot,尽管两个项目已经有了相当大的差异。