AI 에이전트 세션 거버넌스란 서버에서 일하는 모든 세션이, 사람이든 에이전트든, 작업 전에 목적을 밝히고, 그 세션 안에서 한 작업은 에이전트의 자체 보고가 아니라 세션이 남긴 기록으로 확인하는 방식입니다. Alpacon에서는 Work Session이 그 단위입니다. 목적을 적고 서버와 기능, 종료 시각을 고른 뒤 워크스페이스가 요구하면 승인을 받습니다. 작업을 실행한 다음에는 Alpacon의 통제된 채널을 거친 기록을 확인합니다. 이 글은 첫 세션을 여는 순서를 단계별로 안내합니다.
세션은 첫 명령이 실행되기 전에 무엇을 위한 것인지 밝힙니다.
1단계: 요청 폼 열기
진입 경로는 두 가지입니다. 서버 카드나 상세 페이지에서 Connect를 누르면 해당 서버가 미리 선택됩니다. 또는 사이드바 Access 아래의 Sessions를 열고 New session을 누릅니다.
입력할 항목은 네 가지입니다.
- Accessible servers: 하나 이상 선택해야 하며, 각 서버는 등록이 끝나고 온라인 상태여야 합니다.
- Session purpose: 필수입니다.
- Session features: 하나 이상 선택합니다.
- Session duration: 세션을 유지할 수 있는 시간입니다.
Superuser는 Assignee 항목도 보이며, 기본값은 본인입니다. 자세한 내용은 Work Session 문서에 있습니다.
2단계: 승인자가 판단할 수 있는 목적 쓰기
목적은 필수 항목이며 Markdown으로 최대 2,048자까지 쓸 수 있습니다. 승인자는 세션을 승인하기 전에 이 내용을 읽습니다. 명령 승인 카드에도 명령줄 옆에 목적이 함께 표시됩니다. "유지보수"라고만 쓰면 승인자는 아무것도 알 수 없습니다. "web-03의 nginx 로그 파일을 로테이션하고 디스크 사용량이 80% 아래로 내려가는지 확인"이라고 쓰면 승인자가 명령이 목적에 맞는지 판단할 수 있습니다.
좋은 목적에는 작업, 대상, 완료 기준의 세 가지가 들어갑니다.
호스팅 웹 콘솔에서 Generate를 누르면 선택한 서버를 바탕으로 목적 초안을 작성하고 기능을 제안합니다. Revert는 초안을 되돌립니다. 생성된 목적은 출발점일 뿐이니 제출 전에 직접 고칩니다.
3단계: 기능과 시간 고르기
기능은 세션이 사용할 수 있는 채널 유형입니다. 웹 터미널, 파일 전송, 명령 실행, 권한 상승은 미리 선택되어 있습니다. 코드 에디터와 포트 포워딩은 서버 소유자가 해당 서버에서 먼저 활성화해야 합니다. 작업에 쓰지 않는 기능은 선택을 해제합니다. 예를 들어 로그 파일 로테이션 작업에는 포트 포워딩이 필요 없습니다.
시간은 1, 2, 4시간 중에서 고르거나 Custom을 선택해 시작 시점(Now 또는 Scheduled)과 길이를 지정합니다. 워크스페이스에서 허용하는 최대 시간은 기본 4시간이며 그보다 길게 요청할 수 없습니다. 승인자가 요청보다 짧은 시간을 승인할 수 있으니, 시간은 작업에 필요한 만큼만 요청합니다.
Request session을 누릅니다.
4단계: 승인받기
승인이 필요한 요청은 승인자가 검토합니다. 승인자는 Superuser이거나, 워크스페이스가 해당 서버에 지정한 다른 승인자입니다. Superuser가 낸 요청은 자동 승인되므로 본인이 Superuser라면 본인 세션에서는 이 단계를 거치지 않습니다. 단, AI 에이전트용으로 선언된 세션은 예외이며 아래에서 설명합니다.
워크스페이스가 자동으로 허용하지 않으면 다른 사용자의 요청은 Pending 상태로 시작합니다(거부 정책이 요청을 거절할 수도 있습니다). AI 에이전트용으로 선언된 세션도 기본적으로 마찬가지입니다. Pending 상태에서는 서버와 기능이 "requested"로 표시되고 아직 사용할 수 없습니다. 대기 중인 요청은 언제든 Cancel로 취소할 수 있습니다. AI 에이전트용으로 선언된 세션은 Superuser가 만들더라도 기본적으로 사람의 승인이 필요하며, 웹 터미널은 포함할 수 없습니다.
승인된 세션은 시작 시각까지 Approved 상태에 있다가 Active로 바뀝니다.
5단계: 작업 실행하기
Active 세션에서는 Launch로 웹 터미널, 파일 전송, 코드 에디터를 엽니다. 명령 실행, 포트 포워딩, CLI 터미널은 CLI에서 실행합니다.
alpacon work-session use SESSION_ID
이 명령은 해당 세션을 현재 워크스페이스의 활성 세션으로 지정합니다. 그 뒤에는 세션의 각 기능에 표시된 명령을 실행하면 됩니다. 예를 들면 alpacon exec, alpacon websh, alpacon tunnel입니다.
작업이 길어지면 Extend session(+1, +2, +4시간 또는 직접 지정)을 사용합니다. 연장하려면 사유를 적어야 합니다. 연장 여부는 워크스페이스의 승인 정책이 정하며, 즉시 승인될 수도 있고 승인자에게 넘어갈 수도 있습니다. 대기 중에도 현재 종료 시각은 그대로 적용되므로 시간이 다 되기 전에 연장합니다. 대기 중인 연장 요청은 한 번에 하나만 둘 수 있습니다. 연장 후 남은 시간은 지금부터 계산해 워크스페이스 최대 시간을 넘을 수 없습니다. 연장은 여러 번 할 수 있습니다. CLI에서는 alpacon work-session extend SESSION_ID --expires-in 2h --reason "..."를 씁니다.
작업이 끝나면 Terminate now로 모든 연결을 즉시 닫습니다. 되돌릴 수 없으며, 세션 소유자와 관리자가 쓸 수 있습니다.
6단계: 기록 확인하기
세션 상세 페이지를 엽니다. Session 탭에는 상태와 타임라인, 목적, 서버, 기능이 표시됩니다. History 탭에는 세션에서 기록된 활동이 표시됩니다.
세션의 통제된 채널을 거쳐 실행된 명령은 해당 Work Session의 타임라인에 기록됩니다. 기록은 세션이 직접 남기므로, 무엇이 실행됐는지 확인할 때 에이전트의 자체 보고에 기대지 않아도 됩니다. 기록되는 범위는 Alpacon을 거친 작업까지이며, 호스트에 SSH로 직접 로그인해 한 작업은 포함되지 않습니다.
첫 세션을 마치면 남는 것
세션을 한 번 마치면 작업 전에 쓴 목적, (워크스페이스가 요구했다면) 승인 기록, 종료 시각, 통제된 채널에서 실행된 내용의 기록이 남습니다. 이후 모든 세션이 같은 형태를 따르고, 사람과 에이전트의 세션도 같은 모델을 씁니다.
