AX Knowledge Brain — 사용자 매뉴얼

🚀

시작하기

설치, 환경 설정, 첫 지식 입력까지

1

계정 생성 및 로그인

login.html에 접속하여 이메일과 비밀번호로 계정을 생성하세요. 이미 계정이 있다면 로그인 탭을 선택합니다. Supabase Auth 기반으로 안전하게 인증됩니다.

2

환경 설정 (API 키 입력)

대시보드 → 설정 → API 연동 메뉴에서 Gemini API Key를 입력합니다. AI 기능(자동 분류, 임베딩, 챗봇)은 이 키가 있어야 동작합니다.

3

첫 지식 입력

지식 입력 메뉴에서 텍스트, 파일(PDF/DOCX/TXT), URL, 또는 통화 기록을 입력합니다. 시스템이 자동으로 분류·임베딩·온톨로지 노드를 생성합니다.

4

첫 질문하기

RAG 챗봇 메뉴에서 질문을 입력하세요. AI가 입력된 지식 베이스를 검색하여 출처가 명시된 답변을 제공합니다.

ℹ️

권장 브라우저: Chrome 120+, Edge 120+, Safari 17+. 최신 브라우저를 사용하면 모든 기능이 최적으로 동작합니다.

📥

지식 입력

텍스트, 파일, URL, 통화기록, 일괄 입력

📝 텍스트 직접 입력

직접 작성한 텍스트를 입력합니다. 제목, 카테고리, 태그를 함께 입력하면 AI가 자동 분류를 수행합니다. 최대 50,000자까지 한 번에 입력 가능합니다.

📂 파일 업로드

PDF, DOCX, TXT, XLSX 형식의 파일을 드래그앤드롭으로 업로드합니다. 다중 파일 업로드를 지원하며, 각 파일이 개별 지식 노드로 저장됩니다.

🌐 URL 크롤링

웹 페이지 URL을 입력하면 시스템이 페이지 내용을 자동으로 수집하고 지식으로 저장합니다. 매주 자동 재수집(선택 가능)을 설정할 수 있습니다.

📞 통화기록 입력

STT(Speech-to-Text)로 변환된 통화 스크립트를 붙여넣으면 AI가 핵심 인사이트를 추출하고 구조화된 지식으로 변환합니다.

1

일괄 입력 (Bulk Import)

CSV 또는 JSON 형식으로 다수의 지식 항목을 한 번에 가져올 수 있습니다. 설정 → 가져오기에서 템플릿을 다운로드하여 사용하세요.

⚠️

주의: 파일당 최대 크기는 50MB입니다. 이미지 파일(PNG/JPG)은 OCR 처리 후 텍스트로 저장됩니다. 민감 정보는 암호화되어 저장됩니다.

🤖

RAG 챗봇

질문하기, 출처 확인, 세션 관리

1

질문 입력

챗봇 입력창에 자연어로 질문을 입력합니다. 예: "지난달 영업 회의에서 논의된 주요 이슈는?" — 시스템이 관련 지식 노드를 자동으로 검색합니다.

2

출처 확인

답변 하단에 출처 카드가 표시됩니다. 각 출처 카드를 클릭하면 원본 지식 노드로 이동하여 내용을 전체 확인할 수 있습니다. 신뢰도 점수(0~100)도 함께 표시됩니다.

3

대화 세션 관리

각 대화는 별도의 세션으로 저장됩니다. 좌측 패널에서 이전 세션을 불러오거나, 세션명을 변경하거나, 특정 세션을 즐겨찾기에 추가할 수 있습니다.

// 챗봇 API 직접 호출 예시
POST /api/rag-chat
{
  "question": "최근 6개월 주요 고객 피드백 요약해줘",
  "session_id": "sess_abc123",
  "top_k": 5,
  "threshold": 0.7
}
      

🔍

검색

키워드 검색, 의미 검색, 필터 사용법

검색 유형	방식	장점	단점
키워드 검색	Full-text Search (PostgreSQL)	빠름, 정확한 단어 매칭	동의어, 문맥 처리 불가
의미 검색	Vector Similarity (pgvector)	맥락·의미 이해, 유사 개념 탐지	상대적으로 느림
하이브리드	키워드 + 벡터 혼합	정확성 + 유연성 동시 확보	기본 모드

1

필터 사용법

카테고리(분류), 날짜 범위, 태그, 입력 소스(파일/URL/직접입력)로 결과를 좁힐 수 있습니다. 필터는 AND 조건으로 결합됩니다.

📊

대시보드

KPI 이해, 차트 해석

📦 총 지식 노드 수

현재 저장된 전체 지식 항목의 수입니다. 신규 입력 시 실시간으로 업데이트됩니다.

💬 챗봇 질의 횟수

이번 달 RAG 챗봇을 통해 발생한 질의 총 횟수. 7일/30일 추세 그래프로 확인합니다.

⭐ 평균 신뢰도

검색 결과의 평균 유사도 점수. 70% 이상이면 지식 품질이 양호한 상태입니다.

🗺️ 온톨로지 노드 수

자동 생성된 개념 노드와 관계(엣지)의 총 수. 지식 체계의 복잡도를 나타냅니다.

✅

팁: 대시보드는 매일 자정에 자동 갱신됩니다. 실시간 데이터가 필요하면 우측 상단 새로고침 버튼을 누르세요.

🕸️

온톨로지

노드 이해, 관계 탐색

1

노드(Node) 이해

각 노드는 하나의 개념·엔티티(사람, 조직, 이벤트, 개념 등)를 표현합니다. 노드를 클릭하면 연결된 지식 항목 목록과 관계 노드가 표시됩니다.

2

관계(Edge) 탐색

노드 간 엣지는 관계 유형(포함, 참조, 생성, 영향 등)으로 구분됩니다. 두 노드 사이의 최단 경로를 탐색하는 "경로 찾기" 기능을 활용하세요.

3

3D 시각화

온톨로지 그래프를 3D로 회전·확대하며 탐색할 수 있습니다. 클러스터별로 색상이 구분되며, 노드 크기는 연결 수(중심성)에 비례합니다.

✨

AI 기능

Gemini 연동, 자동 분류, 추천

🤖 Gemini 연동

Google Gemini Pro를 기반으로 텍스트 임베딩, 자동 요약, 질문 응답이 동작합니다. API 키를 설정 → AI 설정에서 입력하면 즉시 활성화됩니다.

🏷️ 자동 분류

입력된 지식을 AI가 카테고리·태그로 자동 분류합니다. 분류 결과는 수동으로 수정할 수 있으며, 수정 데이터가 모델 미세조정에 활용됩니다.

💡 연관 지식 추천

현재 열람 중인 지식 노드와 의미적으로 유사한 항목을 우측 패널에 자동 추천합니다. 추천 신뢰도가 80% 이상인 항목은 강조 표시됩니다.

📋 자동 요약

긴 문서를 AI가 3줄 이내로 요약합니다. 요약 요청 버튼을 누르거나, 지식 목록에서 일괄 요약 처리가 가능합니다.

⚡

스킬 & 하네스

지식을 업무 스킬로 전환하고, 플로우로 묶는다

⚡ 스킬이란?

지식 항목에서 핵심 노하우를 추출한 실행 가능한 단위. Gemini AI가 자동으로 요약(Summary), 방법(How-to), 활용 사례(Use-case)를 생성합니다.

🔗 하네스(Harness)란?

여러 스킬을 순서대로 조합한 업무 플로우. 예: "신규 고객 온보딩" = 스킬1(자기소개) → 스킬2(니즈 파악) → 스킬3(솔루션 제안).

1

스킬 생성

지식 관리 페이지에서 항목을 선택 → "스킬로 만들기" 클릭. AI가 자동으로 제목, 요약, 방법, 활용사례를 추출합니다. 공개/비공개 설정으로 팀 공유 여부를 결정합니다.

2

하네스 구성

스킬/하네스 페이지에서 "+ 새 하네스" 클릭 → 스킬을 순서대로 추가합니다. 각 스킬에 메모를 달고, 드래그로 순서를 재배치합니다.

3

스킬 적용 (Apply)

스킬 카드의 "적용" 버튼을 클릭하면 적용 횟수가 카운트됩니다. 가장 많이 적용된 스킬이 상단에 표시되어 핵심 역량을 파악할 수 있습니다.

ℹ️

팁: 공개 스킬은 전사 구성원 누구나 열람할 수 있습니다. 우수 스킬을 공개하여 조직 전체의 역량을 키우세요.

📚

지식책 큐레이션

지식 항목을 모아 책으로 엮는다

📚 지식책이란?

여러 지식 항목을 주제별로 묶은 컬렉션. 예: "Q3 영업 전략", "AI 도구 사용법", "고객 대응 노하우" 등의 주제로 지식을 체계화합니다.

🔖 태그 & 큐레이션

지식 항목에 태그를 달면 자동으로 관련 책에 추천됩니다. 이모지 커버로 시각적으로 구분하고, 순서(sort_order)를 지정해 읽기 흐름을 만듭니다.

1

책 만들기

지식책 페이지에서 "+ 새 지식책" 클릭 → 제목, 설명, 이모지 커버를 설정합니다. 공개 설정 시 팀원이 열람 가능합니다.

2

지식 항목 추가

책 상세 → 검색창에서 지식 제목을 입력하여 항목을 찾고 추가합니다. 이미 추가된 항목은 중복 추가되지 않습니다.

3

공유 및 활용

완성된 지식책을 공개하면 전사 대시보드에 표시됩니다. AI 챗봇에서 "○○ 책의 내용을 요약해줘"로 책 전체를 질의할 수 있습니다.

🏢

부서 관리 (ERP)

부서·팀 계층 구조, 기여 분석, 수정 이력

🏢 부서 계층

부서(Level 1) → 팀(Level 2) 2단계 계층 구조. 기본 제공: 경영지원, 인사, 재무/회계, 영업, 마케팅, 개발/IT, 기획/전략, 운영, 고객지원, 연구개발 (총 10개 부서, 12개 팀).

📊 부서별 기여 현황

대시보드에서 부서·개인별 지식 기여 건수를 막대 차트로 확인합니다. 상위 기여자(TOP 8)를 선정하여 지식 문화 형성을 촉진합니다.

📋 수정 이력 추적

지식 항목이 수정될 때마다 before/after 데이터, 변경 필드, 수정자 정보가 자동 기록됩니다. 관리 페이지에서 개별 항목의 전체 수정 이력을 조회할 수 있습니다.

🏷️ 지식 종류 (9종)

명시지·암묵지·경험지·절차지·개념지·관계지·맥락지·감성지·실행지·메타지식 — 10가지 유형으로 지식의 성질을 분류하여 더 정밀하게 관리합니다.

ℹ️

DB 마이그레이션: 부서/팀 기능은 supabase-migration-v3.sql을 Supabase SQL 에디터에서 실행한 후 사용 가능합니다. 첫 실행 시 기본 부서 데이터가 자동 삽입됩니다.

🔌

API 연동

외부 플랫폼 연결 방법

// 지식 추가 API
POST /api/knowledge
Authorization: Bearer {API_TOKEN}
Content-Type: application/json

{
  "title": "신규 고객 미팅 내용",
  "content": "...",
  "category": "영업",
  "tags": ["고객", "미팅"],
  "source_type": "manual"
}
      

// 검색 API
GET /api/search?q=영업전략&mode=hybrid&limit=10
Authorization: Bearer {API_TOKEN}
      

1

API 토큰 발급

설정 → API 토큰 메뉴에서 토큰을 생성합니다. 토큰은 한 번만 표시되므로 즉시 복사·저장하세요. 권한 범위(읽기/쓰기)를 개별 설정할 수 있습니다.

2

Webhook 설정

새 지식이 추가되거나 챗봇 질의가 발생할 때 외부 URL로 이벤트를 전송합니다. Slack, Teams, Zapier와 연동이 가능합니다.

❓

FAQ

자주 묻는 질문

현재 플랜에 따라 다릅니다. Free 플랜은 500개, Pro 플랜은 10,000개, Max 플랜은 무제한입니다. 요금제는 설정 → 플랜에서 확인하고 업그레이드할 수 있습니다.

검색 임계값(threshold)을 낮추거나(기본 0.7 → 0.5), 검색 모드를 "의미 검색"으로 변경해 보세요. 그래도 관련 지식이 없으면 해당 내용을 먼저 지식 베이스에 추가해야 합니다.

모든 데이터는 Supabase(PostgreSQL) 서버에 암호화되어 저장됩니다. AES-256 암호화, SOC 2 Type II 준수, GDPR 대응 체계를 갖추고 있습니다. 데이터는 사용자 계정별로 완전히 격리됩니다.

AI API 키가 올바르게 설정되어 있는지 확인하세요. 설정 → AI 설정 → API 키 테스트 버튼으로 연결 상태를 확인할 수 있습니다. 또한 텍스트가 100자 미만인 경우 노드 생성이 생략될 수 있습니다.

Pro 플랜 이상에서 팀 기능을 지원합니다. 관리자가 팀원을 초대하고, 읽기 전용 / 편집자 / 관리자 권한을 부여할 수 있습니다. 공유 지식 베이스와 개인 지식 베이스를 분리 관리할 수 있습니다.

💬

문의 / 지원

도움이 필요하실 때

📧 이메일 문의

jaiwshim@gmail.com으로 문의를 보내주세요. 영업일 기준 1일 이내에 답변 드립니다.

📖 기술 문서

copyright.html 및 patent.html에서 시스템 구조와 기술 명세를 확인할 수 있습니다.

🐛 버그 리포트

오류 발생 시 우측 하단 ? 버튼 → 버그 리포트를 선택하면 자동으로 오류 로그가 첨부되어 전송됩니다.

🔄 업데이트 내역

설정 → 업데이트 내역에서 최신 기능 추가 및 버그 수정 내역을 확인할 수 있습니다.

✅

AX Knowledge Brain 사용자 매뉴얼