문서 목차
KosmosAI v1.0.2따라 하기
문서로 답하는 지식 에이전트 만들기
문서를 지식기반에 올리고, 그 문서를 근거로 답하는 나만의 에이전트를 만들어 지식대화·SAMANDA·에이전트 채팅에서 씁니다.
QUANTUM C&S
문서를 지식기반에 올리고, 그 문서를 근거로 답하는 나만의 에이전트를 만들어 지식대화 · SAMANDA · 에이전트 채팅에서 씁니다.
이런 일을 할 수 있어요
- 문서(PDF · DOCX · TXT · MD · HTML · JSON · CSV)를 지식기반에 올리면 자동으로 분석(파싱) · 분할 · 색인되어 검색할 수 있게 됩니다.
- 에이전트 만들기 마법사에서 하고 싶은 일을 한두 문장으로 적으면 SAMANDA 가 이름 · 지시문 초안을 만들어 줍니다.
- 에이전트에 지식기반(최대 5개)을 연결하면, 답할 때 그 문서를 근거로 출처와 함께 답합니다.
전체 흐름
| 단계 | 화면(메뉴) | 결과물 |
|---|---|---|
| 1. 지식기반 만들기 | 에이전트 › 지식기반 › 새 지식기반 | 빈 지식기반 |
| 2. 문서 올리기 | 지식기반 상세 › 문서 업로드 | 문서 목록 |
| 3. 처리 확인 | 지식기반 상세 › 문서 목록 상태 | 모든 문서 완료 |
| 4. 에이전트 만들기 | 에이전트 › 에이전트 목록 › 에이전트 만들기 | 내 에이전트 |
| 5. 대화하기 | 지식대화 / SAMANDA 고정 / 에이전트 채팅 | 문서 근거 답변 |
따라 하기
1단계: 지식기반 만들기
- 왼쪽 메뉴 에이전트 › 지식기반으로 이동해 새 지식기반을 누릅니다.
- 이름(필수)과 설명을 입력합니다. 설명에는 이 지식기반이 다루는 주제를 적어 두면 좋습니다.
- 공개 범위를 고릅니다.
- 비공개: 나만 봅니다.
- 그룹: 고른 프로젝트의 구성원이 봅니다. 그룹을 고르면 공개할 프로젝트를 선택하는 칸이 나타납니다.
- 공개: 모든 사용자가 봅니다.
- 생성을 누릅니다. 목록에 새 지식기반 카드가 나타납니다.
팁 에이전트는 언제나 쓰는 사람의 권한으로 실행됩니다. 에이전트를 팀과 함께 쓸 계획이라면, 지식기반도 팀원이 볼 수 있는 공개 범위로 만들어 두세요.
2단계: 문서 올리기
- 목록에서 방금 만든 지식기반 카드를 눌러 상세 화면을 엽니다.
- 오른쪽 위 문서 업로드를 누르거나, 파일을 화면에 끌어다 놓습니다. 여러 파일을 한 번에 올릴 수 있습니다.
- 업로드가 끝나면 "N개 문서 업로드 완료" 안내가 나오고, 문서 처리가 자동으로 시작됩니다.
3단계: 처리(파싱) 완료 기다리기
문서 목록의 상태 열에서 처리 과정을 확인합니다.
| 상태 | 뜻 |
|---|---|
| 처리 대기 / 대기 / 큐 대기 | 처리 순서를 기다리는 중 |
| 처리중 | 문서 구조 분석 · 분할 · 색인 중 |
| 완료 | 검색 준비 완료. 청크 · 처리시간 열에 분할된 조각 수가 표시됩니다 |
| 실패 | 처리 실패. 행의 진행 로그 보기로 원인을 확인합니다 |
- 위쪽 탭(전체 · 대기 · 처리중 · 완료 · 실패)으로 상태별로 걸러 볼 수 있습니다.
- 실패한 문서는 행의 재처리 아이콘을, 여러 개는 선택 후 선택 재처리를, 전체는 전체 재처리를 누릅니다.
- 완료된 문서의 문서 상세를 열면 페이지별 청크 보기와 트리(문서 구조)를 확인하고 고칠 수 있습니다.
참고 문서 크기와 표 · 그림의 양에 따라 처리 시간이 다릅니다. 화면은 자동으로 갱신되며, 새로고침 아이콘으로 바로 다시 읽을 수도 있습니다.
자세한 기능은 지식기반을 참고하세요.
4단계: 지식 에이전트 만들기
- 왼쪽 메뉴 에이전트 › 에이전트 목록에서 에이전트 만들기를 누릅니다. 마법사가 무엇을 할까요 → 이름 · 지시문 → 도구 · 지식 → 공개 범위 → 확인 · 저장 5단계로 열립니다.
- 무엇을 할까요: 어떤 일을 맡길까요? 칸에 하고 싶은 일을 적습니다.
예) "사내 인사 규정 문서를 근거로 휴가 · 복무 관련 질문에 답해 주는 에이전트"
- SAMANDA 로 초안 만들기를 누르면 이름 · 설명 · 지시문 · 예시 질문이 채워진 채로 다음 단계로 넘어갑니다.
- 직접 쓰려면 직접 입력하기를 누릅니다.
- 이름 · 지시문: 다음을 확인 · 수정합니다.
- 아이콘(이모지), 이름(필수), 설명(목록에서 다른 사람이 보는 문장)
- 기본 LLM: 비워 두면 메인 에이전트 LLM 을 따릅니다(권장). 사용 권한이 없는 모델은 "사용 권한 없음"으로 표시되어 고를 수 없습니다.
- 지시문(필수): 역할 · 절차 · 답변 형식 · 하지 말 것을 적습니다. 공유받은 사람에게는 보이지 않습니다.
- 예시 질문: 저장 후 "이렇게 물어보세요"로 보입니다.
- 초안이 마음에 들지 않으면 이렇게 고쳐줘 칸에 고칠 점을 적고 다시 만들기를 누릅니다.
- 도구 · 지식
- 지식베이스: 1단계에서 만든 지식기반을 눌러 선택합니다(최대 5개, 내가 볼 수 있는 것만 보입니다).
- 도구: 문서 질의응답만 할 에이전트라면 도구는 고르지 않아도 됩니다. 꼭 필요한 것만 고르면 답이 더 정확합니다. 변경 표시가 붙은 도구는 데이터를 바꾸는 도구이며, 실행 전 확인을 켜 두면 실행 전에 확인을 받습니다.
참고 삭제 · 재시작 같은 위험 도구는 개인 에이전트에서 고를 수 없습니다. 관리자가 확인을 요구한 도구(관리자 확인 필수)는 확인을 끌 수 없습니다.
- 공개 범위: 처음에는 나만 보기로 두고 시험해 보는 것을 권장합니다. 팀과 함께 쓰는 방법은 팀 에이전트 만들어 함께 쓰기를 참고하세요.
- 확인 · 저장: 기본 LLM · 도구 · 지식베이스 · 공개 범위를 확인하고, 지시문 보기로 지시문을 점검한 뒤 에이전트 만들기를 누릅니다.
- "저장 완료" 화면이 나타납니다. 채팅에서 써보기를 누르면 지식대화 화면이 이 에이전트를 모델로 고른 채 열립니다.
팁 저장 완료 화면에 안내된 대로, 외부 프로그램에서는 내 개인 액세스 토큰과
model=agent/<에이전트 식별자>로 이 에이전트를 부를 수 있습니다.
5단계: 에이전트와 대화하기
방법 A — 지식대화
- 저장 완료 화면의 채팅에서 써보기를 누르거나, 왼쪽 메뉴 에이전트 › 지식대화로 이동합니다.
- 모델 선택의 에이전트 묶음에서 만든 에이전트를 고릅니다.
- 질문을 입력하고 보냅니다. 답에는 근거 문서가
[출처: 문서명]형식으로 붙고, 출처를 누르면 해당 페이지와 청크를 볼 수 있습니다.
방법 B — SAMANDA 대화창에 에이전트 고정
- 화면 오른쪽 위 SAMANDA 버튼으로 대화창을 엽니다(또는 SAMANDA 작업 공간).
- 입력창 아래 모델 칩 옆의 핀 아이콘(에이전트 고정)을 누릅니다.
- 목록에서 만든 에이전트를 고릅니다. 이제 메인 SAMANDA 대신 이 에이전트와 직접 대화합니다. 고정된 에이전트 이름이 칩으로 표시됩니다.
- 고정을 풀려면 칩의 X 를 누르거나 목록 아래 고정 풀기 — 메인 SAMANDA 로를 누릅니다.
참고 고정은 브라우저(사용자)별로 기억됩니다. 공유가 거둬지는 등 더 이상 쓸 수 없게 되면 대화할 때 거부 사유가 표시됩니다.
방법 C — 에이전트 채팅의 1:1 방
- 에이전트 목록에서 내 에이전트 카드의 채팅에서 쓰기를 누릅니다.
- 에이전트 채팅 화면에서 그 에이전트 하나만 있는 1:1 방이 열립니다(이미 있으면 그 방, 없으면 새로 만듭니다).
- 아래 입력칸에 질문을 쓰고 보내기(또는 Enter)를 누릅니다.
자세한 기능은 에이전트 채팅을 참고하세요.
SAMANDA 에게 맡기기
SAMANDA 대화창에서 다음과 같이 물어볼 수 있습니다.
- "지식베이스 목록 보여줘"
- "지식베이스에 문서 올리는 방법 알려줘"
- "지식베이스에서 휴가 규정 찾아줘"
SAMANDA 작업 공간의 프로젝트에 지식기반을 연결해 두면, 그 프로젝트의 대화마다 연결된 지식을 먼저 찾아보고 답합니다. 자세한 내용은 SAMANDA와 대화하기를 참고하세요.
권한
- 지식기반 만들기 · 문서 올리기에는 지식기반 권한이 필요합니다. 공개 범위를 그룹이나 공개로 정하려면 그 범위로 공유할 권한이 있어야 하며, 없으면 "'<범위>' 공개범위로 공유할 권한이 없습니다 …" 안내가 나옵니다.
- 에이전트는 만든 사람만 고칠 수 있습니다. 다른 사람이 고치기 화면을 열면 "만든 사람만 고칠 수 있습니다." 가 표시됩니다.
- 개인 에이전트는 한 사람당 최대 20개까지 만들 수 있습니다.