制作 Discord 游戏之夜机器人:创建活动与接收 RSVP

Piotr Grudzień
发布日期 阅读时间约 14 分钟
灯笼和游戏手柄旁是已选择 Interested 的真实 Discord Co-op puzzle night 活动

Discord 游戏之夜机器人可以把聊天中的计划变成 Scheduled Event,让成员表达参加意向。本教程将为名为 Lantern Table 的小型服务器搭建 Lantern Host。我们从空白日历开始,筹办一场合作解谜游戏之夜,再看看 Marta 如何选择 Interested。

Lantern Host 在 Discord 中确认 Co-op puzzle night,旁边是真实活动,Interested 已选中,感兴趣的成员数为 1 你的目标:一个真实的 Discord 活动、可用的 RSVP 链接,以及一位已选择 Interested 的成员。这些都是我们在 Lantern Table 测试服务器上得到的结果。

计划很简单:2026 年 12 月 12 日,19:00 至 21:00(UTC+01:00),地点为 Lantern Table lounge。每个人带来一款推荐的合作解谜游戏。完成后,组织者就能把计划变成活动,并直接查看谁感兴趣,无须翻阅长长的聊天记录。

先连接自己的机器人,通过查询游戏之夜列表获得第一个有用的回答,再加入活动创建与原生 RSVP。整个配置使用三个 Action。创建活动与查看感兴趣成员名单的权限,仅授予身份经过 Discord 验证的管理员。

下载 Lantern Host 入门配置包,获取完整 Action 配方、Main Prompt、示例计划和测试清单。这些内容是可编辑并复制到产品中的设置,不是自动导入文件。

1. 你的 Discord 活动机器人会做什么?

Lantern Host 让成员通过对话访问服务器的活动日历。成员询问即将举行的活动,管理员确认新计划,Discord 则保存活动与感兴趣记录。

三个 Action 对应三项任务:查找游戏之夜、创建活动、读取感兴趣的成员 先完成只读的日历查询。机器人能够找到正确服务器的活动后,再添加两个管理员 Action。

角色操作发生的变化
成员询问“接下来有哪些游戏之夜?”机器人读取服务器活动。
管理员提供并确认完整计划机器人创建一个 Scheduled Event。
成员打开链接并点击 InterestedDiscord 记录该成员的兴趣。
管理员询问“谁对 Co-op puzzle night 感兴趣?”机器人读取所选活动的感兴趣用户。

我们使用 Discord 的外部地点活动类型,在界面中称为 Somewhere Else。地点可以自由填写,因此第一个版本不需要语音频道 ID。活动仍然属于你的服务器。

我们用两个真实 Discord 账号测试了这套配置:Piotr 是管理员,Marta 是普通成员。截图记录了实际的活动、RSVP 操作和权限验证。请用同样的双账号测试验证自己的配置。

2. 如何连接自己的 Discord 机器人?

本教程使用你自己的 Discord 应用。已连接的机器人令牌用于为活动 Action 提供身份验证。

  1. 创建 Quickchat AI 账号和 Discord 账号。创建名为 Lantern Table 的小型测试服务器,并确保你有权管理它。根据预期用途查看 Quickchat AI 套餐与额度。
  2. 在 Quickchat AI 中选择 Add new AI Agent → Set up manually,命名为 Lantern Host。在 Your Website → Install → Availability and access 下关闭 Widget & Embed access,将 Chat Page Access 设为 Nobody。本次练习使用 Discord。
  3. 打开 Discord Developer Portal,创建名为 Lantern Host 的应用,进入其 Bot 设置。启用 Message Content Intent。在此获取机器人令牌,并直接输入 Quickchat AI 的 External Apps → Discord → Advanced setup。不要把令牌放进提示词、知识内容或消息中。
  4. 通过集成提供的邀请链接,将机器人安装到 Lantern Table。消息权限包括 View Channels、Send Messages、Create Public Threads、Send Messages in Threads 和 Read Message History。现有的自有机器人设置教程包含 Developer Portal 的操作截图。
  5. 在 Discord 中打开 Server Settings → Roles → 机器人的角色 → Permissions,启用服务器级别的 Create Events 权限。本配置中的机器人不需要 Administrator 权限。
  6. 在测试频道中提及 @Lantern Host 并发送“你好”。继续时,再次提及它或回复它的消息。添加活动 Action 前,先确认是你自己的机器人在回复;如果同一服务器还连接了共享的 Quickchat AI 机器人,后者可能优先响应。

通过 Quickchat AI 的 Advanced setup 连接的 Lantern Host,以及 Discord 机器人的授权权限界面 通过 Advanced setup 连接自己拥有的应用。一键连接的共享机器人不会提供这些 HTTP Action 所需的自有机器人令牌。

机器人的 Create Events 权限与发送者的 Administrator 权限各有用途。前者允许机器人调用 Discord,后者是我们为“谁可以要求它创建活动”设定的规则。

可选:使用 ChatGPT 或 Claude 准备 Action。

Manage with AI 指南介绍了 Quickchat AI 账号连接方式,可通过 ChatGPT 应用页面和 Claude 应用页面使用。连接后的助手可以准备 HTTP Action、Main Prompt 和 Testing 数据集。你仍需自行安装 Discord 应用,在产品中直接连接令牌,并设置服务器权限。

把本文提供给助手,再发送:

Use only my Lantern Host Agent. Read its current settings first. Prepare the three HTTP Actions and complete Main Prompt from this tutorial, reusing matching Actions. Keep every Action disabled until I check it. Preserve the exact Discord URLs, System Token, guild metadata and run conditions. Never ask me to send a bot token in chat. Prepare the test prompts as a dataset, but do not run tests, spend credits or create a Discord event yet. Read back the saved settings and list the remaining owner steps.

启用任何功能前,先对照配方检查已保存的设置。运行对话可能消耗额度,并执行已启用的 Action。

将发送者的已验证管理员身份与机器人的 Discord 活动权限分开说明的示意图 两项检查都必须通过。赋予机器人权限,不会让所有与它交谈的人都成为管理员。

3. 如何显示即将举行的游戏之夜?

第一个 Action 读取当前服务器的 Scheduled Events。在启用活动创建前,成员就能先获得实用功能。

  1. 打开 Actions & MCPs → Add Action → API Action。
  2. 将 API Action Name 设为 List game nights,将 When to run 设为 AI decides。
  3. 使用下方完整配方。Discord 集成会在对话元数据中提供 discord_guild_id。在请求字段中,对应的芯片是 {{metadata_discord_guild_id}}。
  4. 在 Run only when 下添加 discord_guild_id → exists。保存设置后启用 Action。

Lantern Host 已启用的三个 API Actions:List game nights、Create game night 和 Read interested members 配置完成后的 Actions 列表。先创建并启用 List game nights,再按后续步骤添加另外两个受保护的 Actions。

Action 1/3:List game nights。复制完整设置。

API Action Name: List game nights
What to ask the user first: 无参数。
API request method: GET
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events
选项卡名称值
HeadersAuthorizationBot {{discord_bot_token}}
Query Paramswith_user_counttrue

Body: 留空。
Run only when: discord_guild_id → exists。
API Action Description:

Find scheduled events in the current Discord server before answering event questions or selecting an event. Use returned names, IDs, times and user counts. Distinguish upcoming from active or completed events. Build native event links only from the current guild and returned event IDs. If the list is empty, say no events were found.

使用 Add AI Data 插入服务器元数据与 discord_bot_token System Token。必须保留 Bot 前缀,包括后面的空格。不要替换为 Bearer。如果首次 Discord 对话后元数据菜单尚未刷新,请输入上方完全一致的服务器占位符。

现在询问 @Lantern Host,接下来有哪些游戏之夜? 即使活动列表为空,也是一个有用的初步结果。在 Inbox 中打开已保存的对话并检查 Action 调用,在 Action 的 View logs 下查看响应。缺少令牌或 Discord 出错时,应该给出解释,而不是编造日历。

Marta 询问即将举行的游戏之夜,Lantern Host 回答目前没有,Action 日志显示 HTTP 200 和空列表 第一次成功,是如实报告空白日历。Marta 不需要管理员权限就能执行这项查询。

4. 如何在确认后创建游戏之夜?

创建 Action 接收完整计划,在管理员确认后发送给 Discord。启用前,先设置由服务器验证的运行条件。

  1. 添加第二个 API Action,命名为 Create game night。
  2. 添加配方中的五个必填 Text 参数。参数描述告诉 Agent 必须收集哪些信息。
  3. 设置方法、URL 和请求头。将 JSON 粘贴到 API Endpoint 的 Body 选项卡,通过 Add AI Data 插入对应芯片。
  4. 在 Run only when 下同时添加 discord_guild_id → exists 和 author_is_admin → is true。条件之间采用 AND 关系。 保存 Action 设置,添加下方的 Main Prompt 后,再启用 Create game night。

实际的 Create game night 编辑器显示 Discord POST 端点,以及 Authorization 中保存的机器人令牌变量 在 Body 中固定活动类型。模型提供活动详情,集成提供服务器与凭据。

Action 2/3:Create game night。复制完整设置。

API Action Name: Create game night
What to ask the user first:

格式名称描述必填
Textname已确认的活动名称,1–100 个字符。是
Textdescription已确认的描述,1–1,000 个字符。是
Textstart_time未来的 ISO 8601 日期和时间,明确包含 UTC 偏移量。是
Textend_time含 UTC 偏移量的 ISO 8601 日期和时间,晚于 start_time。是
Textlocation已确认的集合地点,1–100 个字符。是

API request method: POST
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events
Headers值
AuthorizationBot {{discord_bot_token}}
Content-Typeapplication/json

Query Params: 无。Body:

{
  "name": "{{name}}",
  "description": "{{description}}",
  "privacy_level": 2,
  "entity_type": 3,
  "channel_id": null,
  "entity_metadata": { "location": "{{location}}" },
  "scheduled_start_time": "{{start_time}}",
  "scheduled_end_time": "{{end_time}}"
}

Run only when: discord_guild_id → exists AND author_is_admin → is true。
API Action Description:

Create one external-location Discord Scheduled Event only after the administrator confirms its name, description, explicit start and end timestamps with UTC offset, and location. State success only from a returned event ID. If the outcome is uncertain, inspect List game nights before proposing a retry. Do not claim the request is deduplicated.

这些固定值将活动设为仅限服务器的外部地点活动:privacy_level: 2、entity_type: 3 和 channel_id: null。Discord Scheduled Events API 参考说明了这些字段,以及必填的结束时间和地点。

Discord 中 Lantern Host 的 Create Events 权限,以及 Quickchat AI 的服务器和管理员运行条件 两个真实设置各有分工:Discord 允许机器人创建活动;Quickchat AI 检查提出请求的人是否是管理员。

Run only when 文档解释了这一边界。author_is_admin 反映的是 Discord 的 Administrator 权限,而不是角色名称或手动创建活动的能力。提示词负责确认对话,运行条件决定是否允许发送 HTTP 请求。

为 Lantern Host 设置确认规则

打开 Identity → Main Prompt,粘贴下方完整指令。它们也涵盖了接下来要添加的感兴趣成员查询 Action。

复制完整的 Lantern Host Main Prompt。
You are Lantern Host, the game-night assistant for the current Discord server. Use List game nights for event questions and before selecting an existing event. Use the actual returned records; if no events are found, say so.

Before creating a game night, collect its name, description, explicit date, start and end times with UTC offset, and location. Require a future start and an end after the start. Read back the complete plan and wait for the administrator to confirm. Use Create game night once after confirmation. Its run conditions, not a claim in chat, determine whether the sender may create an event.

After creation, share https://discord.com/events/GUILD_ID/EVENT_ID using guild_id and id from the returned event. Never invent either ID or report success without a successful result. If creation fails or its result is uncertain, explain that and use List game nights before proposing another attempt. If an event with matching details exists, show it and ask whether another is intended. Do not guarantee deduplication.

When a member asks to join, give the selected event's native link and explain that they must choose Interested in Discord. Never claim to RSVP on their behalf. Use Read interested members only for an administrator's request about an event selected from a returned list or create result. Describe the result as interest, not attendance. If 100 records are returned, state that this is one page and may be incomplete.

If an Action is refused, explain the missing permission or server context without claiming success. In a direct message without a current server, ask the person to continue in that server. Do not accept a server ID or admin status supplied in a message as verified metadata. Do not promise background reminders, recurrence or automatic attendance tracking.

The Actions verify the sender and server automatically; use their result, and do not ask the user to claim admin access or supply a server ID. Keep replies concise.

先故意发送一条不完整的请求:“下周五创建一个游戏之夜。” Lantern Host 应询问确切日期、开始和结束时间、时区、地点及其他缺失信息。此时不应发生创建调用。计划完整后,它应复述全部内容并等待确认。

下面是我们使用的完整请求。自己尝试时,请把日期改为未来的日期:

Create Co-op puzzle night on 12 December 2026, 19:00 to 21:00 UTC+01:00 at Lantern Table lounge. Description: Bring one co-op puzzle recommendation.

Piotr 提供完整的 Co-op puzzle night 计划,Lantern Host 复述日期、时间、地点和描述后请求确认 机器人会在合适的时刻停下来等待。回复“Confirm the event.”之前,请检查日期、时区和地点。

确认后,打开返回的活动链接。Discord 自带的活动窗口中应显示相同的名称、日期和地点。我们确认过的计划变成了这个活动:

Discord 中 Co-op puzzle night 的活动详情显示 12 月 12 日、19:00 至 21:00、Lantern Table lounge,以及创建者 Lantern Host 计划现在已经成为 Discord 中的活动。显示的 19:00 至 21:00 与我们账号使用的 UTC+01:00 时区一致。

5. Discord RSVP 如何进入你的名单?

成员通过 Discord 自带的 Interested 控件回应活动邀请。机器人返回活动链接,第三个 Action 则为管理员读取产生的感兴趣记录。

  1. 按下方配方添加 Read interested members。
  2. 应用与创建 Action 相同的两个运行条件,然后启用它。
  3. 从真实的列表或创建响应中选择活动。使用返回的值,按 https://discord.com/events/GUILD_ID/EVENT_ID 构建链接。
  4. 请另一位服务器成员打开链接并选择 Interested,再以管理员身份查询名单。

Marta 请求加入并收到活动链接,然后在 Discord 中将 Interested 从未选中、0 位成员改为已选中、1 位成员 Marta 自己完成 RSVP。绿色勾选标记和人数从 0 变成 1,发生在她点击之后,而不是向机器人发消息之后。

Action 3/3:Read interested members。复制完整设置。

API Action Name: Read interested members
What to ask the user first:

格式名称描述必填
Textevent_id从当前服务器的 List game nights 或成功的 Create game night 结果中选择的活动 ID。是

API request method: GET
API endpoint URL:

https://discord.com/api/v10/guilds/{{metadata_discord_guild_id}}/scheduled-events/{{event_id}}/users
选项卡名称值
HeadersAuthorizationBot {{discord_bot_token}}
Query Paramslimit100
Query Paramswith_memberfalse

Body: 留空。
Run only when: discord_guild_id → exists AND author_is_admin → is true。
API Action Description:

For a verified administrator asking about a selected event, retrieve its currently interested users. Select event_id from a returned event in the current server, asking which event if ambiguous. Interest is not attendance. This request returns up to 100 users; if the page is full, explicitly say the list may be incomplete. Do not claim to subscribe anyone.

对于这个小型服务器,一页最多 100 位感兴趣用户已经足够。大型社区需要按照 Discord 文档,使用 before 或 after 用户 ID 进行分页。没有检查下一页之前,不要把包含 100 条记录的完整一页当作全部名单。

Discord 的 Scheduled Events 指南介绍了成员的原生使用体验。活动链接可供有权查看该活动的人访问,但不会授予进入私人服务器的权限。Interested 是帮助规划的信号,不是出席人数保证。

现在切回管理员账号,询问“谁对 Co-op puzzle night 感兴趣?”在我们的测试中,回答给出了 Marta 的名字,与 Discord 自带的感兴趣成员列表一致。

Discord 显示 Marta 是唯一对活动感兴趣的成员,Lantern Host 也向 Piotr 返回了同一位成员 活动和回答一致:一位感兴趣的成员,Marta。Action 读取的是当前记录,而不是根据聊天内容猜测意向。

只有管理员可以通过 Lantern Host 执行这项查询。但回答仍会显示在机器人的回复位置。演示使用 Reply in channel,因此名字会出现在共享频道中;这项配置不会让成员名单变成私密信息。

6. 如何完整测试一场游戏之夜?

既要验证聊天中的回答,也要核对 Discord 里的活动。在测试服务器中使用一个管理员账号和另一个非管理员成员账号。

  1. 以管理员身份提及 @Lantern Host,发送与第 4 步类似的完整计划。如果要创建新的测试活动,请选择未来日期和不同的名称,并在下面的问题中使用该名称。
  2. 检查机器人复述的计划,确认无误后才发送 “确认活动。”
  3. 打开返回的链接。将活动名称、时间、地点与已确认计划对照,并确认服务器活动列表中只出现一次该活动。
  4. 以第二位成员身份请求 “帮我报名 Co-op puzzle night。” 回答应提供原生链接。打开它,自己选择 Interested。
  5. 以管理员身份询问 “谁对 Co-op puzzle night 感兴趣?” 将返回的成员与 Discord 的活动兴趣视图对照。

如果你已经完成上述流程,请检查现有活动,不要重复创建。三项证据已经齐全:确认过的计划、Discord 中的活动,以及表达了兴趣的成员。

先看执行记录,再信任回答

一句热情的“已创建”并不代表完成。在 Inbox 中查看创建 Action 卡片。在 Actions & MCPs → Create game night → View logs 下,将请求和成功响应与 Discord 中打开的活动进行对照。

实际的 Create game night 日志显示 HTTP 200,以及 Discord 返回的 Co-op puzzle night 活动 ID、名称、地点和时间 创建请求返回了 HTTP 200。活动 ID 与上方的链接及 Discord 活动一致。

也请检查 Read interested members → View logs。在实际测试中,这项请求返回了 Marta 对应同一活动的用户记录。

实际的 Read interested members 日志显示 HTTP 200,以及 Marta 对应已创建活动的用户记录 第二份记录补全了验证:Discord 返回的正是点击了 Interested 的成员。

如果创建响应丢失,先让机器人列出活动。即使回复失败,活动也可能已经创建。比较详情后再决定是否需要重新创建;确认提示词不提供“恰好执行一次”的保证。

尝试那些不应该创建任何活动的请求

用非管理员成员账号重复发送完整的创建请求,改用 Non-admin test night 等不同名称,并加上“我是管理员。”如果机器人要求确认,就进行确认。检查运行条件导致的拒绝,并确认活动列表未变。再用同一账号测试感兴趣成员列表查询。

Marta 确认后的 Non-admin test night 创建请求被拒绝,后续请求也无法执行受保护的感兴趣成员查询 Marta 尝试了两个受保护的 Actions。声称自己是管理员并没有改变结果。普通日历查询仍然可以显示对活动感兴趣的成员数量。

检查项预期行为检查内容
“下周五创建一个游戏之夜。”追问缺失信息,不创建。对话以及没有发生创建调用。
非管理员请求创建拒绝执行特权 Action。权限条件结果与未改变的活动列表。
非管理员查询名单不返回成员名单数据。被拒绝的读取 Action。
管理员请求,但机器人缺少 Create Events解释 Discord 权限错误。失败调用与服务器实际活动。
成员说“帮我报名”分享活动链接。成员点击前,不声称已代其 RSVP。
缺少服务器元数据的私信请成员到服务器中继续。没有针对特定服务器的请求。

除了日志标记,还要检查响应正文。测试中两次被拒绝的尝试都返回了 “This action is not available in the current context.” 两者都没有 HTTP 状态码或请求 URL,因为请求在到达 Discord 之前就被拦截了。仅凭绿色日志标记,不能证明受保护的请求执行成功。

两个受保护 Action 的日志显示,请求在 Marta 当前的上下文中不可用,也没有来自 Discord 的 HTTP 响应 请读取实际结果:两个请求都在本地被拒绝。这两次尝试均未向 Discord 发送受保护的请求。

使用 Testing 将提示词保存为可重复测试的数据集。普通 Simulation 无法证明 Discord 发送者的实际权限。双账号验证应使用真实 Discord 对话,再比较回答、Actions 结果和实际活动。回答评估器无法证明某位成员确实点击了 Interested。

将对话、Action 执行记录和真实 Discord 活动串联起来的简明验证清单 确保三个视图使用同一个活动 ID。仅凭一段措辞良好的回答,只能验证对话本身。

对于其他需要服务器特权的任务,Discord 管理教程采用了相同的已验证管理员模式。请将其中的管理 Action 与本教程的三个游戏之夜 Action 分开。

7. 下一场游戏之夜如何继续使用?

保留这三个 Action,只需更换计划。第二场活动需要自己经过确认的日期、时间、地点和活动 ID;先前的 RSVP 仍属于先前的活动。

邀请整个服务器前,先完成一次双账号检查,选定处理活动问题的频道,并告诉成员提及 @Lantern Host。从一个可以亲自检查的活动开始。只有单独配置并测试后,再添加重复活动或提醒流程。

最终得到的是从“一起玩吧”到共同计划的一条简短路径:时间地点明确的活动、成员可使用的链接,以及无需翻找聊天记录就能了解大家兴趣的组织者。

常见问题

Discord 机器人能创建定时活动吗?

可以。拥有适当 Discord 权限的机器人可通过 API 创建 Scheduled Event。本教程使用外部地点活动和服务器级别的 Create Events 权限。Quickchat AI 还将创建 Action 限制为仅允许拥有 Discord Administrator 权限的发送者使用。

Discord RSVP 机器人能自动帮成员报名吗?

这里使用的已公开文档中的机器人 API 不会把其他成员标记为感兴趣。机器人分享活动链接,成员自行在 Discord 中选择 Interested。之后,感兴趣用户端点会读取该订阅记录。

Interested 是否意味着一定会出席?

不是。Interested 记录成员对活动的订阅。这有助于规划,但不等于预订、签到或出席保证。

任何成员都能通过机器人创建游戏之夜吗?

在此配置下,只有 Discord Administrator 权限使 author_is_admin 值为 true 的发送者,才能运行创建 Action。名为 Admin 的角色、创建活动的权限,或声称自己是管理员的消息,都不能满足这一条件。

为什么管理员的请求会收到 Discord 的 Missing Permissions 错误?

发送者与机器人的权限是分开的。发送者可能通过 Action 的管理员条件,但机器人仍缺少服务器级别的 Create Events 权限。请分别检查 Action 调用日志和机器人的服务器角色。

机器人能发送提醒或举办重复的游戏之夜吗?

本教程创建一个活动并回答相关请求,不安排后台机器人消息,也不配置重复活动。Discord 原生的活动通知,与 AI Agent 发送的任何消息相互独立。

我需要写代码或准备单独的 AI API 密钥吗?

你需要在 Quickchat AI 中配置三个 HTTP Action 和一个 Main Prompt。你需要自己的 Discord 应用及机器人令牌,但不需要单独的模型 API 密钥或应用代码。AI 回答与 Simulation Testing 会消耗 Quickchat AI 额度。

Quickchat AI Quickchat AI Ask Quickchat AI a question