도움말
문의하기
aisight 도움말›문제 해결›관리자 점검 가이드
문제 해결

관리자 점검 가이드

사용자 문의가 들어왔을 때 관리자가 어디부터 확인하면 되는지 증상별로 정리했습니다. 원인을 좁히는 기본 순서는 맨 아래에 있습니다.

이 페이지 목차

채팅이 응답하지 않거나 느릴 때

증상 확인할 곳
모든 사용자의 채팅이 동작하지 않는다 LLM 엔드포인트에서 모델 연결 상태를 확인합니다. 엔드포인트가 없거나, 실패 상태인 모델이 기본값·유일한 라우팅 대상이면 채팅이 멈춥니다. 정상 모델을 메인 기본 모델로 지정하면 그 모델로 응답을 이어갈 수 있습니다.
사용자가 몰리는 시간에 요청이 대기·실패한다 동시 사용량이 상한에 도달했을 수 있습니다. 슬롯 현황에서 어떤 작업이 자리를 차지하고 있는지 확인한 뒤 동시 요청 상한·본딩 구성·폴백 라우팅을 검토합니다. '현재 사용할 수 있는 LLM 서버가 없습니다' 오류가 났다면 가용성 사고 로그에서 원인을 확인합니다.
같은 도구가 반복 실패해 답변이 중단된다 관리자 > 대시보드의 도구 / 대시보드 오류에서 최근 24시간 실패 건을 오류만 보기로 걸러 확인합니다. 원인이 자동 수집된 경험에서 배운 점을 검토·활성화하면 다음 세션부터 해당 Skill에 반영됩니다.

데이터가 맞지 않거나 동기화가 안 될 때

증상 확인할 곳
동기화가 실패하거나 오래 걸린다 데이터 소스 목록에서 상태를 정상·오류·대기로 필터링해 대상을 찾고, 마지막 구조 SYNC 시각과 연결 설정을 확인합니다. 원본 시스템의 연결 제한이나 권한이 바뀌었다면 연결 테스트부터 다시 진행합니다.
연결 오류가 자주 난다 데이터 소스의 동시 커넥션 수 (프로세스당) 값을 늘려 봅니다.
원본 DB를 바꿨는데 답변에 반영되지 않는다 통합(사본)해 둔 데이터 소스는 원본 변경이 자동 반영되지 않습니다. "재통합"으로 수동 재동기화합니다.
답변 품질이 전반적으로 낮다 설명 sync 단계의 컬럼 설명이 부실하면 쿼리 품질이 함께 떨어집니다. 데이터를 잘 아는 담당자가 설명을 보완합니다.
기존 보고서 수치와 다르다는 문의가 들어온다 누락된 필터나 통화 표시 형식 같은 조건을 해당 Skill의 시스템 프롬프트에 추가하면 즉시 반영됩니다.

사용자가 기능을 쓰지 못할 때

증상 원인과 조치
만든 Skill이 채팅 목록에 보이지 않는다 AI로 만든 Skill은 비활성(draft) 상태로 저장됩니다. 상세 화면에서 시스템 프롬프트와 허용 데이터 소스를 검토한 뒤 활성 상태 토글을 켭니다(켜면 사용자 드롭다운에 노출). 그리고 그 Skill이 사용자의 그룹에 부여돼 있어야 보입니다.
특정 사용자만 Skill을 못 쓴다 사용자 편집 화면의 허용 Skill, 또는 사용자가 속한 그룹에 해당 Skill이 들어 있는지 확인합니다. 허용 Skill이 하나도 없으면 도구 없이 일반 대화만 가능한 계정이 됩니다.
LLM API 릴레이를 켰는데 동작하지 않는다 개별 토글과 전역 토글의 이중 스위치 구조입니다. 전역 토글이 꺼져 있으면 개별 설정은 무효입니다.
커스텀 사용자 항목이 화면에 없다 관리자 > 권한 > 사용자 속성 정의에서 해당 속성을 먼저 정의해야 표시됩니다.

원인을 좁히는 기본 순서

  1. 사용량·호스트·모델 상태에서 서비스 전반의 이상 징후를 확인합니다.
  2. 문제가 발생한 사용자 또는 기간으로 세션을 좁힙니다.
  3. 운영 로그에서 질문, Skill, 도구 호출, 오류와 처리 시간을 확인합니다.
  4. 데이터 소스 sync·임베딩 같은 작업이 원인이라면 서버 작업 이력에서 실패 사유를 확인합니다.

마지막 수정: