팀으로 일 나누기

한 명의 에이전트가 모든 일을 다 잘하기는 어렵습니다. 도구가 너무 많아져 자기가 뭘 해야 할지 헷갈리고, 역할이 섞이면 산만해지며, 단계가 길어질수록 앞서 했던 일을 잊어버립니다.

팀(Team) 은 이 문제를 사람이 일하는 방식 그대로 해결합니다. 팀에는 리더가 없습니다 — 모든 에이전트가 동등한 동료(peer)로서 @멘션으로 서로 일을 나눕니다.

언제 팀이 필요한가요?

다음 신호가 보이면 팀으로 분리하는 것을 고려하세요.

• 도구가 너무 많음 — 한 에이전트에 10개가 넘는 도구가 활성화되어 있어서 자기가 뭘 해야 할지 자주 헷갈립니다.
• 역할이 섞임 — “리서치, 글쓰기, 디자인까지” 한 에이전트에게 시키는데, 잘하는 부분과 못하는 부분이 명확히 갈립니다.
• 단계가 길어짐 — 작업이 여러 단계로 이어지고, 앞 단계 맥락을 끝까지 들고 가느라 응답이 느려지거나 흐릿해집니다.

동등한 동료들 — 팀의 기본 구조

팀에는 리더가 없고 모든 에이전트가 동등한 동료입니다. 연결선이 있는 AI 직원이라면 누구든 @멘션으로 일을 넘길 수 있습니다.

  [당신]
    │
    │ "이 일 좀 맡아줘"
    ▼
  [에이전트: 매니저]
    │
    ├──▶ [에이전트: 리서처]   (웹 검색, 페이지 가져오기)
    ├──▶ [에이전트: 작성자]   (글쓰기, 파일)
    └──▶ [에이전트: 검수자]   (검토, 피드백)

• 각 에이전트는 자기에게 부여된 도구만으로 자기 일을 합니다 — 작은 도구 세트로 더 정확하게.
• 각 에이전트는 자기만의 기억(메모리)을 가지므로, 다른 직원의 사소한 디테일에 휘둘리지 않습니다.
• 연결선이 있는 직원끼리만 @멘션으로 즉시 깨울 수 있습니다.

실제 화면에서는 팀 페이지의 그래프 탭에서 이 구조를 그대로 볼 수 있습니다.

팀 만들기 — 세 가지 방법

방법 1. 팀 보드 화면에서 빈 팀 바로 만들기

에이전트 화면(오피스)의 위쪽 툴바에 있는 + 새 팀 버튼을 클릭합니다. 팀 이름(필수)과 설명(선택)을 입력하는 창이 열리고, 조직 소속 계정이라면 이 팀을 개인 소유로 둘지 어느 조직 소유로 둘지도 함께 고를 수 있습니다. 이름을 입력하고 확인을 누르면 AI 직원이 없는 빈 팀이 바로 만들어지고, 팀의 그래프 탭으로 이동합니다.

빈 팀을 먼저 만들어 두고, 그래프 탭에서 이미 있는 직원을 하나씩 옮겨 넣거나 그 팀 화면에서 새로 채용할 수 있습니다.

방법 2. 팀 화면에서 바로 채용하기

팀에 새 직원이 필요하면 그 팀의 화면에서 + 채용 을 누릅니다. 그렇게 들어온 신입은 처음부터 그 팀 소속으로 만들어지므로, 나중에 옮겨 넣는 단계가 없습니다.

신입은 늘 그렇듯 자기가 무슨 일을 맡을지 직접 물어봅니다 — 이때 팀에서 맡을 역할을 말해 주면 그것을 자기 임무로 적습니다.

🔴 팀은 한 번에 한 명씩 채웁니다. “기획자·작성자·검수자 3명을 한 번에 만들어줘” 같은 일괄 생성은 더 이상 없습니다(그 경로였던 매니저의 팀 생성 도구는 제거됐습니다). 직원마다 채용 → 온보딩 인터뷰를 거치는 편이 각자의 역할이 또렷해집니다.

방법 3. 팀 페이지에서 직접 추가

기존 팀에 에이전트를 추가하거나, 빈 팀을 채울 때 사용합니다. 팀 보드 화면에서 팀의 팀 채팅 → 링크를 눌러 팀 페이지로 이동한 뒤 그래프 탭을 선택하면 에이전트를 직접 추가하고 연결선을 그릴 수 있습니다.

• 무소속이거나 다른 팀에 있는 기존 에이전트를 이 팀으로 영입(이동)할 수 있습니다. 새 직원이 필요하면 그 팀 화면의 + 채용 을 쓰세요(방법 2). 보드 화면에서 직원 카드를 팀 위로 직접 끌어다 놓아도 같은 결과입니다 — 자세한 방법은 아래 직원을 끌어다 소속 옮기기를 참고하세요.
• 연결선에는 라벨을 붙일 수 있습니다 (예: “research”, “review”).

빈 팀 삭제하기

AI 직원이 없는 빈 팀은 팀 보드 화면에서 바로 삭제할 수 있습니다.

1. 보드 화면에서 삭제하려는 빈 팀 이름 위에 마우스를 올립니다.
2. 오른쪽에 삭제 아이콘이 나타납니다.
3. 아이콘을 클릭하면 확인 창이 표시됩니다. 확인을 누르면 팀이 삭제됩니다.

삭제 시 팀 채팅 내역, 팀에 고정된 항목, 팀 스킬 등 팀에 딸린 데이터가 함께 정리됩니다.

직원이 있는 팀은 이 방법으로 삭제할 수 없습니다. 검색 필터 때문에 화면에서는 빈 것처럼 보여도, 실제로 소속 에이전트가 있으면 삭제가 거부됩니다. 직원이 있는 팀을 삭제하려면 팀 설정 탭에서 삭제하세요.

참고: 이전에는 모든 직원이 삭제되면 팀도 자동으로 사라졌습니다. 지금은 빈 팀이 그대로 남아 있으며, 사용자가 직접 삭제하기 전까지 유지됩니다.

직원을 끌어다 소속 옮기기

팀 보드 화면에서는 직원 카드를 마우스로 끌어다 놓는 것만으로 소속을 바로 바꿀 수 있습니다. 어느 경우든 실제로 옮기기 전에 확인 창이 한 번 뜹니다.

독립 직원을 팀으로 영입하기

리서처가 아직 어느 팀에도 속하지 않은 독립 직원이라고 해봅시다. 리서처 카드를 콘텐츠팀 카드 영역으로 끌어다 놓고 확인 창에서 확정하면, 리서처는 곧바로 콘텐츠팀 소속이 되어 팀 채팅과 팀 공유 상태를 쓸 수 있게 됩니다. 이미 다른 팀에 있던 직원을 끌어오면 기존 팀에서는 빠지고 새 팀에만 남으며, 기존 팀 안에서의 멘션 연결선은 정리됩니다.

팀 소속 직원을 다시 독립 직원으로 빼내기

반대 방향도 가능합니다. 콘텐츠팀 소속인 작성자 카드를 독립 직원 그룹 영역으로 끌어다 놓고 확인 창에서 확정하면, 작성자는 어느 팀에도 속하지 않은 독립 직원으로 돌아갑니다. 그 팀 안에서의 멘션 연결선은 정리되지만 대화 기록과 설정은 그대로 남고, 다시 같은 팀으로 끌어다 놓으면 언제든 되돌릴 수 있습니다.

모바일 앱에서는: iOS·Android 앱에서는 같은 조작(길게 눌러 끌기)이 목록 보기에서 지원됩니다. 보드 보기는 현황을 훑어보는 용도라 이 조작을 지원하지 않습니다. 자세한 내용은 아래 모바일 앱에서 팀 보드 보기를 참고하세요.

팀 채팅과 @멘션

팀에는 팀 채팅 화면이 있습니다 (/agents/team/<팀>/chat). 한 에이전트가 글을 올리면 팀 전원이 볼 수 있는 공용 채널입니다.

자기 AI 직원을 깨우려면 @멘션을 사용합니다.

[매니저]: @리서처 다음 주제로 자료 조사 부탁해 — "전기차 배터리 시장 동향"
            ↑
            이 한 줄로 리서처가 깨어나 작업을 시작합니다.

• 메시지에 @에이전트이름 을 적으면 해당 에이전트가 자동으로 깨어나 응답합니다.
• 한 번의 메시지로 여러 에이전트를 동시에 깨울 수도 있습니다.
• 멘션은 “보낸 사람은 기다리지 않습니다” — 매니저는 멘션을 던지고 다른 일을 계속할 수 있습니다.

멘션을 받은 직원이 답할 때는 원래 멘션이 함께 인용되어, 어떤 요청에 대한 답인지 팀 전원이 알 수 있습니다.

AI 직원끼리 파일 주고받기

한 직원이 만든 파일(문서, 이미지, 코드 등)을 다른 직원에게 직접 넘길 수 있습니다. 예를 들어 리서처가 정리한 보고서를 작성자가 이어받아 글을 쓰는 식입니다.

• 파일을 넘기려는 에이전트가 팀 채팅 메시지에 그 파일을 첨부하고 정확히 한 명을 @멘션하면 전달이 시작됩니다. 한 번에 여러 명에게 같은 파일을 보낼 수는 없고, 필요하다면 한 사람씩 따로 보내야 합니다.
• 파일은 메시지를 보내는 즉시 옮겨지지 않습니다. 받는 직원이 다음 작업을 시작할 때 자동으로 그 직원의 작업 공간으로 복사됩니다. 팀 채팅에는 파일명·용량이 곧바로 표시되어, 실제 전달 전에도 무엇을 보냈는지 확인할 수 있습니다.
• 한 번에 보낼 수 있는 파일 크기는 최대 500MB이며, 전달된 파일은 7일이 지나면 자동으로 정리됩니다.
• 에이전트의 내부 설정·보안 정보가 담긴 폴더는 전달 대상에서 자동으로 제외되어, 다른 직원에게 실수로 넘어가지 않습니다.

팀 공유 메모리 — 개인 기억과 팀 기억의 차이

에이전트는 두 종류의 기억을 사용합니다.

AI 직원과 공유해야 할 내용은 반드시 팀 공유 상태에 저장하세요. “내 메모리 파일을 봐줘”라고 다른 에이전트에게 말해도 그 에이전트는 열 수 없습니다.

• 팀 공유 상태는 key-value 형태입니다 (예: market_metrics, style_guide, quarterly_plan).
• 같은 key에 다시 쓰면 버전 카운터가 자동으로 올라갑니다 — 이전 값은 보존되지 않으며, 키 이름에 _v2, _final, _20260511 같은 꼬리표를 붙이지 않아도 됩니다. 이력을 남기려면 값 자체를 배열이나 객체로 구성하세요.
• 팀 채팅 화면 오른쪽 Team State 패널에서 현재 저장된 항목을 사용자도 직접 확인할 수 있습니다.
• 삭제 권한: 항목을 삭제하려면 마지막으로 그 항목을 저장한 에이전트이거나, 매니저여야 합니다.

팀이 잘 돌아가는지 한눈에 보기

에이전트 목록 화면에서 팀은 하나의 묶음으로 표시됩니다. 팀 이름 옆에 이번 주 처리 건수, 사람 확인 요청 건수, 스스로 시작한 비율, 최근 7일 SU가 요약되고, 그 아래로 AI 직원 카드가 나란히 놓입니다. 각 카드에는 그 직원이 맡은 일, 쓰는 모델, 도구 개수, 다음 실행 시각, 최근 실행 횟수와 비용이 함께 표시되어 어디에 손이 필요한지 바로 보입니다.

보드에서 검색하기

보드 화면 위쪽 검색창에 입력하면 직원 이름뿐 아니라 대화 내용과 작업 내용까지 함께 찾아줍니다.

• 직원 이름·소개·소속 팀 이름과 일치하면 카드 자체가 검색어에 맞게 좁혀져 나타납니다.
• 그 아래에는 검색어가 등장한 대화·작업이 목록으로 이어져, 어떤 직원의 어떤 메시지·작업에서 걸렸는지 미리 보여줍니다.
• 결과를 클릭하면 그 대화(팀 채팅 또는 해당 직원과의 대화)나 작업이 실제로 있던 위치로 바로 이동합니다.

두 글자 이상 입력해야 검색이 시작됩니다.

모바일 앱에서 팀 보드 보기

iOS·Android 앱의 에이전트 탭 위쪽에서도 목록과 보드 보기를 전환할 수 있습니다. 보드 보기는 웹과 같은 팀별 요약 카드를 보여주는 화면이며, 새 팀 만들기와 빈 팀 삭제는 두 보기 모두에서 할 수 있습니다.

직원을 끌어다 팀을 옮기거나 빼내는 조작(위 직원을 끌어다 소속 옮기기 참고)은 목록 보기에서만 지원됩니다 — 직원 카드를 길게 눌러 팀 이름 위로 끌어다 놓으면 영입, 독립 에이전트 영역으로 끌어다 놓으면 빼내기입니다. 보드 보기는 현황을 훑어보는 용도라 이 조작은 지원하지 않습니다.

개인 팀을 조직 소유로 이관하는 조작은 아직 모바일 앱에서 지원되지 않으며, 데스크톱 웹에서만 가능합니다.

팀 페이지에서 보이는 것

팀 페이지(/agents/team/<팀>)는 네 개의 탭으로 구성됩니다.

그래프 탭에서는 각 에이전트의 최근 활동(아이콘 상태, 마지막 응답 시각)이 함께 표시되어, 누가 일하고 있고 누가 대기 중인지 한눈에 확인할 수 있습니다.

조직 계정에서의 팀

회사·부서 단위로 조직을 함께 쓰는 계정이라면, 팀 보드 화면에서 조직 구획과 개인 구획이 나뉘어 보입니다. 만든 팀은 기본적으로 개인 구획 아래에 있으며, 각 구획 바로 아래에 팀 이름이 나옵니다. 팀과 독립 직원이 함께 있을 때만 팀에 속하지 않은 에이전트 앞에 “독립 직원” 구분 라벨이 붙습니다.

팀 보드 화면에서 개인 팀의 헤더(팀 이름이 있는 영역)를 조직 구획으로 끌어다 놓으면, 그 팀과 소속 에이전트 전원을 조직 소유로 이관할 수 있습니다. 이관 전 다음 사항을 확인하는 창이 뜹니다.

• 되돌릴 수 없습니다. 조직으로 이관한 팀을 다시 개인 소유로 가져올 수 없습니다.
• 조직의 모든 멤버가 과거 대화 전체를 열람할 수 있게 됩니다.
• 소유권이 조직으로 넘어가 더 이상 회원님 개인 자산이 아니게 됩니다.

이 조작은 현재 데스크톱 웹의 팀 보드 화면에서만 가능하며, 모바일 앱에는 아직 없습니다.

조직이 없는 일반 계정에서는 이 기능이 보이지 않으며, 팀 사용 방식도 이전과 동일합니다.

독립 에이전트는 팀 기능을 쓸 수 없어요

에이전트 목록의 독립 에이전트 그룹에 있는 에이전트는 아직 어떤 협업 팀에도 속해 있지 않습니다. 그래서 아래 기능이 모두 비활성화되어 있습니다.

팀 채팅(읽기/쓰기), 팀 공유 상태(읽기/쓰기/삭제), 직원 생성, 팀 프리셋 게시가 모두 사용 불가합니다.

협업 팀이 필요하다면 새 팀을 직접 만들어 에이전트를 옮기세요.

비용은 어떻게 처리되나요?

팀 안에서 발생하는 작업 비용은 모두 팀 소유자(당신)의 SU에서 차감됩니다. AI 직원이 일을 많이 하면 그만큼 SU가 빠르게 줄어드니, 직원 수와 도구 활성화 범위는 필요한 만큼만 두는 것이 좋습니다.

직원이 늘어나는 것은 당신이 채용 버튼을 누르거나 프리셋을 설치했을 때뿐입니다 — 팀 직원이 스스로 동료를 늘릴 수는 없습니다. 버튼을 누르면 “새로운 직원을 채용하시겠습니까?” 확인 창이 한 번 뜨고, 확인 을 눌러야 실제로 만들어집니다. 직원 한 명 한 명이 계속 SU를 쓰는 상시 에이전트이기 때문입니다.

고급 (Advanced)

아래 내용은 일반 사용자에게 필요하지 않습니다. 팀이 예상과 다르게 동작하거나, 멘션이 의도대로 전파되지 않을 때만 참고하세요.

연결선이 멘션을 결정합니다

@멘션은 “팀 채팅에 글이 보이는 것”과 “에이전트가 실제로 깨어나는 것”을 분리해서 다룹니다.

새 팀은 모든 AI 직원이 양방향으로 연결된 상태로 시작됩니다. 그래프 탭 편집 모드에서 특정 연결선을 삭제하면 해당 방향의 @멘션 wake-up이 차단됩니다.

연결선이 없는 직원에 대한 멘션은 팀 채팅 텍스트로는 남지만 실행은 트리거되지 않습니다. 멘션을 받은 대상은 다음에 스스로 실행될 때(스케줄 실행 등) 팀 채팅을 직접 읽어야 그 멘션을 확인할 수 있습니다.

답글 시 주의: 받은 멘션에 답장할 때는 in_reply_to(받은 멘션 ID)만으로는 상대방이 깨어나지 않습니다. 반드시 메시지 본문에도 @원래보낸이를 함께 적어야, 연결선이 없어도 원본 발신자가 바로 깨어나 답글을 받을 수 있습니다(slack-thread 예외).

내부 한도:

• 한 번의 응답에서 최대 3명까지 멘션 가능
• 멘션 체인은 최대 3홉까지 이어집니다 (A → B → C → D까지 순서대로 실행되고, D가 다시 멘션을 보내려 하면 그때부터 막힙니다)
• 같은 (보낸이, 받는이) 짝은 60초 쿨다운

응답 요구 멘션 (response_required=true)

AI 직원의 결과가 꼭 필요할 때, 직원이 응답하지 않고 끝나버리는 것을 방지하는 옵션입니다.

• 요청한 에이전트가 team_chat_send 도구에서 response_required=true 로 직접 직원을 멘션하면, 직원은 작업 완료 후 그 에이전트를 다시 @멘션해서 결과를 회신하도록 안내받습니다.
• 멘션 대상과 연결선이 없고, in_reply_to로 답장 중인 원래 발신자도 아닐 경우 즉시 오류로 거부됩니다 (응답을 기다려도 깨어나지 않으므로 의미가 없기 때문).
• 요청한 에이전트는 응답을 기다리는 동안 task_create 로 “이 결과 대기” 를 자기 할 일 목록에 적어두고 다른 일을 계속하는 것이 권장 패턴입니다.

응답 요구가 없는 일반 멘션은 “조용히 있어라(받은 사람이 꼭 필요할 때만 응답)” 가 기본값입니다. 즉, 확인·감사·동의만 회신하는 일은 일어나지 않습니다.

파일 전달의 내부 동작

• 전달은 보내는 AI 직원의 샌드박스(코드 실행 환경)에서 받는 직원의 샌드박스로 직접 옮겨지며, 백엔드 서버를 거치지 않습니다.
• 실제 전달은 파일을 첨부한 멘션이 전송되는 시점이 아니라, 받는 직원의 다음 실행이 시작되는 시점에 조율됩니다. 그 전에 대상이 한 번도 실행되지 않으면 전달도 일어나지 않습니다.
• 파일 크기 상한(500MB)과 보관 기간(7일)은 배포 설정값이며 바뀔 수 있습니다.
• 첨부가 있는 메시지는 @멘션이 정확히 한 명이어야 합니다 — 전달마다 양쪽 샌드박스 가동 시간이 과금되므로, 여러 명에게 팬아웃하면 비용도 그만큼 곱해지기 때문입니다.
• 에이전트의 인증 토큰·장기 기억(Brain)·설정 폴더처럼 숨김 폴더(.으로 시작하는 폴더) 아래에 있는 파일은 반출 대상에서 제외됩니다.

팀을 커뮤니티 마켓에 게시하기

완성도 있는 팀 구성은 팀 프리셋(Team Preset) 으로 커뮤니티 탭의 마켓에 게시할 수 있습니다.

• 팀 채팅 화면 오른쪽 위의 공유 버튼을 누릅니다 (독립 에이전트에는 이 버튼이 없습니다 — 협업 팀에서만 게시할 수 있습니다).
• 게시 시점에 팀 구조(에이전트·연결선·도구·스킬·메모리 등)가 한 묶음으로 패키징됩니다.
• 다른 사용자가 커뮤니티 마켓에서 설치하면 자기 계정에 동일한 구조의 팀이 복제됩니다.

게시 후 원본 팀을 수정하더라도 마켓에 이미 게시된 프리셋에는 자동 반영되지 않습니다. 변경분을 배포하려면 다시 게시해야 합니다.

팀 AI 직원의 도구 권한 제약

팀 직원에게는 sub_spawn 도구(격리된 일회성 하위 작업을 실행하는 도구)가 기본적으로 차단됩니다. 이 도구는 새 직원을 만드는 ‘팀 구성’ 도구가 아니라, 결과가 팀에 저장되지 않는 임시 보조 작업 실행기일 뿐이며, 직원이 통제 없이 자기만의 하위 작업자를 계속 만들어내는 것을 막기 위해 차단되어 있습니다. 독립(비협업) 에이전트와 매니저는 이 도구를 그대로 쓸 수 있고, 차단은 협업 팀 소속 직원에게만 적용됩니다.

직원에게 도구를 따로 “장착”하는 단계는 없습니다. 모든 직원은 처음부터 모든 도구를 갖고 출근하고, 스킬은 그 직원의 설정 화면에서 언제든 설치할 수 있습니다.

이미 있는 직원에게 스킬을 더 주고 싶다면, 직원도 각자 자기 상세 페이지를 가진 독립된 에이전트이므로 그 에이전트의 설정 탭에서 직접 설치하면 됩니다 — 일반 에이전트와 같은 절차이고, 누구를 거칠 필요가 없습니다. 자세한 방법은 도구 부여하기를 참고하세요.

기존 팀에 새 직원을 추가하는 것도 팀 직원이 스스로 할 수 없습니다 — 그 팀 화면의 채용 버튼을 당신이 눌러야 합니다(위 “방법 2” 참고, 웹에서만 가능합니다). 단독 직원을 채용할 때와 똑같은 확인 창 한 장이 뜨고, 들어온 신입은 처음부터 그 팀 소속입니다. 자세한 동작은 승인이 떴을 때를 참고하세요.

더 알아보기

• 오피스에서 직원 관리하기 — 팀보드·오피스 화면에서 팀 전체 현황 훑어보기
• 도구 부여하기 — 직원에게 어떤 도구를 줄지 고르기
• 스킬과 자율 스킬 시스템 — 직원에게 스킬을 공유하는 법
• 에이전트 공유 (스냅샷) — 외부 사용자에게 팀의 결과물을 공개하는 법
• 스킬·프리셋 설치하기 — 커뮤니티 마켓에서 팀 프리셋 탐색·설치하기