문서 목차
SAMANDA와 대화하기
SAMANDA는 KosmosAI의 AI 에이전트입니다. 플랫폼 현황을 묻거나 데이터셋·모델·서빙·지식기반 업무를 말로 맡기면, 직접 조회해 답하거나 알맞은 전문 에이전트에게 나눠 맡기고 끝까지 챙깁니다. 이 문서는 SAMANDA가 화면 전체를 쓰는 자동 모드 작업 공간을 설명합니다.
QUANTUM C&S
SAMANDA는 KosmosAI의 AI 에이전트입니다. 플랫폼 현황을 묻거나 데이터셋 · 모델 · 서빙 · 지식기반 업무를 말로 맡기면, 직접 조회해 답하거나 알맞은 전문 에이전트에게 나눠 맡기고 끝까지 챙깁니다. 이 문서는 SAMANDA가 화면 전체를 쓰는 자동 모드 작업 공간을 설명합니다.
주요 기능
| 기능 | 설명 |
|---|---|
| 묻기 | 현황 · 문서 · 데이터를 물어보면 실제 상태를 조회해 답합니다. 근거가 있으면 출처를 붙입니다 |
| 맡기기 | 만들기 · 배포 · 정리처럼 무언가를 바꾸는 일은 계획을 먼저 보여 주고, 승인하면 실행합니다 |
| 남기기 | 답을 아티팩트(공유 문서)로 저장하고, 반복 업무는 예약 작업으로, 관련 대화는 프로젝트로 묶습니다 |
| 에이전트 고정 | 특정 에이전트를 고정해 그 에이전트와 직접 대화합니다 |
| 첨부 · 음성 | PDF · 이미지를 올려 내용에 대해 묻고, 마이크로 음성 대화를 합니다 |
자동 모드와 수동 모드
KosmosAI 화면은 두 가지 모드로 쓸 수 있습니다.
| 모드 | 화면 | 들어가는 방법 |
|---|---|---|
| 자동 모드 | SAMANDA 작업 공간이 화면 전체를 씁니다(포털 메뉴 · 헤더 없음) | 포털 헤더의 SAMANDA 버튼, 또는 화면 곳곳의 SAMANDA 에게 묻기 |
| 수동 모드 | 포털 화면(왼쪽 메뉴 · 대시보드) | 작업 공간 왼쪽 아래 포털 화면(수동 모드) |
마지막으로 고른 모드는 계정에 저장되어, 다시 로그인하거나 다른 기기에서 열어도 같은 모드로 시작합니다. 처음 쓰는 사용자의 기본값은 자동 모드입니다.
참고 포털 화면에서 SAMANDA 에게 묻기를 누르면 자동 모드로 넘어가고, 그 화면이 준비한 질문이 대화창에 들어갑니다. 대시보드의 일부 버튼처럼 질문을 곧바로 보내는 경우도 있습니다.
화면 구성
| 영역 | 설명 |
|---|---|
| 왼쪽 사이드바 | 새 대화 · 대화 검색 · 예약 작업 · 아티팩트 · 프로젝트 · 고정한 대화 · 최근 대화(오늘 · 어제 · 지난 7일 · 지난 30일 · 이전) · 모든 대화 보기 · 포털 화면(수동 모드) · 내 계정 |
| 가운데 | 대화창입니다. 새 대화에서는 시간대별 인사, 역할에 맞춘 시작 질문, 묻기 · 맡기기 · 남기기 안내가 보입니다 |
| 오른쪽 패널 | 작업 현황(하위 에이전트 작업) · 이번 대화 진행(답을 만드는 단계) · 프로젝트 지식(프로젝트 안일 때) · 시스템 상태(운영 조회 권한이 있을 때) |
| 입력창 | 질문 입력 · [+] 첨부 · [/] 명령 · 진행 표시 · 모델 칩 · 📌 에이전트 고정 · 🎤 음성 · 보내기/중지 |
- 왼쪽 사이드바는 위쪽 아이콘으로 접고 펼칩니다.
- 오른쪽 패널은 대화창 오른쪽 위 아이콘으로 열고 닫습니다. 가장자리를 끌어 폭을 바꾸고, 두 번 누르면 기본 폭으로 돌아갑니다.
- 시작 질문은 역할(운영 관리자 · 보안 관리자 · ML 엔지니어 · 데이터 엔지니어 · 분석가 · 지식 관리자 · 구성원)에 따라 다르게 보입니다. 누르면 그 질문으로 대화를 시작합니다.
질문하고 답 받기
1단계: 새 대화 열기
왼쪽 위 새 대화를 누르세요.
2단계: 질문 보내기
아래 입력창(사만다에게 물어보세요)에 질문을 쓰고 Enter를 누르세요. 줄을 바꾸려면 Shift+Enter를 누르세요.
3단계: 진행 확인
답을 만드는 동안 입력창 왼쪽 아래에 진행 표시와 경과 시간이, 오른쪽 패널 이번 대화 진행에 지금 하는 일이 보입니다.
4단계: 답 활용
답이 끝나면 답 아래 버튼을 쓸 수 있습니다.
| 버튼 | 설명 |
|---|---|
| 내용 복사 | 답을 클립보드에 복사합니다 |
| 좋아요 / 괜찮아요 / 별로에요 | 답을 평가합니다. 같은 버튼을 다시 누르면 취소됩니다 |
| 아티팩트로 저장 | 이 답을 공유 · PDF 저장이 가능한 문서로 남깁니다 |
팁 답을 기다리는 동안에도 다음 질문을 미리 쓸 수 있습니다. 응답 중에 Enter를 누르면 진행 중인 답을 끊고 새 질문으로 넘어갑니다. 답을 멈추기만 하려면 중지 버튼을 누르세요.
메인 SAMANDA와 하위 에이전트
평소 대화 상대는 메인 SAMANDA입니다. 간단한 조회는 직접 답하고, 전문 영역이 필요하면 하위 에이전트에게 일을 맡깁니다.
| 하위 에이전트 | 맡는 일 |
|---|---|
| SAMANDA App | ML · LLMOps 업무 — 데이터셋 · 모델 · 학습 · 서빙 · 플로우 |
| SAMANDA Ops | 시스템 운영 — 인프라 상태 · 인시던트 |
| SAMANDA RAG | 지식기반 문서 검색과 답변 |
| AkashiQ | 연동된 AkashiQ 업무 |
| SAMANDA Code | 노트북(Jupyter · VS Code) 안의 코드 작업 |
맡긴 일은 두 가지 방식으로 진행됩니다.
| 방식 | 설명 |
|---|---|
| 대화 중 위임 | 답 안에 에이전트 이름과 단계 수가 표시됩니다. 진행 상황 보기를 누르면 그 에이전트의 도구 호출과 결과를 팝업으로 봅니다 |
| 백그라운드 작업 | 오래 걸리는 일은 대화와 따로 진행되고, 끝나면 결과를 이 대화로 알려 줍니다. 그동안 다른 질문을 해도 됩니다 |
작업 현황 보기
- 입력창의 N agents 표시는 이 대화에서 움직이는 하위 에이전트 수입니다. 누르면 작업 목록이 열립니다.
| 색 | 상태 |
|---|---|
| 초록 | 진행 중 |
| 주황 | 승인 대기 |
| 회색 | 작업 없음 |
- 오른쪽 패널 작업 현황에도 진행 중인 작업과 예약 실행이 보입니다.
- 작업을 누르면 백그라운드 작업 창이 열립니다.
| 항목 | 설명 |
|---|---|
| 맡긴 작업 · 현재 단계 · 진행 기록 | 무엇을 맡겼고 지금 어디까지 했는지 보여 줍니다 |
| 최종 결과 / 오류 | 끝난 작업의 결과 또는 오류 내용입니다 |
| 보내기 | 실행 중인 작업에 추가 지시를 보냅니다. 다음 도구 호출 차례에 반영됩니다 |
| 이어서 시키기 | 끝난 작업을 지금까지의 맥락 그대로 다시 깨워 이어서 시킵니다 |
| 작업 취소 | 진행 중인 작업을 취소합니다 |
바꾸는 일은 승인 후 실행
만들기 · 배포 · 삭제 · 정리처럼 플랫폼을 바꾸는 일은 SAMANDA가 바로 실행하지 않고 계획을 먼저 보여 줍니다. 이때 입력창 바로 위에 승인 필요 카드가 나타납니다.
1단계: 계획 확인
카드 한 줄에 실행할 도구와 요약(무엇을 · 어디에)이 보입니다. 자세히를 누르면 계획 전체를 표로 볼 수 있습니다.
2단계: 승인 또는 거절
계획이 맞으면 승인, 아니면 거절을 누르세요. 승인하면 보관된 계획 그대로 실행되고, 결과는 대화로 이어집니다.
| 방법 | 설명 |
|---|---|
| 카드의 승인 / 거절 | 입력창 위 카드에서 바로 처리합니다 |
| "응"이라고 답하기 | 카드를 누른 것과 같은 승인으로 처리됩니다 |
| 백그라운드 작업 창 | 승인하고 실행 / 거부로 처리합니다 |
주의 계획에 적힌 대상(이름 · 개수 등)을 확인한 뒤 승인하세요. 승인한 작업은 내 계정의 권한으로 실행되며, 감사 기록에도 내 이름으로 남습니다.
에이전트 고정
기본값은 고정 없음으로, 메인 SAMANDA가 받아 직접 답하거나 맡깁니다. 특정 에이전트와 직접 대화하려면 그 에이전트를 고정하세요.
1단계: 목록 열기
입력창 아래 모델 칩 옆의 📌(에이전트 고정) 버튼을 누르세요.
2단계: 에이전트 고르기
목록에서 에이전트를 고르세요. 각 항목 아래에 종류가 표시됩니다.
| 표시 | 설명 |
|---|---|
| 플랫폼 | SAMANDA RAG · SAMANDA Ops · SAMANDA App · AkashiQ 등 |
| 관리자 에이전트 | 운영자가 등록한 에이전트 |
| 내가 만듦 | 내가 에이전트 목록에서 만든 에이전트 |
| 공유받음 · 만든 사람 | 다른 사용자가 공유한 에이전트 |
고정하면 버튼 자리에 에이전트 이름이 표시되고, 이후 질문은 그 에이전트가 직접 답합니다. 답하는 모델은 그 에이전트에 정해진 모델입니다.
3단계: 고정 풀기
이름 옆 X, 또는 목록 아래 고정 풀기 — 메인 SAMANDA 로를 누르세요.
| 규칙 | 설명 |
|---|---|
| 목록에서 빠지는 것 | 메인 SAMANDA(고정 없음 자체), SAMANDA Code(노트북 안에서만 동작) |
| 보이는 범위 | 내가 쓸 수 있는 에이전트만 표시됩니다 |
| 저장 위치 | 고정은 이 브라우저에 사용자별로 저장됩니다 |
| 권한 확인 | 질문할 때마다 다시 확인합니다. 공유가 거둬지면 거부 사유가 담긴 메시지가 표시됩니다 |
팁 고정할 에이전트를 바꿀 때는 새 대화를 시작하세요. 같은 대화에서 바꾸면 앞서 다른 에이전트와 나눈 대화가 그대로 이어져 답이 섞일 수 있습니다.
모델 칩
입력창 아래 모델 칩(CPU 아이콘과 모델 이름)은 메인 SAMANDA가 답할 때 쓰는 모델입니다.
| 항목 | 설명 |
|---|---|
| 모델 바꾸기 | 칩을 누르면 모델 선택 창이 열립니다. 고른 모델은 내 계정에 저장되어 바로 다음 답부터, 다른 기기에서도 그 모델로 답합니다. 전체 기본값은 바뀌지 않습니다 |
| 기본으로 되돌리기 | 기본 모델과 같은 모델을 고르면 내 선택이 지워지고 기본 모델을 따릅니다 |
| 쓸 수 없는 모델 | 고른 모델을 지금 쓸 수 없으면 기본 모델로 답하고, 칩 설명에 안내가 표시됩니다 |
| 표시 범위 | 플랫폼 관리자는 등록된 모델 전체를, 일반 사용자는 기본 모델과 고를 수 있는 에이전트를 봅니다. 고를 것이 없으면 칩이 표시되지 않습니다 |
| 에이전트 고정 중 | 모델 칩 대신 고정한 에이전트의 모델이 쓰입니다 |
입력창 도구
| 버튼 · 입력 | 설명 |
|---|---|
| [+] | PDF · 이미지를 첨부합니다(여러 개 가능). 끌어다 놓기와 Ctrl+V 붙여넣기도 됩니다 |
| [/] | 입력 앞에 /를 넣어 명령을 씁니다 |
/model |
채팅 메시지 없이 모델 선택 창을 엽니다 |
@ |
지식기반 선택 목록이 열립니다(↑↓ · Enter). @지식기반 이름을 넣고 물으면 그 지식기반에서 바로 찾아 답합니다 |
| 🎤 | 음성 대화를 시작하거나 끝냅니다 |
| ↑ / ■ | 보내기 / 응답 중지 |
첨부 규칙
| 항목 | 규칙 |
|---|---|
| 형식 | PDF와 이미지만 가능합니다. 다른 형식은 "지원하지 않는 형식입니다 (PDF / 이미지만 가능)"이 표시됩니다 |
| 크기 | 파일당 최대 10 MB입니다 |
| 안내 문구 | 첨부하면 입력창 안내가 "이 PDF 에 대해 무엇이든 물어보세요...", "이 이미지에 대해 무엇이든 물어보세요..."처럼 바뀝니다 |
음성 대화
- 🎤를 누르세요. 처음에는 브라우저가 마이크 권한을 묻습니다.
- "듣고 있어요... 편하게 말씀하세요"가 보이면 말하세요. 말이 끝나면 텍스트로 바뀌어 자동으로 전송됩니다. 바로 끝내려면 녹음 완료를 누르세요.
- 음성 대화를 끝내려면 ■(음성 대화 종료)를 누르세요.
참고 음성 인식은 Chrome · Edge를 권장합니다. 마이크 권한을 거부했다면 브라우저 설정에서 허용하세요.
대화 관리
왼쪽 목록에서 대화에 마우스를 올리면 **⋯(대화 메뉴)**가 나타납니다.
| 메뉴 | 설명 |
|---|---|
| 이름 바꾸기 | 대화 제목을 고칩니다. 처음 제목은 자동으로 붙습니다 |
| 고정 / 고정 해제 | 고정한 대화는 목록 위 고정 묶음에 모입니다 |
| 프로젝트로 이동 | 대화를 프로젝트에 넣거나 프로젝트 밖으로 뺍니다 |
| 삭제 | 한 번 더 확인한 뒤 삭제합니다 |
예약 작업이 만든 대화에는 시계 아이콘이 붙습니다. 지난 대화를 모두 보려면 모든 대화 보기를, 제목으로 찾으려면 대화 검색을 쓰세요.
프로젝트
프로젝트는 관련 대화를 묶고, 그 안의 모든 대화에 지침과 지식기반을 함께 적용하는 폴더입니다.
1단계: 프로젝트 만들기 열기
왼쪽 프로젝트 옆 **+**를 누르세요.
2단계: 내용 입력
| 항목 | 설명 |
|---|---|
| 이름 · 설명 | 프로젝트 이름과 설명입니다 |
| 지침 | 이 프로젝트의 모든 대화에 적용할 지침입니다. 예: "답은 표로, 결론 먼저." |
| 지식(지식베이스) | 연결할 지식기반입니다. 이 프로젝트의 대화는 고른 지식기반을 먼저 찾아봅니다 |
3단계: 만들기
만들기를 누르세요.
프로젝트 안에서 할 수 있는 일
| 작업 | 설명 |
|---|---|
| 새 대화 | 프로젝트 화면 입력창(「프로젝트 이름」에서 무엇이든 물어보세요)에 쓰면 이 프로젝트 안에 새 대화가 열립니다. 왼쪽 위 버튼도 이 프로젝트에서 새 대화로 바뀝니다 |
| 지식 추가 · 해제 | 지식(지식베이스) 카드의 추가로 지식기반을 더 연결하거나 연결을 해제합니다. 지식기반 자체는 삭제되지 않습니다 |
| 프로젝트 설정 | 이름 · 설명 · 지침 · 지식을 고칩니다 |
| 삭제 | 지침 · 지식 연결이 사라집니다. 대화도 함께 삭제하는 항목을 체크하지 않으면 대화는 프로젝트 밖으로 남습니다 |
예약 작업
정해진 때마다 SAMANDA가 같은 일을 하고, 결과를 대화로 남기고 알림으로 알려 줍니다. 왼쪽 예약 작업에서 관리합니다.
1단계: 새 예약 열기
새 예약을 누르세요.
2단계: 할 일과 일정 입력
| 항목 | 설명 |
|---|---|
| 이름 | 예: 아침 플랫폼 브리핑 |
| SAMANDA 에게 시킬 일 | 실행할 때마다 SAMANDA에게 보낼 요청입니다 |
| 언제 | 매일 · 평일 · 매주 · 매월 · 매시간 · 한 번 · 직접(cron) 중에서 고르고 시각을 정합니다. 서울 시간 기준이며 일정 미리보기가 표시됩니다 |
| 프로젝트(선택) | 고르면 실행 대화가 그 프로젝트에 들어가고 프로젝트 지침 · 지식이 적용됩니다 |
| 실행 결과를 아티팩트(공유 문서)로 저장(선택) | 켜고 공유 범위를 고르면 실행마다 결과가 문서로 남고, 알림을 누르면 그 문서가 열립니다 |
3단계: 저장
예약 만들기를 누르세요.
팁 대화에서 "매일 9시에 플랫폼 상황 요약해줘"처럼 말해도 예약을 만들 수 있습니다.
예약 상태
| 상태 | 설명 |
|---|---|
| 켜짐 | 일정에 따라 실행됩니다 |
| 실행 중 | 지금 실행하고 있습니다 |
| 일시정지 | 멈춰 둔 예약입니다 |
| 완료 | 더 실행할 일정이 없습니다 |
| 오류 | 실행 중 오류가 났습니다 |
| 취소됨 | 취소된 예약입니다 |
예약 관리
| 버튼 | 설명 |
|---|---|
| ▶ 지금 실행 | 일정과 상관없이 한 번 바로 실행합니다. 실행 중이면 중단할 수 있습니다 |
| 일시정지 / 다시 켜기 | 예약을 멈추거나 다시 켭니다 |
| 연필 아이콘 | 예약 고치기 |
| 휴지통 아이콘 | 예약을 삭제합니다 |
| 마지막 실행 결과 / 결과 아티팩트 | 마지막 실행 대화 또는 결과 문서를 엽니다 |
예약은 만든 사람의 권한으로 실행됩니다. 권한이 없는 작업이면 권한이 없습니다가 표시됩니다.
아티팩트
아티팩트는 SAMANDA가 분석한 결과를 남기는 공유 문서입니다. 표 · 차트를 담을 수 있고, 링크로 공유하거나 PDF로 받을 수 있습니다.
만드는 방법
| 방법 | 설명 |
|---|---|
| 답 아래 아티팩트로 저장 | 그 답을 문서로 남깁니다 |
| 대화로 요청 | "분석 결과를 보고서 아티팩트로 만들어줘"처럼 말합니다 |
| 예약 작업 | 실행 결과를 아티팩트(공유 문서)로 저장을 켭니다 |
목록과 보기
왼쪽 아티팩트에서 전체 · 내 것 · 공유받은 것으로 나눠 보고, 제목 · 내용으로 검색합니다. 카드를 누르면 문서가 열립니다.
| 버튼 | 설명 |
|---|---|
| 원래 대화 | 이 문서를 만든 대화로 이동합니다 |
| 고치기 | 내용을 고칩니다(만든 사람만) |
| 삭제 | 문서를 삭제합니다(만든 사람만) |
| 전체 화면 | 문서만 크게 봅니다. Esc로 끝냅니다 |
| 내보내기 | HTML(독립 실행형 웹 페이지) · Markdown(.md 파일) · PDF(브라우저 인쇄 창) |
| 공유 | 공유 범위를 정하고 링크 복사를 합니다 |
공유 범위
| 범위 | 볼 수 있는 사람 |
|---|---|
| 나만 | 만든 사람만 |
| 그룹 공유 | 고른 공유 그룹. 고르지 않으면 내 그룹 사용자 |
| 전체 공개 | 로그인한 모든 사용자 |
- 공유 범위는 만든 사람만 바꿀 수 있습니다. 다른 사용자는 링크만 복사할 수 있습니다.
- 소속 그룹이 없으면 그룹 공유를 쓸 수 없습니다. 나만 또는 전체 공개를 고르세요.
- 범위 밖의 사용자가 링크를 열면 "이 아티팩트를 볼 권한이 없습니다(공유 범위 밖)."가 표시됩니다.
팁 다른 사람에게 보낼 때는 파일 대신 링크를 공유하세요. 받는 사람이 항상 최신 내용을 봅니다.
권한
SAMANDA는 질문한 사용자의 권한으로 조회하고 실행합니다. 내가 화면에서 볼 수 없는 데이터는 SAMANDA를 통해서도 볼 수 없고, 내가 할 수 없는 작업은 SAMANDA도 할 수 없습니다. 권한은 작업마다 IGA(권한 관리)가 판정하며, 거부되면 SAMANDA가 거부 사유를 알려 줍니다.
| 항목 | 규칙 |
|---|---|
| 대화 · 프로젝트 · 예약 | 로그인한 사용자 누구나 자신의 것을 만들고 관리합니다 |
| 승인이 필요한 작업 | 승인한 사용자의 권한으로 실행됩니다 |
| 오른쪽 패널 시스템 상태 | 운영 조회 권한이 있는 사용자에게만 표시됩니다 |
| 아티팩트 저장 | 권한이 없으면 "아티팩트를 만들 권한이 없습니다"가 표시됩니다 |
참고 필요한 권한은 관리자에게 요청하세요. 내 권한은 내 프로필에서, 권한 체계는 핵심 개념에서 확인할 수 있습니다.
알아두면 좋은 점
- SAMANDA는 질문할 때마다 실제 상태를 다시 조회해 답합니다. 예전 답을 근거로 판단하지 마세요.
- "이 모델은 지금 쓸 수 없습니다(공급사 종료/오류). 다른 모델을 고르세요."가 표시되면 모델 칩에서 다른 모델을 고르세요. 오류 원문 보기로 자세한 내용을 볼 수 있습니다.
- 지식기반 문서를 깊이 다루려면 지식대화를, 여러 에이전트를 함께 부르려면 에이전트 채팅을 쓰세요.
다음 단계
- 대시보드 — 포털 화면(수동 모드)에서 플랫폼 현황 보기
- 에이전트 목록 · 만들기 · 공유 — 내 에이전트를 만들어 고정하기
- 에이전트 채팅 — 에이전트 여러 개와 함께 대화하기
- 지식기반 — 프로젝트와
@멘션에 쓸 지식기반 만들기 - KosmosAI 한눈에 보기 · 주요 기능 · 로그인