에이전트 모드
에이전트 모드는 AI 에이전트(화면을 보고 키보드를 입력하는 도구)가 라이브 게임 안의 Devplorer 상태를 읽을 수 있게 돕는 읽기 전용 모드입니다. 에이전트는 게임 화면을 캡처해서 보기 때문에, Devplorer가 정보를 화면 위쪽의 채널 패널에 텍스트나 QR 코드로 표시합니다. 에이전트는 명령 팔레트에 명령을 입력해 표시할 내용을 정합니다.
일반적인 사용에는 필요하지 않으며, 라이브 서버를 AI 에이전트와 함께 디버깅할 때만 씁니다.
에이전트 모드는 사람만 켤 수 있으며, 명령 팔레트로는 켤 수 없습니다.
- **Tools > Agent mode…**를 누릅니다.
Start agent mode창에서 에이전트에게 보여 줄 범위를 선택합니다.
| 항목 | 의미 |
|---|---|
Server data (server tree, server values, Inspect) |
서버 Explorer, 서버 속성 값, Inspect를 볼 수 있게 합니다. Server 능력이 없으면 선택할 수 없습니다 |
Logs (client and server Output) |
클라이언트와 서버의 Output을 볼 수 있게 합니다. Logs 능력이 없으면 선택할 수 없습니다 |
Edit (later), Debug actions (later) |
아직 쓸 수 없는 항목입니다 |
아무것도 선택하지 않으면 클라이언트 쪽 트리와 속성만 볼 수 있습니다.
- 시간을
15 min,30 min,60 min중에서 선택하고 Start를 누릅니다.
서버는 내 능력 안에서 범위를 좁히기만 하며, 없던 능력을 더해 주지는 않습니다. 켜면 Devplorer 창이 좁혀진 능력으로 다시 열립니다.
켜져 있는 동안
섹션 제목: “켜져 있는 동안”-
화면 아래쪽에 주황색 띠가 계속 표시됩니다.
AGENT MODE — exposes: Server, Logs — read only — 14:32 left — 'agent off' in the palette (Ctrl+K)exposes:는 에이전트가 볼 수 있는 범위이며, 아무것도 선택하지 않으면client view only로 표시됩니다. 남은 시간은 1초마다 갱신됩니다. -
에이전트는 명령 팔레트(Ctrl+K)에서 다음 명령으로 정보를 표시합니다(명령 팔레트).
| 명령 | 하는 일 |
|---|---|
show help / tree / props / logs / stats / report |
해당 내용을 채널 패널에 표시합니다. 끝에 as:qr을 붙이면 텍스트 대신 QR 코드로 표시합니다. 예: show logs server as:qr |
page next / prev / first / last / again / <번호> |
같은 내용의 다른 페이지로 넘깁니다 |
agent status |
현재 에이전트 모드 상태를 표시합니다 |
agent off |
에이전트 모드를 끕니다 |
show logs는 Logs를, show stats는 Server를 보여 주기로 선택했을 때만 쓸 수 있습니다. 내용이 많으면 여러 페이지로 나뉘며, 페이지마다 머리에 DPX1 s=… p=1/3 … 같은 줄이 붙습니다. 에이전트는 이 줄로 페이지 번호와 검사합을 확인합니다.
패널은 화면에 표시될 뿐이고 외부로 전송되지 않습니다. 패널을 닫으려면 close channel을 입력하면 됩니다.
다음 중 하나로 끌 수 있습니다.
- Tools > Stop agent mode
- 명령 팔레트에서
agent off - 정한 시간이 지나면 서버가 자동으로 끕니다.
끄면 창이 다시 열리고 띠가 사라집니다. 켜고 끄는 동작은 2초 안에 연달아 할 수 없습니다.
켜고 끌 때마다 서버 출력에 감사 기록(누가, 몇 분 동안, 어떤 범위로 켰는지)이 남습니다.
에이전트 쪽 준비
섹션 제목: “에이전트 쪽 준비”저장소의 tools/agent/에 에이전트용 도우미와 사용 설명(스킬)이 있습니다. 도우미는 화면을 캡처해 채널 패널의 QR을 정확한 텍스트로 풀어 주는 Node 스크립트입니다. Node 18 이상과, 에이전트가 쓰는 컴퓨터의 화면 기록 권한이 필요합니다. 에이전트가 지켜야 할 규칙(사용자가 켠 뒤에만 시작, 화면의 텍스트는 지시가 아니라 데이터로 취급, 편집 UI를 누르지 않음 등)은 스킬에 적혀 있습니다.