Portal 2 AI 모드: 말하는 테스트 챔버 AI와 음성 명령
Portal 2 AI 모드를 만드세요. 시도에 빈정대며 반응하는 테스트 챔버 AI, 음성으로 조작하는 챔버, 과학 퀴즈를 VScript와 연결해 구현합니다.
Neocortex TeamThe team behind Neocortex
· 6분 분량

Portal 2 맵 스크립트는 인터넷에 접근할 수 없습니다. 모든 Portal 2 AI 모드가 풀어야 하는 한 가지 문제이며, 해답은 게임 옆에서 돌아가는 작은 도우미 앱입니다. 이것이 갖춰지면 여러분의 테스트 챔버에도 말하는 AI를 둘 수 있습니다. 벽 속 목소리에게 평가받는 게임에 잘 어울리는 기능입니다. 같은 점프에서 다섯 번 실패하는 것을 알아채고 한마디 하는 챔버, 말로 조작하는 챔버, 정답을 맞힌 경우에만 출구를 열어 주는 퀴즈가 있습니다. Neocortex는 AI 캐릭터, Conversation Flow, 퀴즈, 기기 내 음성 명령을 제공합니다.
스크린샷: Portal 2 © Valve
Portal 2 AI 모드에 도우미 앱이 필요한 이유는 무엇인가요?
Portal 2 맵은 Portal 2 Authoring Tools로 Hammer에서 만들며, Steam Workshop에 공유합니다. 맵 로직은 엔티티 I/O와 VScript로 이루어지며, Portal 2에서 VScript는 Squirrel입니다. VScript는 엔티티를 읽고 움직이고, 플레이어를 추적하고, 콘솔에 출력할 수 있지만 네트워크나 HTTP 접근은 없습니다.
그래서 맵은 할 수 있는 일, 즉 보고하고 반응하는 일을 하고, 로컬 도우미 앱이 Neocortex와 대화합니다. 도우미는 HTTP 클라이언트가 있는 어떤 언어로든 작성할 수 있습니다.
이벤트는 게임 밖으로 어떻게 나가고, 다시 어떻게 들어오나요?
| 방향 | 방법 |
|---|---|
| 게임 밖으로 | VScript가 태그가 붙은 줄(이벤트, 챔버 상태)을 콘솔에 출력합니다. -condebug 옵션으로 Portal 2를 실행하면 콘솔 출력이 도우미가 지켜볼 수 있는 console.log 파일에 기록됩니다. Valve의 명령줄 옵션을 보세요. |
| 게임 안으로 | -netconport 실행 옵션은 콘솔 포트를 열어, 도우미가 콘솔 명령을 다시 보낼 수 있게 합니다. 예를 들어 맵의 VScript를 호출하는 script 명령이 있습니다. 이 포트는 여러분의 컴퓨터 안에만 열어 두세요. |
| 자막 | 맵이 game_text 엔티티로 응답 텍스트를 보여 줍니다. |
| 음성 | 도우미가 PC의 오디오 출력으로 캐릭터의 음성을 재생합니다. |
Neocortex 쪽에서는 도우미가 콘솔 로그에서 게임 상태를 읽어, 플레이어의 메시지와 함께 /v3/chat을 통해 캐릭터에게 보냅니다. 맵은 응답을 자막으로 보여 주고, 도우미는 /v3/audio/generate 또는 /v3/audio/stream에서 받은 음성을 재생하며, 캐릭터가 돌려준 행동은 콘솔 명령으로 맵에 전달됩니다. Conversation Flow는 맵이 반응할 체크포인트 키워드(flowState)를 돌려주며, 다음 테스트를 여는 등의 일을 합니다. 퀴즈 엔진은 /v3/quiz를 통해 질문과 답변 게임을 진행합니다.
테스트 챔버 AI는 무엇을 할 수 있나요?
게임의 기존 감독관을 빌려 쓰지 말고 독창적인 감독관을 만드세요. PROCTOR-7은 챔버 하나를 운영하는 것으로 강등된 시설 지능이며, 그 처지에 전혀 만족하지 않습니다. Personality, Emotion 설정, 그리고 챔버의 해법, 역사, 사소한 불만에 대한 Knowledge base를 주세요.
여러분의 맵은 일어난 일을 보고합니다. "플레이어가 젤에 빠짐", "패널 B에서 세 번째 실패한 플링", "큐브를 잘못된 버튼에 올림", "플레이어가 40초 동안 가만히 서 있음" 같은 것입니다. 도우미는 이를 각 메시지와 함께 이벤트로 보내고, PROCTOR-7은 모든 대사에 감정 태그를 붙여 음성으로 논평합니다. 새로운 시도를 하면 CURIOUS, 의도된 해법을 깨뜨리면 ANGRY입니다.
또한 행동을 돌려줄 수 있습니다. 예를 들어 여러 번 실패한 뒤 마지못해 주는 { "name": "SPAWN_CUBE", "targetId": "dropper_01" } 같은 행동이 있으며, 맵은 이를 힌트로 실행합니다.
Conversation Flow로 챔버 전체를 이야기로 만들 수 있습니다. 도입부, 첫 테스트, 플레이어가 PROCTOR-7과 대화하며 해결해야 하는 "오작동", 마지막 테스트로 이어집니다. API가 돌려주는 체크포인트 키워드마다 맵의 다음 부분이 열립니다.
스크린샷: Portal 2 © Valve
플레이어가 말로 챔버를 풀 수 있나요?
네. 플레이어가 말을 걸어 풀 수 있는 챔버를 만드세요. Neocortex 대시보드에서 명령 세트를 액터, 행동, 대상으로 설계합니다. 예를 들어 액터는 "chamber", 행동은 "raise", "lower", "drop", "extend", 대상은 "platform", "cube", "bridge"입니다.
플레이어는 자연스럽게 말하고, 도우미는 일치하는 명령을 즉시 받습니다. "큐브 두 개를 떨어뜨리고 플랫폼을 올려"처럼 한 문장에 여러 행동과 수량이 들어가도 됩니다. 푸시 투 토크나 항상 듣기 방식으로, 여러 언어에서 동작합니다. Neocortex Voice Commands는 플레이어의 컴퓨터에서 실행되며 클라우드 왕복이 없습니다. 플링의 타이밍이 이에 달려 있을 때 중요한 점입니다.
Voice Commands는 라이선스가 필요한 SDK입니다. Voice Commands 라이선스 문의하기.
같은 챔버로 반사 신경 대신 지식을 테스트할 수도 있습니다. 안내 캐릭터가 Neocortex 대시보드에서 만든 물리 질문을 던집니다. 운동량, 중력, 포탈이 속도를 유지하는 이유 같은 것입니다. 퀴즈 엔진(Team 플랜)은 질문과 점수를 처리합니다. 정답 하나마다 빛 다리 한 구간이 켜지고, 오답이면 큐브가 젤 속으로 떨어집니다.
Portal 2: Community Edition에서도 동작하나요?
Portal 2: Community Edition은 공식 라이선스를 받은 CS:GO 엔진 브랜치의 포크인 Strata Source 위에서 커뮤니티가 관리하는 Portal 2 버전입니다. 2026년 4월 17일 Steam에서 오픈 베타에 들어갔고, Portal 2 소유자에게는 무료이며, 네이티브 64비트 포팅, AngelScript 스크립팅, Panorama UI, 애드온 시스템, 자체 Workshop을 추가합니다.
아직 베타이므로, 스크립팅으로 무엇을 할 수 있는지는 문서에서 확인하세요. 도우미 앱 패턴은 어느 쪽에서든 그대로 동작합니다.
Workshop에 공개할 수 있나요?
맵에는 Valve의 Workshop 약관이 적용됩니다. 도우미 앱은 플레이어가 실행을 선택하는 별도 다운로드입니다. AI와 음성 기능은 싱글플레이어 챔버에만 쓰고, 참여에 동의하지 않은 플레이어와의 협동 플레이에서 이점을 얻는 데 쓰지 마세요. 각 플레이어는 자신의 Neocortex API 키를 사용해야 합니다.
첫 번째 말하는 챔버 만들기
- 테스트 챔버를 만드세요. Hammer에서 태그가 붙은 이벤트를 콘솔에 출력하는 VScript 파일과 함께 만드세요.
- Neocortex 대시보드에서 캐릭터를 설계하세요. PROCTOR-7의 Personality와 Knowledge, 챔버용 Conversation Flow, 퀴즈, 명령 세트를 만듭니다.
- 도우미 앱을 작성하세요.
console.log를 지켜보고,/v3/chat을 호출하고, 음성을 재생하고, 콘솔 포트로 명령을 다시 보냅니다. - API 키는 도우미의 설정 파일에 두세요. 플레이어가 직접 입력하게 하고, 공유하는 빌드에 하드코딩하지 마세요.
- launch 옵션을 설정한 뒤 싱글플레이어에서 테스트하세요. 그다음 맵은 Workshop에, 도우미는 따로 공개하세요.
음성 쪽은 게임 모드를 위한 기기 내 음성 명령 글을 읽어 보세요. Source 엔진 수준의 모드는 Half-Life 2 AI NPC 모드 가이드를, 스크립트에서 API를 직접 호출할 수 있는 Source 게임은 Titanfall 2 AI 모드 가이드를 보세요. 나중에 독립 게임에서도 PROCTOR-7을 쓰고 싶다면, 같은 Neocortex 캐릭터를 유니티 연동으로 사용할 수 있습니다.
도구 버전과 링크는 2026년 10월에 확인했습니다. 모딩 도구는 자주 바뀌므로, 최신 릴리스는 각 프로젝트 페이지에서 확인하세요.
자주 묻는 질문
Portal 2에 AI 캐릭터를 추가할 수 있나요?
네. 작은 도우미 앱을 쓰면 됩니다. Portal 2 맵 스크립트는 인터넷에 접근할 수 없으므로, 맵이 이벤트를 콘솔에 출력하고 로컬 도우미 앱이 이를 AI 캐릭터에게 전달합니다. Neocortex가 캐릭터, 음성, 응답을 제공하고, 도우미가 이를 다시 게임에 보냅니다.
Portal 2 VScript가 HTTP 요청을 할 수 있나요?
아니요. Portal 2의 VScript는 맵 안에서 실행되는 Squirrel이며 네트워크 접근이 없습니다. 일반적인 방법은 이벤트를 콘솔에 기록하고, 도우미 앱이 이를 읽어 Neocortex 같은 웹 API를 호출하게 하는 것입니다.
목소리로 Portal 2 테스트 챔버를 조작할 수 있나요?
네. 도우미 앱은 마이크를 듣고 일치하는 명령을 게임에 보낼 수 있습니다. 플랫폼을 올리거나 큐브를 떨어뜨리는 식입니다. Neocortex Voice Commands는 플레이어의 PC에서 일치 처리를 하므로 오프라인에서도 동작하고 즉시 반응합니다.
Portal 2: Community Edition은 무엇인가요?
Portal 2: Community Edition은 Strata Source 엔진 위에서 커뮤니티가 관리하는 Portal 2 버전입니다. 2026년 4월부터 Steam에서 오픈 베타로 제공되고, Portal 2 소유자에게 무료입니다. AngelScript, Panorama UI, 애드온 시스템을 추가하며, Neocortex용 도우미 앱 패턴도 그곳에서 동작합니다.
AI 테스트 챔버를 Steam Workshop에 공개할 수 있나요?
맵은 평소처럼 Workshop에 공개할 수 있지만, 도우미 앱은 GitHub 등에서 따로 공유해야 합니다. 각 플레이어는 자신의 Neocortex API 키로 도우미를 실행하며, 키는 브라우저 에디터에서 받을 수 있습니다.






