BibGenie 문서문제 해결
흔히 발생하는 BibGenie 오류를 진단하고 모델, 네트워크 및 설정 문제를 해결하세요.
이 페이지는 흔히 발생하는 BibGenie 오류를 진단하고 적절한 해결 방법을 선택하는 데 도움을 줍니다.
먼저 업데이트하세요
문제를 해결하기 전에 최신 버전의 BibGenie를 사용 중인지 확인하세요. 모델, Zotero 호환성 및 네트워크 관련 문제 중 상당수는 새 버전에서 이미 해결되었을 수 있습니다.
오류 세부 정보가 중요합니다
오류 대화 상자에는 모델 이름, 요청 URL, 제공업체 응답, 실패 원인 등 유용한 정보가 포함되는 경우가 많습니다. 설정을 변경하기 전에 주의 깊게 읽어보세요.
ModelNotSupported
표시되는 증상
제목이 "ModelNotSupported"인 대화 상자가 나타납니다.
가능한 원인
선택한 모델이 현재 입력 유형을 지원하지 않습니다. 이미지 입력을 지원하지 않는 모델에 이미지를 보낼 때 자주 발생합니다.
해결 방법
이미지나 스크린샷 입력을 위한 시각 기능 등 필요한 기능을 지원하는 모델을 선택하세요.
사용자 지정 모델이 이미지를 지원하는 것이 확실하다면, 사용자 지정 모델 설정에서 해당 모델이 시각(Vision) 모델로 표시되어 있는지 확인하세요.
작업에 도구 사용이 필요하다면 모델이 **함수 호출(Function Calling)**을 지원하는지 확인하세요.
AI_APICallError
표시되는 증상
제목이 "AI_APICallError"인 대화 상자가 나타납니다.
가능한 원인
모델 API 요청이 실패했습니다. 유효하지 않은 API 키, 잘못된 모델 ID, 잘못된 기본 URL, 제공업체의 응답 시간 초과 또는 네트워크 장애가 일반적인 원인입니다.
일반적인 오류 유형
유효하지 않거나 만료된 키는 다음과 같은 메시지를 발생시킬 수 있습니다.
Unauthorized Failure reason: Authentication Fails
(auth header format should be Bearer sk-...)Incorrect API key provided.API 키가 빠짐없이 입력되었고, 활성 상태이며, 선택한 제공업체의 키인지 확인하세요.
해결 방법
NetworkError
표시되는 증상
TypeError: NetworkError when attempting to fetch resource.와 같은 오류가 나타납니다.
가능한 원인
BibGenie가 제공업체 엔드포인트에 연결할 수 없습니다.
가능한 원인:
- 로컬 모델 서버가 실행 중이 아닙니다.
- 기본 URL이나 포트가 올바르지 않습니다.
- 방화벽, 프록시 또는 네트워크 정책이 요청을 차단합니다.
- 제공업체 엔드포인트를 일시적으로 사용할 수 없습니다.
- 설정한 제공업체가 현재 환경에서 브라우저 측 요청을 지원하지 않습니다.
첨부 파일 또는 컨텍스트 문제
BibGenie가 PDF, 스냅샷, 노트 또는 선택한 텍스트를 읽을 수 없는 경우:
- 파일이 이 기기에 있는지 확인하세요.
- Zotero 동기화를 사용한다면 첨부 파일이 로컬에 다운로드되었는지 확인하세요.
- WebDAV 사용자는 Zotero 파일 동기화가 작동하는지 확인하세요.
- Zotero에서 첨부 파일을 직접 열어보세요.
- 리더 상태가 갱신되지 않은 것 같다면 Zotero를 다시 시작하세요.
MCP 연결 문제
외부 MCP 클라이언트가 연결할 수 없는 경우:
- MCP 서버 활성화가 켜져 있는지 확인하세요.
- 서버 URL을 다시 복사하세요.
- MCP 설정에서 연결 테스트를 클릭하세요.
- Zotero가 계속 실행 중인지 확인하세요.
- 신뢰하지 않는 클라이언트의 연결을 해제하세요.
도움 받기
문제가 계속되면 도움을 요청할 때 다음 정보를 보내주세요.
- BibGenie 버전
- Zotero 버전
- 운영체제
- 공식 모델과 사용자 지정 모델 중 어느 것을 사용하는지
- 제공업체 유형 및 모델 ID
- 전체 오류 메시지
- 특정 PDF, 노트 또는 컨텍스트 유형에서 문제가 발생하는지
지원 채널
BibGenie Discord 커뮤니티에 참여하여 지원을 받을 수 있습니다.