에이전트 협업

에이전트 협업(A2A, agent-to-agent)은 서로 다른 컴퓨터의 에이전트가 함께 일하게 해 주는 기능입니다. 내 세션 하나에 이름과 설명을 붙여 “에이전트”로 공유하면, 상대가 자기 TokenWork에 추가해 그쪽 에이전트가 질문이나 작업을 보낼 수 있습니다. 답변은 상대의 대화로 돌아갑니다.

예를 들어 프론트엔드 코드를 잘 아는 세션이 있다고 해 봅시다. 이 세션을 “프론트엔드 리뷰어”로 공유하면, 동료의 에이전트가 내 프로젝트를 열지 않고도 변경 사항 검토를 맡길 수 있습니다.

시작하기 전에

세션을 공유하는 컴퓨터에서 다음을 설정합니다.

설정 → 에이전트 협업을 엽니다.
일반에서 페어링된 피어의 에이전트 요청 수락을 켭니다.

켜져 있는 동안 헤더에 A2A 켜짐이 표시됩니다. 이 설정을 끄면 다시 켤 때까지 내가 공유한 링크가 모두 동작하지 않습니다. 다른 사람이 내 세션에 닿으려면 이 컴퓨터에서 TokenWork가 실행 중이어야 합니다.

공유받은 세션을 쓰려면 TokenWork 데스크톱 앱이 필요합니다.

세션 공유하기

공유할 세션을 엽니다.
메시지 입력창 아래의 공유 버튼(이 세션 공유하기)을 누릅니다.
에이전트 이름과 에이전트 설명을 입력합니다. 상대는 연결하기 전에 이 둘을 보고, 상대의 에이전트도 이를 보고 언제 내 에이전트에 물을지 정합니다. AI로 생성을 누르면 대화 내용으로 초안을 만들어 줍니다.
수신자에게 허용할 작업에서 하나를 고릅니다.
- 읽기 전용(기본값): 에이전트가 이 컴퓨터를 읽고 검색할 수 있습니다. 파일 쓰기, 편집, 셸 명령은 거부됩니다.
- 전체 권한: 상대의 요청으로 이 컴퓨터에서 파일을 쓰고 셸 명령을 실행할 수 있습니다. 믿을 수 있는 사람에게만 주세요.
링크 생성을 누릅니다.

tokenwork://share로 시작하는 링크가 클립보드에 복사됩니다. 이 링크를 상대에게 보내세요. 창을 닫으면 링크를 다시 볼 수 없으니 지금 복사해 두세요. 링크는 비밀번호와 같습니다. 회수하기 전까지 링크를 가진 누구든 이 세션을 쓸 수 있습니다.

상대가 내 컴퓨터에 연결하는 방법

링크에는 지금 이 컴퓨터에 연결할 수 있는 방법이 모두 들어갑니다. 상대의 앱은 이 방법들을 시도해 가장 먼저 응답한 쪽으로 연결합니다.

Private Relay: TokenWork 릴레이를 거치는 암호화 연결입니다. 설정 없이 어디서든 연결되고, 모든 링크에 항상 들어갑니다.
LAN: 가장 빠르지만 같은 네트워크에 있는 사람만 쓸 수 있습니다. 네트워크 설정에서 LAN 액세스를 먼저 켜야 하고, UI 비밀번호가 필요합니다.
터널: Cloudflare나 ngrok가 주는 공개 주소입니다. quick 터널은 시작할 때마다 주소가 바뀌므로 다시 켠 뒤에는 링크를 새로 만드세요.

창에 “이 인스턴스는 다른 기기에서 접근할 수 없습니다”가 나오면 터널을 시작하거나 LAN 액세스를 켠 뒤 링크를 갱신하세요. 터널과 프라이빗 릴레이를 참고하세요.

공유한 세션 관리하기

설정 → 에이전트 협업 → 공유한 세션으로 갑니다. 공유한 세션마다 다음 작업을 할 수 있습니다.

수정: 에이전트 이름과 설명을 바꿉니다. 상대는 다음에 공유 세션 목록을 열 때 바뀐 내용을 봅니다.
갱신: 링크를 새로 바꿉니다. 이전 링크는 바로 멈춥니다. 아직 필요한 사람에게 새 링크를 보내세요.
회수: 공유를 끝냅니다. 되돌릴 수 없습니다. 다시 공유하려면 새 링크를 만드세요.

공유받은 세션 추가하기

받은 tokenwork://share 링크를 누릅니다. TokenWork가 링크를 엽니다. 설정 → 에이전트 협업 → 나에게 공유된 세션에 링크를 붙여넣고 추가를 눌러도 됩니다.
이 공유 에이전트에 연결할까요? 창에서 에이전트 이름과 설명을 확인합니다. 이름이나 설명이 없는 링크라면 보낸 사람에게 먼저 확인하세요.
내 AI에 연결하기를 누릅니다.

세션이 나에게 공유된 세션에 연결 상태와 함께 나타납니다.

준비됨: 작업을 보낼 수 있습니다.
상대에서 꺼짐: 상대가 에이전트 요청 수락을 껐습니다.
토큰 거부됨: 링크가 갱신되었거나 회수되었습니다. 상대에게 새 링크를 요청하세요.
연결할 수 없음: 지금은 상대 컴퓨터에 닿지 않습니다. TokenWork가 몇 번 다시 시도합니다.

공유받은 세션에 작업 보내기

방법은 두 가지입니다.

직접 /a2a 입력하기. 메시지 입력창에 /a2a를 입력하고 목록에서 공유받은 세션을 고른 뒤 메시지를 씁니다.

/a2a @frontend-reviewer 이 훅이 너무 자주 다시 렌더링되는지 확인해 줘.

에이전트에게 맡기기. “프론트엔드 리뷰어에게 확인해 달라고 해”처럼 공유 에이전트를 언급하면 내 에이전트가 직접 요청을 보낼 수 있습니다. 이 동작은 에이전트 A2A 위임 설정을 따릅니다. 에이전트가 위임을 전혀 하지 않는다면 이 설정이 켜져 있는지 확인하고 OpenCode를 다시 시작하세요.

요청은 대화에 카드로 표시되고, 답이 오면 {이름}의 위임 답변이 나옵니다. 답변은 다음 메시지에 포함됩니다. 그래서 내 에이전트가 바로 이어서 쓸 수 있습니다. 요청이 진행 중일 때 대기 중단을 누르면 상대 컴퓨터의 작업도 멈춥니다. 끝난 카드는 숨기기로 치울 수 있습니다.

이런 상태도 볼 수 있습니다.

호스트 승인 대기 중 또는 호스트 답변 대기 중: 상대 에이전트가 소유자의 권한 승인이나 질문 답변을 기다리고 있습니다. 내가 대신 승인할 수는 없습니다. 상대가 응답하면 작업이 이어집니다.
상대에서 계속 실행 중: 내 에이전트는 5분쯤 기다린 뒤 대기를 멈췄지만, 상대 쪽 작업은 계속됩니다. 답이 오면 카드에 응답 도착이 표시되고, 다음 메시지를 보낼 때 함께 들어갑니다.

공유 세션 하나는 내 요청을 한 번에 하나만 받습니다. 답을 받은 뒤 다음 요청을 보내세요.

소유자에게 보이는 것

공유받은 사람마다 소유자 컴퓨터에 공유 세션의 사본이 따로 생깁니다. 그래서 두 사람이 같은 대화에 섞여 쓰는 일은 없습니다. 사본의 제목과 헤더에 요청한 사람이 표시됩니다. 그 작업에 권한 승인이나 답변이 필요하면 소유자는 해당 세션에서 평소처럼 확인 창을 받습니다.