도움말
문의하기
aisight 도움말›시작하기›관리자 첫 설정
따라 하기

관리자 첫 설정

사용자가 채팅에서 회사 데이터로 답을 받으려면 관리자가 먼저 네 가지를 준비하고, 마지막에 사용자 입장에서 확인해야 합니다. 아래 순서대로 진행하며, 단계마다 완료 여부를 확인하는 방법을 적어 두었습니다.

이 페이지 목차
시작하기 전에: 대시보드에서 시스템 상태 확인

관리자 > 대시보드에서 시스템 DB와 파일 저장소 카드가 「정상」인지 확인합니다. 파일 저장소는 사용자가 올린 첨부파일이 저장되는 곳입니다. 아직 설정되지 않았다면 카드에서 파일 저장소 설정 화면으로 이동해 S3 호환 객체 스토리지 또는 NFS·파일시스템 중 하나를 등록합니다. → 자세히: 관리자 대시보드

모델을 먼저 설정하는 이유는, 데이터 연결의 설명 자동 생성과 Skill의 AI로 만들기가 모두 모델을 쓰기 때문입니다. 순서를 바꾸면 중간에 앞 단계로 돌아가야 합니다.

이 문서의 예시

아래 예시는 매출 데모 DB(PostgreSQL)를 기준으로 합니다. 고객사(customers), 제품(products), 매출(sales), 영업 담당자(sales_reps) 네 테이블이 있는 작은 DB입니다. 실제 환경에서는 회사 DB로 바꿔 진행합니다.

1. 모델 설정

위치: 관리자 > LLM > 엔드포인트

준비할 것: 사용할 모델의 Provider, Base URL, API 키, 모델 ID

  1. 엔드포인트 추가를 눌러 Provider, 표시 이름, Base URL, API 키, 모델 ID를 입력합니다.
  2. 연결 테스트를 실행합니다. 엔드포인트는 연결 테스트 없이도 저장할 수 있지만, 저장 전에 확인해 두는 것이 안전합니다.
  3. 저장한 뒤 화면 위쪽 기본 모델 카드에서 이 모델을 메인(일반 채팅) 모델로 지정합니다.
  4. 사용자가 채팅에서 모델을 직접 고르게 하려면 사용자 노출을 켭니다. 끈 모델은 내부 처리용으로만 쓰입니다.

Skill의 도구 호출 기능을 쓰려면 모델이 도구 호출(Tool Calling) 표준을 지원해야 합니다. 지원하지 않는 모델은 일반 대화는 되지만 데이터 조회가 제대로 동작하지 않을 수 있습니다.

확인할 사항: 관리자 계정으로 채팅에서 "안녕"처럼 아무 질문이나 해 봅니다. 답이 오면 모델 설정은 끝난 것입니다. 이 단계에서는 데이터를 연결하기 전이라 일반 대화만 됩니다.

→ 자세히: LLM 엔드포인트

2. 데이터 연결

위치: 관리자 > 운영 > 데이터 소스

준비할 것: 연결할 DB의 호스트, 포트, 데이터베이스 이름, 접속 계정과 비밀번호, SSL 사용 여부. 조회만 되는 읽기 전용 계정을 권장합니다.

  1. 목록 위쪽 + RDBMS 추가를 누릅니다.
  2. 이름(예: 매출_DB_PostgreSQL), DB 종류(PostgreSQL), 호스트, 포트, 데이터베이스, 사용자, 비밀번호를 입력합니다.
  3. 연결 테스트를 통과하면 저장합니다.
  4. 저장하면 구조 → 통계 → 설명 sync가 백그라운드에서 자동으로 차례로 진행됩니다. 상세 화면의 상태 표시가 끝났는지 확인합니다.
  5. 설명이 LLM 유추로 표시된 컬럼은 데이터를 아는 담당자가 확인하고 고칩니다. 설명이 부실하면 답변 품질이 함께 떨어집니다. 결과가 이상하면 설명 재생성 등으로 다시 실행할 수 있습니다.

Excel/CSV로 관리하는 데이터라면 1~3단계 대신 Excel/CSV 업로드로 파일을 올립니다.

확인할 사항: 데이터 소스 상세 화면 위쪽에 구조 · 통계 · 설명 세 개가 모두 체크되어 있으면 됩니다. 예시 DB라면 이름 옆에 테이블 수 4가 보이고, customers를 고르면 "4개 컬럼 · 약 30행"과 컬럼별 통계·설명이 보입니다.

→ 자세히: 데이터 소스

3. Skill 만들기

위치: 관리자 > 운영 > Skill

  1. 목록 오른쪽 위 AI로 만들기를 누릅니다.
  2. 어떤 데이터로 무엇을 답하게 할지 한두 문장으로 씁니다. 볼 수 있는 범위를 나눠야 하면 그 조건도 함께 씁니다. 예: "매출 DB로 지역·업종별 매출과 영업 담당자별 실적을 답하게 해줘."
  3. Skill 만들기를 누르면 AI가 데이터 소스를 살펴보고 Skill을 만듭니다. 결과는 비활성(draft) 상태로 저장됩니다.
  4. 상세 화면에서 이름과 설명, 시스템 프롬프트, 사용할 도구, 권한 컬럼을 검토한 뒤 활성 상태의 사용자 드롭다운에 노출 토글을 켭니다. 실제로 사용자에게 보이려면 그 Skill이 사용자의 그룹에 부여돼 있어야 합니다.

이름과 설명은 사용자에게 그대로 보입니다. 사용자 채팅 화면에서는 Skill이 역할이라는 이름으로 나오고, 질문에 맞는 역할이 여러 개면 사용자가 이름과 설명을 보고 고릅니다. 다른 Skill과 구분되도록 작성합니다(예: "영업 실적 도우미: 지역·업종·담당자별 매출").

확인할 사항: Skill 목록에서 상태가 활성인지 봅니다. 아직 사용자에게 권한을 주기 전이라, 채팅 확인은 4단계를 마친 뒤에 합니다.

→ 자세히: Skill 만들기

4. 권한 주기

위치: 관리자 > 권한 > 그룹, 관리자 > 운영 > 사용자

  1. 그룹에서 같은 Skill을 쓸 사람들의 묶음(예: 영업팀)을 만들고, 3단계에서 만든 Skill을 넣습니다. 모든 사용자에게 줄 Skill이면 전체 사용자 그룹에 넣습니다.
  2. 사용자에서 계정을 만들거나 열어 그룹을 지정합니다. 그룹과 별개로 사용자에게 Skill을 직접 허용할 수도 있고, 둘은 함께 적용됩니다.
  3. 사용자·부서별로 볼 수 있는 행을 나눠야 하면 데이터 소스 목록 위쪽의 데이터소스 권한 강제를 켜고, 데이터 소스 상세 화면에서 사용자 범위 컬럼과 권한 룰을 정합니다. 기본값은 꺼짐이며, 꺼져 있으면 모든 사용자가 데이터 소스 전체를 볼 수 있습니다.
신규 계정에서 자주 하는 실수

허용 Skill도 그룹도 없이 계정 생성: 그 사용자는 데이터를 조회하지 못하고 일반 대화만 합니다. "데이터를 못 찾는다"는 문의가 접수되면 그룹과 허용 Skill부터 확인합니다.

데이터 소스 관리자 권한을 습관적으로 체크: 이 권한이 있으면 행 필터를 건너뛰고 데이터 소스 전체를 조회합니다. 꼭 필요한 사용자에게만 부여합니다.

→ 자세히: 그룹 · 사용자 · 권한 설정

5. 사용자 입장에서 확인하기

일반 사용자 권한의 테스트 계정으로 로그인해 실제로 질문해 봅니다. 예시 DB라면 이런 질문이 됩니다.

  • "지역별 매출 보여줘"
  • "영업 담당자별 실적 순위 알려줘"
  • "업종별 매출을 막대 차트로 그려줘"

답과 함께 표나 차트가 나오면 설정이 모두 완료된 것입니다. 일반 대화만 하거나 데이터를 못 찾으면 아래 순서로 확인합니다.

  1. 테스트 계정에 그 Skill이 있는지(그룹·허용 Skill)
  2. Skill이 활성 상태이고, 사용자의 그룹에 부여돼 있는지
  3. 데이터 소스의 구조·통계·설명이 모두 체크되어 있는지

해결되지 않으면 관리자 점검 가이드를 확인합니다. 사용자에게는 사용자 첫 시작을 안내하고, 이후 주기적으로 볼 화면은 운영 확인에 있습니다.

마지막 수정: