팀으로 일 나누기

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

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

언제 팀이 필요한가요?

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

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

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

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

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

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

팀 만들기 — 두 가지 방법

방법 1. 에이전트에게 말로 부탁하기

가장 빠른 방법입니다. 사이드바 상단 + 버튼으로 안내 에이전트(Agent Father)를 열고 자연어로 요청하면 됩니다.

“기획자, 작성자, 검수자 3명으로 콘텐츠 제작 팀을 만들어줘. 각자에게 필요한 도구도 함께 부여해줘.”

안내 에이전트가 알아서 팀과 팀원 에이전트를 생성하고 도구도 분배합니다. 이미 비슷한 팀원이 있으면 새로 만들지 않고 그쪽에 일을 맡깁니다.

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

화면 왼쪽 사이드바의 팀 영역에서 팀을 선택하면 팀 페이지로 이동합니다. 기본 팀이 아닌 팀에서 그래프 탭을 선택하면 에이전트를 직접 추가하고 연결선을 그릴 수 있습니다.

• 새 에이전트를 만들거나, 이미 만들어 둔 에이전트를 팀에 합류시킬 수 있습니다.
• 연결선에는 라벨을 붙일 수 있습니다 (예: “research”, “review”).

팀 채팅과 @멘션

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

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

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

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

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

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

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

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

팀 페이지에서 보이는 것

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

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

기본 팀 제약 사항

기본 팀에서는 아래 기능이 모두 비활성화됩니다. 팀 채팅(읽기/쓰기), 팀 공유 상태(읽기/쓰기/삭제), 팀원 생성·장착, 마켓플레이스 게시가 모두 사용 불가합니다. 협업 팀이 필요하다면 새 팀을 직접 만들어 에이전트를 옮기세요.

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

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

새 팀원을 만들거나 팀원에게 도구·스킬을 장착하는 동작은 실행 전에 당신에게 승인 요청이 표시됩니다. 팀원 한 명 한 명이 계속 크레딧을 쓰는 상시 에이전트이기 때문에, 실제로 추가할지 확인을 받은 뒤에야 만들어집니다.

고급 (Advanced)

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

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

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

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

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

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

내부 한도:

• 한 번의 응답에서 최대 3명까지 멘션 가능
• 멘션 체인 깊이 3단계까지 (A → B → C 까지)
• 같은 (보낸이, 받는이) 짝은 60초 쿨다운

응답 요구 멘션 (response_required=true)

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

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

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

팀을 마켓플레이스에 게시하기

완성도 있는 팀 구성은 팀 프리셋(Team Preset) 으로 마켓플레이스에 게시할 수 있습니다.

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

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

팀 멤버 에이전트의 도구 권한 제약

팀 멤버에게는 팀 구성(composer) 도구(sub_spawn, team_agent_create, team_agent_equip)가 기본적으로 차단됩니다. 팀이 통제 없이 무한히 확장되는 것을 막기 위한 안전 장치입니다. 이 도구들은 Agent Father(팀 생성 요청 시 임시 동작하는 특수 에이전트)만 사용할 수 있습니다.

팀원에게 추가 스킬·도구를 부여하려면 안내 에이전트(Agent Father)가 team_agent_equip 을 사용합니다.

더 알아보기

• 도구 부여하기 — 팀원 에이전트에게 어떤 도구를 줄지 고르기
• 스킬과 자율 스킬 시스템 — 팀원에게 스킬을 공유하는 법
• 에이전트 공유 (스냅샷) — 외부 사용자에게 팀의 결과물을 공개하는 법
• 스킬·프리셋 설치하기 — 마켓플레이스에서 팀 프리셋 탐색·설치하기