관리형 AI 에이전트 세션 연결 — 도는 중 끼어들기와 두 번 못 여는 주소

서버에서 도는 관리형 에이전트 세션에 내 터미널을 붙이는 명령이 새로 문서에 올라왔습니다. 붙으면 지금까지의 대화 기록을 불러오고, 에이전트가 일하는 동안 실시간으로 따라갑니다.

보기만 하는 게 아닙니다. 메시지를 보내고, 하던 일을 멈춰 세우고, 승인을 기다리는 도구 호출을 허락하거나 거절할 수 있습니다. 「맡겨 놓고 결과만 받는 것」과 「옆에 앉아 지켜보는 것」 사이가 메워진 셈이죠.

📌 30초 요약

• 붙으면 실시간으로 따라갑니다.
• 떼어도 세션은 계속 돕니다.
• 도는 중엔 끼어들기만 됩니다.
• 승인은 세 가지로 답합니다.
• 브라우저 주소는 한 번만 열립니다.

1. 붙고 떼는 법

쓰는 법은 간단합니다. 세션 번호를 넘기면 그걸로 끝이죠. 번호는 세션을 만들 때 받은 응답에서 복사하거나, 목록을 뽑는 명령으로 확인하거나, 관리 화면에서 가져오면 됩니다. 다만 일정 판올림 이상의 명령줄 도구가 필요합니다.

떼는 것도 쉽습니다 — 빠져나오는 키를 누르면 터미널만 떨어집니다. 세션은 그대로 돌고, 다시 붙으면 그동안의 기록을 통째로 불러옵니다. 자리를 비웠다 돌아와도 놓친 대목이 없다는 뜻이죠.

한 가지 제약은 알아 두셔야 합니다. 브라우저로 여는 선택지를 빼면 이 명령은 사람이 앉아 있는 터미널을 요구합니다. 자동화 스크립트 안에서는 안 되고, 대신 이벤트를 흘려보내는 명령과 보내는 명령을 따로 쓰라고 안내합니다. 이름은 비슷해도 폰에서 내 컴퓨터의 세션을 이어 쓰는 원격 조종과는 다른 물건입니다 — 그쪽은 내 기기에서 도는 것에 붙고, 이건 서버에서 도는 것에 붙습니다.

2. 도는 중에 되는 것, 안 되는 것

여기가 헷갈리기 쉬운 자리입니다. 세션이 도는 중에는 손댈 수 없는 것들을 앞서 정리한 적이 있는데, 설정 바꾸기·새 이벤트 막기·통째로 지우기 셋은 쉬는 중일 때만 됩니다. 그런데 이번 명령은 도는 중에 메시지를 보내고 멈춰 세울 수 있다고 하죠. 모순처럼 보이지만 아닙니다.

하려는 일	도는 중에
메시지 보내기	됩니다
하던 일 멈춰 세우기	됩니다
세션 설정 바꾸기	거부됩니다 — 쉬는 중에만
이벤트 막기·삭제	거부됩니다 — 쉬는 중에만

경계가 분명하죠. 대화에 끼어드는 일은 도는 중에 되고, 세션이라는 그릇 자체를 손대는 일은 쉬는 중에만 됩니다. 앞의 것은 사람이 말을 거는 행동이고 뒤의 것은 판을 바꾸는 행동이니, 갈라 두면 외우기 어렵지 않습니다.

화면에는 지금 돌고 있는지, 쉬고 있는지, 내 승인을 기다리는지가 상태 줄로 표시됩니다. 여러 에이전트를 함께 굴리는 세션이라면 터미널 보기는 주 갈래만 따라갑니다 — 조정 역할이 아래 에이전트들과 주고받는 말은 들어오지만, 그 아래에서 갈라진 곁가지까지는 안 보입니다.

3. 승인이 내 앞에 뜰 때

도구 호출이 승인을 기다리면 입력줄이 「이 호출을 허용할까요?」로 바뀝니다. 이게 뜨는 경우는 둘인데, 항상 묻도록 정해 둔 경우이거나, 자동으로 두었는데 서버가 판단을 못 내린 경우입니다. 답은 세 갈래 — 예 / 아니오 / 아니오, 그리고 이유 알려주기. 마지막 것을 고르면 제가 적은 이유가 거절 사유로 에이전트에게 전달됩니다.

이 「이유를 붙여 거절하는」 선택지가 생각보다 쓸모 있습니다. 그냥 막으면 에이전트가 같은 시도를 되풀이하기 쉬운데, 사유가 붙으면 방향을 틀 수 있으니까요. 하위 에이전트의 승인이 세션 전체로 번지던 문제와 견주면, 이쪽은 호출 하나하나에 답하는 구조라 범위가 새어 나갈 걱정이 적습니다.

누르는 키	하는 일
엔터	입력을 보냄 — 줄바꿈은 따로
빠져나오기	돌고 있는 일을 중단
상세 토글	도구 입출력·토큰 사용량을 폈다 접었다
위아래 넘기기	올리면 따라가기가 멈춤 — 맨 끝으로 가면 재개

넷째 줄은 실수하기 쉬운 대목입니다. 기록을 위로 올려 읽는 순간 실시간 따라가기가 멈춥니다. 한참 읽다가 「왜 아무 일도 안 일어나지」 싶으면 맨 끝으로 내려오시면 다시 흘러갑니다. 참고로 세션이 이미 끝났거나 지워졌다면 화면은 읽기 전용이 됩니다.

4. 브라우저로 열 때

웹으로 보는 선택지를 붙이면 내 컴퓨터 안에서 작은 서버를 띄워 관리 화면의 세션 뷰어를 내보냅니다. 주소를 찍어 주고 브라우저까지 열어 주는데, 열지 않게 하는 선택지도 따로 있습니다. 브라우저에서도 메시지 보내기·중단·승인이 다 됩니다. 게다가 터미널 보기와 달리 여러 에이전트 세션의 모든 갈래를 따라갑니다 — 곁가지까지 봐야 한다면 이쪽이 낫죠.

⚠️ 주소는 2분 안에 한 번만 열립니다

찍혀 나온 주소는 출력된 지 2분 안에, 그것도 한 번만 열 수 있습니다. 연 탭을 새로고침하는 건 되지만, 다른 데서 다시 열려면 명령을 처음부터 돌려야 합니다. 주소를 복사해 두었다가 나중에 쓰거나, 다른 기기로 보내 여는 식은 통하지 않는다는 뜻이죠. 대신 이 제약 덕에 주소가 새어 나가도 오래 쓸 수 없습니다. 서버는 제가 끌 때까지 떠 있습니다.

보안 쪽 설계도 한 줄 짚어 둘 만합니다. 자격 증명은 명령줄 도구 밖으로 나가지 않습니다. 브라우저 화면은 내 컴퓨터에서 도는 그 프로세스에만 요청을 보내고, 실제 서버 호출은 그 프로세스가 대신 합니다. 열쇠가 브라우저 탭에 실려 다니지 않는 구조죠. 환경 변수가 로그인을 조용히 덮어쓰는 경우만 함께 조심하시면 됩니다.

자주 묻는 질문 (FAQ)

Q. 터미널을 닫으면 에이전트도 멈추나요

아닙니다. 터미널만 떨어지고 세션은 서버에서 계속 돕니다. 나중에 다시 붙으면 그사이 기록까지 전부 불러오니, 잠깐 자리를 비우셔도 됩니다.

Q. 스크립트 안에서 쓰고 싶습니다

이 명령은 사람이 앉아 있는 터미널을 요구합니다. 자동화에는 이벤트를 흘려보내는 명령과 보내는 명령을 따로 쓰라고 문서가 안내합니다. 브라우저로 여는 선택지를 붙이면 이 제약은 적용되지 않습니다.

Q. 화면이 갱신되다가 멈췄습니다

기록을 위로 올려 읽으면 따라가기가 멈춥니다. 맨 끝으로 내려오면 다시 흘러갑니다. 세션이 끝났거나 지워진 경우라면 화면 자체가 읽기 전용이 됩니다.

Q. 브라우저 주소를 동료에게 보내도 되나요

사실상 안 됩니다. 출력 후 2분 안에 한 번만 열리고, 게다가 제 컴퓨터 안에서만 도는 주소입니다. 다른 곳에서 보려면 그쪽에서 명령을 직접 돌려야 합니다.

정리하면

• 붙으면 기록째로 따라갑니다.
• 떼어도 계속 돕니다.
• 끼어들기는 되고 판 바꾸기는 안 됩니다.
• 거절에 이유를 붙이세요.
• 웹은 모든 갈래를 봅니다.
• 주소는 한 번뿐입니다.

※ 2026년 9월 17일 문서 색인에 새로 올라온 공식 문서를 읽고 정리했습니다. 명령 이름과 옵션은 우리말로 풀어 적었으니 실제 표기는 원문에서 확인하세요.

※ 이 기능에는 최소 판올림 조건이 붙어 있고, 관리형 에이전트는 아직 베타 단계로 소개돼 있습니다. 동작이 바뀔 수 있으니 원문과 대조해 확인하세요.