문서 목차
팀 에이전트 만들어 함께 쓰기
내가 만든 에이전트를 그룹이나 전체 사용자에게 공개하고, 팀원이 에이전트 채팅에서 여러 에이전트와 함께 대화하는 방법을 따라 합니다.
QUANTUM C&S
내가 만든 에이전트를 그룹이나 전체 사용자에게 공개하고, 팀원이 에이전트 채팅에서 여러 에이전트와 함께 대화하는 방법을 따라 합니다.
이런 일을 할 수 있어요
- 에이전트의 공개 범위를 나만 보기 · 그룹 공개 · 전체 공유 중에서 정합니다.
- 같은 그룹의 팀원은 공유받은 에이전트로 바로 씁니다. 공유 범위 밖의 사람은 쓸 수 없으며, 거부될 때는 사유와 필요한 조치가 표시됩니다.
- 에이전트 채팅에서 에이전트를 1~3개 초대해 한 방에서 대화하고,
@이름으로 특정 에이전트만 부르거나 토론 바퀴 수를 정해 에이전트끼리 의견을 주고받게 합니다.
공개 범위
| 공개 범위 | 누가 쓸 수 있나 | 적용 시점 |
|---|---|---|
| 나만 보기 | 만든 사람만 | 바로 |
| 그룹 공개 | 고른 그룹의 구성원 | 바로 |
| 전체 공유 | 로그인한 모든 사용자 | 에이전트 관리자 승인 후. 승인 전까지는 고른 그룹에만(비워 두면 나만) 공개 |
참고 에이전트는 언제나 쓰는 사람의 권한으로 실행됩니다. 공유받은 사람에게 없는 권한의 도구는 거부되고, 공유받은 사람이 에이전트의 기본 LLM 을 쓸 권한이 없으면 메인 LLM 으로 대신 답합니다. 지시문은 공유받은 사람에게 보이지 않습니다.
따라 하기: 에이전트 공유하기
1단계: 에이전트 만들기
에이전트 › 에이전트 목록에서 에이전트 만들기를 눌러 마법사를 진행합니다. 무엇을 할까요 → 이름 · 지시문 → 도구 · 지식 단계는 문서로 답하는 지식 에이전트 만들기와 같습니다. 이미 만든 에이전트라면 카드의 고치기를 누르면 이름 · 지시문 단계부터 열립니다.
팁 팀이 함께 쓸 에이전트는 설명과 예시 질문을 구체적으로 적어 두세요. 설명은 목록 카드에, 예시 질문은 저장 완료 화면에 표시됩니다.
2단계: 공개 범위 정하기
- 마법사의 공개 범위 단계에서 그룹 공개를 고릅니다.
- 공개할 그룹에서 함께 쓸 그룹을 하나 이상 누릅니다. 내가 속한 그룹만 표시됩니다.
- 그룹을 고르지 않으면 "공개할 그룹을 하나 이상 고르세요." 가 표시되고 다음을 누를 수 없습니다.
- 전체 사용자에게 공개하려면 전체 공유를 고릅니다. "저장하면 전체 공유 요청이 에이전트 관리자에게 갑니다. 승인되면 모든 사용자의 목록에 나타납니다." 안내가 표시됩니다. 승인 전에 먼저 공개할 그룹을 함께 고를 수 있습니다.
3단계: 확인 · 저장
- 확인 · 저장 단계에서 공개 범위 항목을 확인합니다(전체 공유를 요청했다면 "(승인 대기)" 가 붙습니다).
- 에이전트 만들기(고치는 중이면 저장)를 누릅니다.
- 전체 공유를 요청했다면 저장 완료 화면에 "전체 공유는 에이전트 관리자가 승인하면 열립니다." 가 표시되고, 목록 카드에 전체 공유 승인 대기 배지가 붙습니다.

4단계: (관리자) 전체 공유 승인
에이전트 관리자에게는 에이전트 목록에 전체 공유 승인 탭이 보입니다.
- 전체 공유 승인 탭에서 요청한 사람 · 요청 시각 · 설명 · 도구를 확인하고, 지시문 보기로 지시문을 검토합니다.
- 승인 또는 반려를 누릅니다.
- 반려되면 만든 사람의 카드에 전체 공유 반려 배지가 표시됩니다.
주의 자기 에이전트의 전체 공유는 스스로 승인할 수 없습니다. 이 경우 "자기 에이전트의 전체 공유는 다른 관리자가 승인합니다(직무 분리)." 가 표시됩니다.
따라 하기: 팀원이 함께 쓰기
1단계: 공유받은 에이전트 확인
팀원은 에이전트 › 에이전트 목록의 공유받은 에이전트 탭에서 공유된 에이전트를 봅니다. 카드에는 만든 사람 · <이름> 과 공개 범위 배지가 표시됩니다. 채팅에서 쓰기를 누르면 그 에이전트와의 1:1 방이 열립니다.
| 탭 | 표시되는 에이전트 |
|---|---|
| 전체 | 내가 쓸 수 있는 모든 에이전트 |
| 내 에이전트 | 내가 만든 에이전트 |
| 공유받은 에이전트 | 다른 사람이 그룹 공개 · 전체 공유한 에이전트 |
| 플랫폼 에이전트 | KosmosAI 가 기본 제공하는 에이전트 |
참고 목록에는 내가 쓸 수 있는 에이전트만 나옵니다. 공유 범위 밖의 에이전트는 목록에 보이지 않습니다.
2단계: 그룹 채팅방 만들기
- 에이전트 › 에이전트 채팅으로 이동해 오른쪽 위 새 채팅을 누릅니다.
- 새 에이전트 채팅 창에서 채팅방 이름을 입력합니다(비우면 에이전트 이름으로 정해집니다).
- 대화에 참여할 에이전트를 1~3개 누릅니다. 내가 만든 에이전트와 공유받은 에이전트(공유받음 표시)만 고를 수 있으며, 고른 순서대로 답합니다(카드에 순번이 표시됩니다).
- 채팅 시작을 누릅니다.

3단계: 대화하기
- 아래 입력칸에 질문을 쓰고 보내기(Enter)를 누릅니다. 줄바꿈은 Shift+Enter 입니다.
- 초대한 에이전트가 차례로 답합니다. 뒤 에이전트는 앞 에이전트의 답을 보고 보완하거나 반박합니다.
- 특정 에이전트만 부르려면 입력칸 위의
@이름칩(또는 방 제목 아래 에이전트 이름)을 눌러@이름을 넣고 보냅니다. 에이전트가 답에서 다른 에이전트를@이름으로 부르면 그 에이전트가 이어서 답합니다. - 입력칸 오른쪽 위에서 답하는 방식을 고릅니다.
| 선택 | 동작 |
|---|---|
| 한 번씩 | 초대한 에이전트가 한 번씩 답합니다 |
| 토론 2바퀴 | 한 번 더 서로의 답을 보고 보완 · 반박합니다 |
| 토론 3바퀴 | 세 바퀴까지 이어 갑니다 |
- 토론 중 덧붙일 내용이 없는 에이전트는 건너뛰며, "… — 덧붙일 내용이 없어 넘어갔습니다" 가 표시됩니다.
- 한 번 보낸 메시지에 대한 에이전트 답은 최대 9번까지 이어집니다.
- 답을 멈추려면 멈추기를 누릅니다. 멈춘 답에는 "(중단됨)" 이 표시됩니다.
4단계: 방 관리하기
| 버튼 | 동작 |
|---|---|
| 방 제목(연필 아이콘) | 제목을 눌러 이름을 바꿉니다 |
| 참여 에이전트 | 참여 에이전트를 1~3개로 다시 고르고 저장합니다 |
| 지우개 아이콘(대화 비우기) | 방과 참여 에이전트는 그대로 두고 대화 내용만 지웁니다 |
| 휴지통 아이콘(채팅방 삭제) | 방과 대화를 삭제합니다. 참여 에이전트 자체는 삭제되지 않습니다 |
참고 에이전트 채팅방은 만든 사람만 보고 쓸 수 있습니다. 팀원과 같은 에이전트를 쓰려면 각자 자기 채팅방을 만들어 공유받은 에이전트를 초대하세요. 채팅방은 한 사람당 50개까지 만들 수 있습니다.
공유 범위 밖일 때 보이는 메시지
공유가 거둬졌거나 공유 범위 밖인 에이전트를 쓰려고 하면 대화에 다음과 같은 거부 메시지가 표시됩니다. 에이전트 채팅에서는 해당 에이전트의 말풍선이 빨간색으로 표시되고, 다음 차례부터 답하지 않습니다.
'<에이전트 이름>' 에이전트를 쓸 권한이 없습니다. · 사유: 이 에이전트는 공유 범위(나만 보기 · 그룹 공개) 밖입니다. · 필요한 조치: <만든 사람> 에게 그룹 공개 또는 전체 공유를 요청하세요.
| 상황 | 해결 방법 |
|---|---|
| 공유 범위 밖 | 만든 사람에게 내 그룹으로 그룹 공개 또는 전체 공유를 요청합니다 |
| "이 에이전트는 지워졌거나 쓸 수 없는 상태입니다." | 만든 사람이 에이전트를 지웠습니다. 채팅방의 참여 에이전트에서 빼세요 |
| 에이전트가 쓰는 도구가 거부됨 | 그 도구에 필요한 권한이 나에게 없습니다. 거부 메시지의 필요한 조치를 따르세요 |
주의 만든 사람이 에이전트를 지우면 공유받은 사람도 더 이상 쓸 수 없습니다.
SAMANDA 에게 맡기기
- 에이전트 만들기 마법사의 첫 단계에서 SAMANDA 로 초안 만들기를 누르면 SAMANDA 가 이름 · 설명 · 지시문 · 도구 · 예시 질문 초안을 만들어 줍니다.
- 공유받은 에이전트도 SAMANDA 대화창의 에이전트 고정(입력창 모델 칩 옆 핀 아이콘)에서 골라 직접 대화할 수 있습니다.
권한
| 역할 · 관계 | 허용 작업 |
|---|---|
| 만든 사람 | 고치기 · 지우기 · 공개 범위 변경, 전체 공유 요청 |
| 공유받은 사람 | 목록에서 보기, 채팅에서 쓰기(자기 권한 범위 안에서) |
| 에이전트 관리자 | 전체 공유 요청 승인 · 반려(자기 에이전트 제외) |
- 그룹 공개는 내가 속한 그룹에만 할 수 있습니다. 다른 그룹을 지정하면 "내가 속한 그룹에만 공유할 수 있습니다." 가 표시됩니다.
- 개인 에이전트는 한 사람당 20개까지 만들 수 있습니다.