지식 관리란?
wiiiv의 지식 관리는 여러분이 가진 문서를 등록하고, wiiiv가 대화와 워크플로우에서 그 내용을 직접 참조하도록 하는 기능입니다. API 명세서, 사내 매뉴얼, 기술 문서, 데이터 사전 등 어떤 문서든 등록할 수 있습니다.
일반적인 AI 시스템은 문서를 작은 조각(chunk)으로 잘라 키워드 유사도로 검색합니다. 이 방식은 맥락이 끊기고, 관련 없는 조각이 선택되는 문제가 있습니다.
wiiiv는 다릅니다. 등록된 문서를 조각내지 않고 원문 그대로 보관합니다. 요청이 들어오면 LLM이 문서 목록을 읽고 어떤 문서가 필요한지 직접 판단하여, 선택된 문서의 전문을 참조합니다. 문서를 찢어 바닥에 뿌리는 것이 아니라, 도서관에서 필요한 책을 골라 읽는 방식입니다.
따라서 문서를 요약하거나 가공할 필요 없이, 원본을 그대로 등록하면 됩니다.
| 일반 AI (RAG) | wiiiv Knowledge | |
|---|---|---|
| 저장 | 문서를 조각(chunk)으로 분할 후 벡터 저장 | 원문 전체를 그대로 보관 |
| 검색 | 벡터 유사도로 조각 검색 | LLM이 문서 목록을 읽고 직접 선별 |
| LLM 전달 | 유사도 높은 조각 몇 개 | 선별된 문서의 전문 |
| 맥락 | 조각 경계에서 맥락이 끊김 | 원문 전체이므로 맥락 온전 |
| 요약 | 토큰 절약을 위해 종종 필요 | 불필요 — 원본이 더 정확 |
| 규모 대응 | 문서 수에 관계없이 동일한 방식 | 3단계 자동 전환 (소규모: 전부 로드 / 중규모: LLM 선별 / 대규모: 필요 시 탐색) |
지식 관리 화면
좌측 사이드바에서 Knowledge 메뉴를 선택하면 지식 관리 화면으로 이동합니다. 화면은 크게 두 영역으로 나뉩니다. 왼쪽은 등록된 문서 목록, 오른쪽은 선택한 문서의 상세 정보입니다.
Slack Web API 명세서
Slack — 팀 커뮤니케이션 및 업무 자동화 플랫폼
Base URL: https://slack.com/api
인증: Bot Token (Authorization: Bearer xoxb-...)
공식 문서: https://api.slack.com/methods
인증 (Authentication)
Slack API는 Bot Token 방식으로 인증합니다...
왼쪽 패널 상단의 문서 검색 입력란으로 등록된 문서를 이름으로 빠르게 필터링할 수 있습니다. 문서를 선택하면 오른쪽에 종류, 크기, 등록일, 전문 내용이 표시됩니다.
문서 등록하기
"새 지식" 버튼을 누르면 업로드 영역이 나타납니다. 파일을 직접 끌어다 놓거나, "파일 선택" 버튼으로 탐색할 수 있습니다. 여러 파일을 한 번에 등록할 수도 있습니다.
지원하는 파일 형식
파일이 업로드되면 wiiiv가 자동으로 내용을 분석하여 문서 카탈로그에 등록합니다. 대화 중 관련 주제가 나오면 LLM이 카탈로그에서 필요한 문서를 선별하여 전문을 참조합니다.
문서 상세 보기
등록된 문서를 선택하면 오른쪽 패널에 상세 정보가 표시됩니다.
문서 정보
문서의 종류(Markdown, JSON, XML, Text), 크기, 등록일이 표시됩니다. 종류는 파일 확장자와 내용을 분석하여 자동으로 판별됩니다. 태그나 카테고리가 설정된 경우 함께 표시됩니다.
메모
각 문서에 메모를 남길 수 있습니다. "이 문서는 SkyMall API v2 기준이며, v3에서 변경된 엔드포인트가 있음"처럼 문서에 대한 부가 정보를 기록해두면 나중에 관리할 때 도움이 됩니다.
전문 보기
문서의 전체 내용을 확인할 수 있습니다. Markdown 문서는 렌더링된 형태로, JSON은 구문 강조가 적용된 형태로, 일반 텍스트는 원문 그대로 표시됩니다.
이름 변경
문서 목록에서 이름을 더블클릭하면 바로 수정할 수 있습니다. 이름 옆의 연필 아이콘을 눌러도 됩니다. Enter를 누르면 저장, Escape를 누르면 취소됩니다.
다운로드와 삭제
문서 상세 화면 우측 상단의 Download 버튼으로 원본 파일을 내려받을 수 있고, Delete 버튼으로 문서를 삭제할 수 있습니다. 삭제 시 확인 대화상자가 나타납니다.
문서 검색
문서 상세 화면의 "문서 검색" 섹션에서 등록된 지식을 의미 기반으로 검색할 수 있습니다. 이것은 wiiiv가 대화 중에 내부적으로 수행하는 것과 동일한 검색입니다. 검색 결과를 직접 확인하여 등록한 지식이 잘 활용되는지 테스트할 수 있습니다.
검색 결과의 점수(score)는 질문과 문서 내용의 유사도를 나타냅니다. 0.8 이상이면 높은 관련성(녹색), 0.5~0.8이면 보통(노란색), 0.5 미만이면 낮은 관련성(빨간색)으로 표시됩니다.
관리자는 Top K(최대 결과 수)와 Min Score(최소 유사도 임계값)를 조절할 수 있습니다. 기본값은 Top K = 5, Min Score = 0입니다.
wiiiv가 지식을 활용하는 방식
문서를 등록하면, wiiiv는 대화와 워크플로우 실행 시 자동으로 관련 지식을 찾아 참조합니다. 별도로 "이 문서를 참고해"라고 지시할 필요가 없습니다.
예를 들어, SkyMall API 명세서를 등록한 상태에서 "SkyMall 상품 목록을 조회해줘"라고 요청하면, wiiiv는 자동으로 해당 API 명세서에서 상품 조회 엔드포인트, 인증 방법, 응답 형식을 찾아 정확한 API 호출을 수행합니다.
1. 무선 키보드 MK-200 — 재고: 2개
2. USB-C 허브 7포트 — 재고: 1개
3. 보조배터리 20000mAh — 재고: 3개
총 3건의 상품이 재고 부족 상태입니다.
wiiiv가 지식을 참조했을 때는 응답 하단에 어떤 문서를 참조했는지 표시됩니다. 이를 통해 AI의 답변이 어디에 근거한 것인지 투명하게 확인할 수 있습니다.
API 명세서 등록 후: 자격증명 연결
API 명세서를 등록하면, wiiiv가 명세서에 포함된 Base URL을 인식하여 설정 > 연결 탭에 해당 서버의 카드를 자동으로 표시합니다. 여기에서 API 서버의 ID/Password를 등록하면, wiiiv가 대화 중에 해당 API를 직접 호출할 수 있게 됩니다.
"접속 정보 변경" 또는 "ID/PW 등록" 버튼을 누르면 모달 창이 열립니다. API 서버에 접속할 아이디와 비밀번호를 입력하세요.
저장할 때 wiiiv가 입력한 자격증명으로 자동 연결 테스트를 수행합니다. 인증에 성공하면 저장되고, 실패하면 오류 메시지가 표시됩니다. 자격증명은 암호화되어 저장되며, 등록 후 다시 조회할 수 없습니다.
전체 문서와 프로젝트 문서
wiiiv의 지식은 전체(Global)와 프로젝트(Project) 두 가지 범위로 운영됩니다.
| 구분 | 전체 문서 (Global) | 프로젝트 문서 (Project) |
|---|---|---|
| 접근 | 사이드바 Knowledge 메뉴 | 프로젝트 > 지식 탭 |
| 관리 권한 | 관리자만 | 프로젝트 멤버 |
| 활용 범위 | 모든 대화와 워크플로우 | 해당 프로젝트의 대화와 워크플로우 |
| 용도 | 조직 공통 문서 (사내 규정, 공통 API 등) | 프로젝트 전용 문서 (특정 서비스 명세 등) |
프로젝트 상세 화면에서 지식 탭을 선택하면, 해당 프로젝트 전용 지식 관리 화면으로 이동합니다. 화면 구성과 기능은 전체 문서와 동일하지만, 해당 프로젝트에만 적용되는 문서를 관리합니다.
효과적인 지식 등록을 위한 팁
1. 구조화된 문서가 좋습니다
제목, 소제목, 목록이 잘 정리된 Markdown 문서가 가장 효과적입니다. 잘 정리된 문서는 LLM이 관련 주제가 나올 때 적절한 문서를 정확하게 선별하는 데 도움이 됩니다.
2. API 명세서는 상세하게
API 명세서를 등록할 때는 다음 정보가 포함되어야 합니다: 엔드포인트 URL, HTTP 메서드, 요청 파라미터, 응답 형식, 인증 방법, 에러 코드. 이 정보가 충분해야 wiiiv가 API를 정확히 호출할 수 있습니다.
3. 하나의 주제 = 하나의 문서
여러 주제를 하나의 큰 문서에 넣기보다, 주제별로 분리하는 것이 좋습니다. "SkyMall API 명세서"와 "SkyStock API 명세서"를 각각 등록하면, wiiiv가 필요한 문서만 정확히 찾아 참조할 수 있습니다.
4. 등록 후 검색으로 확인
문서를 등록한 후에는 "문서 검색" 기능으로 꼭 테스트해보세요. 실제 대화에서 물어볼 법한 질문으로 검색하여 적절한 내용이 높은 점수로 반환되는지 확인합니다. 점수가 낮거나 엉뚱한 내용이 나온다면 문서 구조를 개선해보세요.