문제 해결
THAKI Agent Platform 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 안내합니다.
로그인 문제
로그인이 안 됩니다
증상: 로그인 버튼을 클릭해도 반응이 없거나 에러가 발생합니다.
해결 방법:
- 아이디와 비밀번호가 정확한지 확인합니다
- Caps Lock이 켜져 있는지 확인합니다
- 브라우저 캐시를 지우고 다시 시도합니다
- 다른 브라우저에서 시도해 봅니다
세션이 만료되었습니다
증상: "세션이 만료되었습니다" 메시지가 표시됩니다.
해결 방법:
- 페이지를 새로고침합니다
- 다시 로그인합니다
자동 로그아웃
보안을 위해 일정 시간 동안 활동이 없으면 자동으로 로그아웃됩니다.
에이전트 문제
에이전트가 채팅 목록에 표시되지 않습니다
증상: 생성한 에이전트가 채팅 페이지에 보이지 않습니다.
해결 방법:
- 에이전트가 활성화(Active) 상태인지 확인합니다
- 올바른 프로젝트가 선택되어 있는지 확인합니다
- 페이지를 새로고침합니다
에이전트 활성화가 안 됩니다
증상: Activate 버튼을 클릭해도 활성화되지 않습니다.
해결 방법:
- 에이전트에 필수 설정이 완료되었는지 확인합니다
- 연결된 MCP 서버가 정상 상태인지 확인합니다
- 브라우저 콘솔에서 에러 메시지를 확인합니다
데이터소스 문제
파일 업로드가 실패합니다
증상: 파일 업로드 시 에러가 발생합니다.
해결 방법:
- 파일 형식이 지원되는지 확인합니다 (PDF, TXT, MD, DOCX, CSV)
- 파일 크기가 100MB 이하인지 확인합니다
- 파일이 손상되지 않았는지 확인합니다
- 네트워크 연결 상태를 확인합니다
파일 처리가 오래 걸립니다
증상: 파일 상태가 "Processing"에서 오랫동안 변하지 않습니다.
해결 방법:
- 대용량 파일(10MB 이상)은 처리에 시간이 걸립니다 (최대 30분)
- 여러 파일을 동시에 업로드한 경우 순차적으로 처리됩니다
- 1시간 이상 변화가 없으면 파일을 삭제하고 다시 업로드합니다
파일 처리가 실패했습니다
증상: 파일 상태가 "Failed"로 표시됩니다.
해결 방법:
- 파일 형식이 올바른지 확인합니다
- PDF의 경우 스캔 이미지만 있는 파일은 처리되지 않을 수 있습니다
- 암호화된 파일은 지원되지 않습니다
- 파일을 다른 형식으로 변환하여 다시 시도합니다
MCP 서버 문제
MCP 서버가 설치되지 않습니다
증상: Install 버튼 클릭 후 설치가 진행되지 않습니다.
해결 방법:
- 네트워크 연결을 확인합니다
- 다른 MCP 서버를 먼저 설치해 봅니다
- 페이지를 새로고침하고 다시 시도합니다
MCP 서버가 활성화되지 않습니다
증상: Activate 버튼이 반응하지 않거나 에러가 발생합니다.
해결 방법:
- MCP 서버가 정상적으로 설치되었는지 확인합니다
- 필요한 인증 정보가 입력되었는지 확인합니다
- 서버 상태를 확인합니다
도구 호출이 실패합니다
증상: 채팅 중 도구 호출 시 에러가 발생합니다.
해결 방법:
- MCP 서버가 활성화 상태인지 확인합니다
- 해당 도구의 사용 권한이 있는지 확인합니다
- 입력 형식이 올바른지 확인합니다
채팅 문제
에이전트가 응답하지 않습니다
증상: 메시지를 보내도 에이전트가 응답하지 않습니다.
해결 방법:
- 에이전트가 활성화 상태인지 확인합니다
- 네트워크 연결을 확인합니다
- 잠시 후 다시 시도합니다
- 페이지를 새로고침합니다
응답이 잘립니다
증상: 에이전트 응답이 중간에 끊깁니다.
해결 방법:
- "계속해줘" 또는 "이어서 말해줘"라고 요청합니다
- 질문을 더 구체적으로 나누어 요청합니다
응답이 정확하지 않습니다
증상: 에이전트가 잘못된 정보를 제공합니다.
해결 방법:
- 질문을 더 구체적으로 작성합니다
- 관련 데이터소스가 올바르게 연결되었는지 확인합니다
- 데이터소스의 문서가 최신 상태인지 확인합니다
성능 문제
페이지 로딩이 느립니다
해결 방법:
- 브라우저 캐시를 지웁니다
- 불필요한 브라우저 확장 프로그램을 비활성화합니다
- 네트워크 연결 상태를 확인합니다
- 다른 브라우저에서 시도합니다
브라우저가 멈춥니다
해결 방법:
- 페이지를 새로고침합니다
- 브라우저를 재시작합니다
- 메모리가 부족한 경우 다른 탭을 닫습니다
지원 요청
위 방법으로 해결되지 않는 경우:
- 에러 메시지: 정확한 에러 메시지를 기록합니다
- 재현 단계: 문제가 발생한 정확한 단계를 기록합니다
- 브라우저 정보: 사용 중인 브라우저와 버전을 확인합니다
- 스크린샷: 가능하면 문제 화면을 캡처합니다
관리자에게 위 정보와 함께 문의해 주세요.