Neocortex Logo

Portal 2 AI 模组:会说话的测试室 AI 与语音指令

制作 Portal 2 AI 模组:一个会讽刺、对你的尝试做出反应的测试室 AI,支持语音控制的测试室和科学问答,并通过 VScript 连接。

Neocortex TeamThe team behind Neocortex

· 阅读约 6 分钟

制作 Portal 2 AI 模组:一个会讽刺、对你的尝试做出反应的测试室 AI,支持语音控制的测试室和科学问答,并通过 VScript 连接。

Portal 2 的地图脚本无法访问互联网。这是每个 Portal 2 AI 模组都必须解决的问题,答案是一个运行在游戏旁边的小型辅助应用。 一旦部署好,你的测试室就能拥有自己会说话的 AI,这很适合一款关于被墙壁中的声音评判的游戏:一个会注意到你同一次跳跃失败了五次、并对此发表意见的测试室;一个你可以用语音控制的测试室;以及一个只有答对才会打开出口的问答。Neocortex 提供 AI 角色、对话流程、问答和设备端语音指令。

Portal 2 游戏内截图 截图:Portal 2 © Valve

为什么 Portal 2 AI 模组需要辅助应用?

Portal 2 的地图使用 Portal 2 Authoring Tools 在 Hammer 中制作,并分享到 Steam Workshop。地图逻辑由实体输入输出加上 VScript 组成,在 Portal 2 中 VScript 使用的是 Squirrel。VScript 可以读取和移动实体、追踪玩家并输出到控制台,但没有网络或 HTTP 访问能力。

因此,地图只做它能做的事:汇报并做出反应,而本地辅助应用负责与 Neocortex 对话。辅助应用可以用任何带有 HTTP 客户端的语言编写。

事件如何传出游戏,又如何传回?

方向方式
从游戏输出你的 VScript 把带标签的行(一个事件、一个测试室状态)输出到控制台。使用 -condebug 启动 Portal 2,会把控制台输出写入一个 console.log 文件,辅助应用可以监视该文件。参见 Valve 的命令行选项。
传回游戏-netconport 启动选项会打开一个控制台端口,允许辅助应用把控制台命令发回游戏,例如调用地图 VScript 的 script。请将该端口保留在你自己的电脑上。
字幕你的地图使用 game_text 实体显示回复文字。
语音辅助应用通过电脑的音频输出播放角色语音。

在 Neocortex 一侧,辅助应用从控制台日志读取游戏状态,并通过 /v3/chat 把它与玩家的消息一起发送给角色。地图以字幕形式显示回复,辅助应用从 /v3/audio/generate 或 /v3/audio/stream 播放语音,角色返回的行动则以控制台命令的形式送回地图。对话流程会返回地图会做出反应的检查点关键词(flowState),例如打开下一个测试;问答引擎则通过 /v3/quiz 运行问答游戏。

测试室 AI 能做什么?

创建一个原创的监督者,而不是借用游戏中的角色:PROCTOR-7,一个被降级为只管理一间测试室的设施智能,而且对此并不满意。为它设置 Personality、Emotion 设置,以及关于你测试室解法、历史和各种琐碎不满的 Knowledge 库。

你的地图会汇报发生的事情:“玩家掉进了凝胶里”“在面板 B 上第三次失败的甩射”“方块放在了错误的按钮上”“玩家站着不动已经 40 秒”。辅助应用会把这些作为事件随每条消息发送,PROCTOR-7 则以语音进行评论,每句台词都带有情绪标签:你尝试新东西时为 CURIOUS,你打破预定解法时为 ANGRY。

它还能返回行动,例如在足够多次失败后,它会勉强地返回 { "name": "SPAWN_CUBE", "targetId": "dropper_01" },地图会把它作为提示执行。

对话流程可以把整个测试室变成一个故事:开场介绍、第一个测试、一次玩家必须通过与 PROCTOR-7 对话来排除的“故障”,以及最后一个测试。API 返回的每个检查点关键词都会打开地图的下一部分。

Portal 2 游戏内截图 截图:Portal 2 © Valve

玩家能靠说话解开测试室吗?

可以。制作一个玩家通过与它对话来解开的测试室。在 Neocortex 控制台中,你可以把指令集设计为执行者、动作和对象:执行者 "chamber",动作 "raise"、"lower"、"drop" 和 "extend",对象 "platform"、"cube" 和 "bridge"。

玩家可以自然地说话,辅助应用会即时收到匹配的指令,包括一句话中的多个动作和数量,例如:“放下两个方块,然后升起平台”。它支持按键说话或持续监听,支持多种语言;Neocortex 语音指令在玩家的电脑上运行,没有云端往返,这在甩射的时机取决于它时非常重要。

语音指令是授权 SDK:联系我们获取语音指令授权。

同一个测试室也可以考察知识而不是反应力。一个播报员角色会提出在 Neocortex 控制台中设计的物理问题:动量、重力,以及为什么传送门会保持你的速度。问答引擎(Team 套餐)负责运行问题和计分;每答对一题就为一段光桥供电,答错则会让一个方块掉进凝胶里。

它能在 Portal 2: Community Edition 中运行吗?

Portal 2: Community Edition 是由社区维护的 Portal 2 版本,基于 Strata Source 引擎,这是 CS:GO 引擎分支的一个官方授权分支。它于 2026 年 4 月 17 日在 Steam 上开启公开测试,对 Portal 2 的拥有者免费,并增加了原生 64 位移植、AngelScript 脚本、Panorama UI、插件系统以及它自己的 Workshop。

它仍处于测试阶段,因此请查看其文档,了解它的脚本功能有哪些。无论如何,辅助应用的模式在那里同样适用。

能把它发布到 Workshop 上吗?

Valve 的 Workshop 条款适用于地图本身,而辅助应用是玩家自行选择运行的单独下载。请将 AI 和语音功能限于单人测试室,切勿用它们在未选择加入的玩家的合作模式中获取优势,并让每位玩家使用自己的 Neocortex API 密钥。

制作你的第一个会说话的测试室

  1. 在 Hammer 中制作测试室,并用一个 VScript 文件把带标签的事件输出到控制台。
  2. 在 Neocortex 控制台中设计角色: PROCTOR-7 的 Personality 和 Knowledge、测试室的对话流程、一个问答,以及一组指令。
  3. 编写辅助应用: 监视 console.log,调用 /v3/chat,播放语音,并通过控制台端口发回指令。
  4. 把 API 密钥保存在辅助应用的配置文件中,由玩家自行填写,切勿硬编码在你分享的版本中。
  5. 在单人模式下测试,并设置好启动选项,然后分别发布地图到 Workshop 和辅助应用。

关于语音部分,请阅读游戏模组的设备端语音指令。关于 Source 引擎的引擎级模组,请参阅我们的 Half-Life 2 AI NPC 模组指南;如果是脚本可以直接调用 API 的 Source 游戏,请参阅我们的 Titanfall 2 AI 模组指南。如果你以后想让 PROCTOR-7 出现在独立游戏中,同一个 Neocortex 角色可以通过我们的 Unity 集成使用。

工具版本和链接核对于 2026 年 10 月。模组工具更新频繁,请查看各项目页面以获取最新版本。

常见问题

能为 Portal 2 添加 AI 角色吗?

可以,借助一个小型辅助应用。Portal 2 的地图脚本无法访问互联网,因此地图把事件输出到控制台,本地辅助应用再把它们传给 AI 角色。Neocortex 提供角色、它的语音和它的回复,辅助应用再把这些送回游戏。

Portal 2 的 VScript 能发出 HTTP 请求吗?

不能。Portal 2 中的 VScript 是运行在地图内部的 Squirrel,没有网络访问。常见做法是把事件记录到控制台,由辅助应用读取,然后让该应用调用 Neocortex 等 Web API。

我能用语音控制 Portal 2 的测试室吗?

可以。辅助应用可以监听麦克风,并把匹配的指令送入游戏,例如升起平台或放下方块。Neocortex 语音指令在玩家的电脑上完成匹配,因此可以离线工作,并即时响应。

什么是 Portal 2: Community Edition?

Portal 2: Community Edition 是由社区维护的 Portal 2 版本,基于 Strata Source 引擎,自 2026 年 4 月起在 Steam 上公开测试,对 Portal 2 的拥有者免费。它增加了 AngelScript、Panorama UI 和插件系统,而 Neocortex 的辅助应用模式在那里同样适用。

我能把 AI 测试室发布到 Steam Workshop 上吗?

你可以像往常一样把地图发布到 Workshop,但辅助应用需要单独分享,例如通过 GitHub。每位玩家都用自己的 Neocortex API 密钥运行它,该密钥可以在浏览器编辑器中获取。

相关文章

继续阅读