ReplyRabbit 문제 해결
대부분의 ReplyRabbit 문제는 세 가지 중 하나로 귀결됩니다. API 키가 없거나 잘못됨, 플랜 등급에서 허용하지 않는 제공자 사용, 오래된 FreeScout 캐시입니다. 아래 해당 섹션을 확인하세요. 각 문제는 먼저 증상을 나열한 다음 해결 방법을 제시합니다.
초안이 생성되지 않음
증상: 대화를 열었지만 AI 초안이 나타나지 않고 아무 일도 일어나지 않는 것 같습니다.
수정: 메일박스의 ReplyRabbit 설정을 여세요 (메일함 > 설정 > ReplyRabbit) 그리고 제공업체가 선택되었고 API 키가 설정되었는지 확인하세요. Free 등급에서는 사용 가능한 유일한 제공업체가 OpenAI이므로 다른 것을 선택했다면 OpenAI로 다시 전환하거나 업그레이드하세요. 그런 다음 작업 중인 메일함에 ReplyRabbit이 활성화되어 있는지 확인하세요. 초안은 활성화된 메일함에만 생성됩니다.
잘못된 API 키 또는 공급자 오류
증상: 잘못된 키, 인증 실패 또는 연결할 수 없는 공급자에 대한 오류가 표시됩니다.
수정: 키에 오타나 불필요한 공백이 없는지 다시 확인하고, 실제로 선택한 제공자의 키인지 확인하며(OpenAI 키는 Anthropic에서 작동하지 않음), 제공자 대시보드에서 키에 여전히 크레딧과 접근 권한이 있는지 확인하세요. 잔액이 없거나 접근이 취소된 키도 같은 오류를 발생시킵니다.
PHP 업그레이드 후 오류
증상: 서버 업그레이드 후(예: PHP 8.5가 포함된 Ubuntu 26.04로), 연결 테스트 실패하거나 백그라운드 작업이 중단되며, FreeScout 로그에 다음으로 끝나는 메시지가 표시됩니다 is deprecated since 8.5.
수정: 다음에서 ReplyRabbit 및 기타 모듈을 최신 상태로 유지하세요 관리 > 모듈, 그런 다음 실행 php artisan freescout:clear-cache 그리고 php artisan queue:restart. ReplyRabbit은 PHP 8.0부터 8.5까지 지원합니다. 참조 FreeScout에서 "deprecated since 8.5" 오류 수정 메시지가 어느 모듈에서 오는지 찾기 위해.
ReplyRabbit 메뉴가 없습니다
증상: ReplyRabbit을 설치한 후 FreeScout 메뉴나 설정에 나타나지 않습니다.
수정: 먼저 다음에서 모듈이 활성화되어 있는지 확인하세요 관리 > 모듈. 그런 다음 FreeScout 루트에서 캐시를 비우세요:
php artisan freescout:clear-cache여전히 누락되었다면 사용자의 권한을 확인하세요. 관련 사서함이나 관리자 설정에 접근할 수 없는 사용자는 ReplyRabbit 옵션을 볼 수 없습니다.
잠시 후 초안 중단됨
증상: 초안이 처음에는 작동했지만 월 중순 이후 생성이 중단되었습니다.
수정: Free 티어는 월 10개의 초안을 허용합니다. 이 한도에 도달하면 다음 달까지 초안이 일시 중지됩니다. Pro와 Team은 초안 한도가 없습니다. 모든 플랜에서 사서함의 다음 조건이 충족되면 초안도 일시 중지됩니다 월간 토큰 예산 이 소진되었으므로 해당 설정도 확인하세요(0은 예산 없음을 의미).
프롬프트 캐싱은 월간 토큰 수를 변경하지 않습니다
증상: 반복되는 초안은 제공자 프롬프트 캐싱 대상이 될 수 있지만, ReplyRabbit의 토큰 사용량에는 여전히 전체 입력 및 출력 합계가 표시됩니다.
수정: 이는 예상된 동작입니다. ReplyRabbit은 월간 예산을 보수적으로 유지하고, 제공자가 캐시된 입력을 다르게 청구하더라도 총 토큰을 계산합니다. 제공자 캐시 절감은 제공자, 모델, 반복되는 프롬프트 접두사, 제공자 보고에 따라 달라집니다. Anthropic 캐시 제어는 적격한 반복 초안 작업에만 사용되며 지원되지 않으면 일반 생성으로 대체됩니다.
Linear 티켓이 생성되지 않음
증상: 다음 작업이 감지되었지만 Linear 티켓이 생성되지 않았습니다.
수정: ReplyRabbit 설정에서 Linear API 키, 선택한 팀, 티켓이 확인을 기다리는 보류 상태에 있는지 확인하세요. 또한 티어에 Linear가 포함되어 있는지 확인하세요: 수동 Linear 티켓 생성은 Pro 기능이고, 자동 티켓 생성은 Team 기능입니다.
Jira 이슈가 생성되지 않음
증상: 대화에 엔지니어링 작업이 필요하지만 Jira 이슈가 생성되지 않습니다.
수정: ReplyRabbit 설정에서 Jira가 메일박스 이슈 트래커로 선택되어 있는지 확인하세요. Jira Cloud 사이트 URL, 계정 이메일, API 토큰, 기본 프로젝트, 기본 이슈 유형을 확인하세요. 또한 티어에 이슈 생성이 포함되어 있는지 확인하세요: 수동 Jira 이슈 생성은 Pro 기능이고, 자동 이슈 생성은 Team 기능입니다. 전체 설정 경로는 다음을 참조하세요 Jira 통합.
Workflow Tags가 적용되지 않음
증상: 예상한 태그는 rr_priority_critical, rr_no_reply_needed, 또는 rr_linear_issue_created, 그러나 대화에 ReplyRabbit 태그가 없습니다.
수정: 메일박스의 ReplyRabbit 설정을 열고 확인하세요 워크플로 동기화 활성화 그리고 FreeScout 태그 적용 켜져 있습니다 Workflow Tags 섹션. 신호 태그가 없으면 다음을 확인하세요 AI 신호 이 켜져 있고 대화가 분석되었습니다. Linear 태그가 누락된 경우 대화에 ReplyRabbit이 생성한 Linear 이슈가 있는지 확인하세요.
FreeScout Workflows 레시피가 실행되지 않는다면 먼저 ReplyRabbit이 예상한 FreeScout 태그를 추가하고 있는지 확인하세요. 그런 다음 설치된 Workflows 모듈이 프로그래밍 방식의 태그 변경에 반응하는지 테스트하세요. ReplyRabbit은 태그를 적용할 수 있지만, 해당 태그 변경으로 레시피가 실행되는지는 Workflows 모듈이 제어합니다.
지식 소스: 초안이 내 도움말 페이지, 지식 베이스, 제품 또는 이전 답장을 사용하지 않음
증상: 초안이 도움말 페이지, Knowledge Base, 제품 목록 또는 이전 답변에 있다고 알고 있는 정보를 무시했습니다.
수정: 답장 편집기의 초안 아래 줄에서 시작하세요. 초안이 사용한 내용을 나열합니다. 예: "포함: 도움말 페이지 2개, Knowledge Base 문서 1개, 이 고객에 대한 이전 답장 3개". 클릭하면 링크와 함께, 켜져 있지만 아무것도 추가하지 않은 각 소스에 대한 노트를 볼 수 있습니다:
- 켜져 있지만 아직 인덱싱된 항목 없음: 인덱싱이 완료되지 않았습니다. 큐 워커(아래 참조)를 확인한 다음 인덱싱이 완료될 때까지 기다리세요.
- 이 메시지에 적합한 일치 항목이 없습니다: 소스는 문제없지만, 이 고객의 메시지와 충분히 밀접하게 일치하는 내용이 없습니다. 이런 종류의 질문에 답하는 콘텐츠를 추가하거나 개선하세요.
- 검색 한도 초과 인덱스: 인덱스가 6,000개의 인덱싱된 섹션을 초과하면 의미 기반 매칭이 아닌 키워드 매칭만 실행됩니다. 필요하지 않은 소스를 제거하여 한도 아래로 되돌리세요.
- 요금제에 포함되지 않음: 해당 소스는 현재 플랜에서 사용할 수 없습니다.
- 지식 베이스 모듈이 설치되지 않았거나 활성화되지 않음: 다음에서 설치 또는 활성화하세요 관리 > 모듈.
설정 상태 경고
메일박스 설정의 설정 상태 배너가 이제 다음 경우에 경고합니다:
- 큐 워커가 실행되고 있지 않은 것 같습니다. 이것 없이는 인덱싱과 자동 초안이 절대 완료되지 않습니다. FreeScout은 cron 작업을 통해 대기열을 실행합니다
php artisan schedule:run또는queue:work프로세스이므로 그중 하나가 설정되어 있는지 확인하세요. - 활성화된 지식 소스가 없습니다. Mailbox settings, Knowledge sources에서 하나 이상을 켜세요.
- 소스가 켜져 있지만 아직 인덱싱되지 않았습니다. 인덱싱이 완료되게 하세요.
웹사이트 소스
- 크롤링은 기본적으로 200페이지에서 중지되며, 소스에 이제 그렇게 표시되고 한도를 높이는 버튼이 있습니다. 이후 설정을 저장한 다음 다시 크롤링하세요.
- 읽을 수 없는 페이지는 사이트에 의해 차단됨(403), 찾을 수 없음(404), 요청 과다(429), 서버 오류, 너무 큼 또는 읽을 수 있는 텍스트 없음(종종 JavaScript로 구축된 페이지)과 같은 이유와 함께 집계됩니다. 호스트에 크롤러를 허용하도록 요청하거나 JavaScript가 필요 없는 페이지로 소스를 지정하세요.
- 매우 긴 페이지는 약 24,000자로 단축됩니다. 시맨틱 매칭이 켜져 있으면 소스에 단축된 페이지 수가 표시됩니다. 필요한 부분이 끝 부분에 있으면 긴 페이지를 분할하세요.
개요 및 의미 기반 매칭
- Outline 동기화는 1,000개 문서에서 중지됩니다. 그 이후의 문서는 동기화되지 않습니다.
- 의미 기반(시맨틱) 매칭에는 임베딩 제공자가 필요합니다. 일부 임베딩 모델은 아직 의미 전용 매칭에 맞게 보정되지 않아 경고를 표시하므로, 경고가 보이면 다른 임베딩 모델로 전환하세요.
여전히 막혔나요?