Discord
Discord 在这里怎么玩
成员用斜杠命令找机器人,而不是正常聊天。输入 /ask 运费多少? 会得到回答;在频道里直接输入 运费多少? 不会。
这是故意的。能读服务器每条消息的机器人需要远宽得多的权限,会看到社区的全部聊天,还会把你的额度花在没人叫它的闲聊上。斜杠命令让服务器的其他部分保持私密,什么时候叫机器人由成员自己决定。
添加到服务器(一键)
在控制面板侧边栏打开配置 → 渠道,在 Discord 卡片上选择授权。对话框以把 ProxyAI 机器人加到你的服务器和添加到服务器按钮开头。
- 选择添加到服务器,Discord 的授权页在新标签页打开。
- 选择服务器。你需要有该服务器的管理服务器权限,这是 Discord 对添加任何应用的要求,不是我们的。
- 选择授权,回到你的 ProxyAI 控制面板。
之后成员可以在该服务器用 /ask。不用创建任何东西,不用配置,不用去开发者网站。
机器人只要两个权限:查看频道和发送消息。斜杠命令没有它们也能用,它们是让你的团队成员能从 ProxyAI 收件箱往频道里回话。
要加第二个服务器,再选一次添加到服务器并选择它。要移除机器人,在 Discord 里把它从服务器移除。
一个值得知道的小毛病:卡片的重新检查菜单项只看下面的高级设置,所以一键安装后它会说“未配置”。连接是好的,在你的服务器里跑一句 /ask 确认即可。
高级:用你自己的机器人
当你想让机器人挂自己的名字和头像、用 ask 以外的命令名,或回复私信时选这个。要在 Discord 开发者网站上建应用,多花一点功夫。
- 打开 Discord Developer Portal 并选择新建应用。你起的名字就是成员看到的名字。
- 打开 Bot 选项卡,选择重置令牌,复制 Bot Token。Discord 只显示一次。
- 打开常规信息,复制 Public Key。ProxyAI 用它确认请求确实来自 Discord。
- 在 ProxyAI 对话框的高级:自带机器人下方粘贴两者。
- 可选,设置斜杠命令名,小写、无空格。留空即为
ask。 - 选择保存。
对话框还显示一个交互端点 URL 附带复制按钮。你用不上它:保存时会验证你的机器人、创建斜杠命令并把你的应用指向 ProxyAI,全自动。
然后邀请你的机器人:
- 开发者门户 → 安装。
- 在安装上下文下,为服务器启用 Guild Install;想让机器人回私信的话,也启用 User Install。
- 在默认安装设置下,给它
applications.commands和bot作用域以及发送消息权限。 - 复制安装链接,打开并选择你的服务器。
两个值都是密钥。一旦泄露,在 Discord 网站上重置令牌并把新的保存回来。
测试
在装了机器人的服务器里输入 /ask 并发出问题。Discord 显示机器人正在思考,几秒后回答到达。
- 命令不出现:全新命令最多一小时才同步到所有服务器,且 Discord 按设备缓存列表。等等,然后 Ctrl+R 重载(Mac 上 Cmd+R)。检查邀请时给了
applications.commands作用域。 - “This server is not connected to an assistant yet”:机器人在服务器里,但没有 ProxyAI 机器人认领它。去你的控制面板跑添加到服务器。
- “This assistant works inside a server”:你私聊了共享的 ProxyAI 机器人。共享机器人只在服务器内回答;私信需要你自己的、启用了 User Install 的机器人。
- “The application did not respond”:回答超时了,或连接被拒绝。高级路线的话,把 Discord 设置再保存一次。
- 保存报令牌无效:复制后令牌被重置过。再重置一次并粘贴最新的。
- 人工回复始终到不了:机器人在那个具体频道缺发送消息权限。查该频道的权限,而不是服务器大角色。
对话与隐私
在智能体收件箱里,一段对话属于某个 Discord 频道,不属于某一位成员。在共享频道里,所有用命令的人共用一段历史,人工回复整个频道可见。开了私信的地方,私信只属于各自成员。
机器人永远只看得到敲进命令里的文字。你的服务器里说的其他一切,ProxyAI 都看不到。