FreeScout용 Semantic Search
Semantic Search는 다중 단어 검색을 수정하고, 자체 AI 키를 추가하면 대화를 주제로 찾는 독립형 FreeScout 모듈입니다. ReplyRabbit 제작자가 판매하지만 ReplyRabbit이 설치되어 있을 필요가 없습니다.
개요를 찾고 계신가요?
개요
FreeScout의 내장 검색은 전체 쿼리를 한 필드에서 하나의 구문으로 찾습니다. 다음과 같은 검색은 frank invoice 아무것도 찾지 못합니다. 고객 이름은 한 곳에 있고 "invoice"라는 단어는 다른 곳에 있기 때문입니다. Semantic Search는 이 동작을 두 단계로 대체합니다:
- 키워드 모드 (키 필요 없음): 검색의 모든 단어가 대화 어딘가에 나타나야 합니다. 제목, 고객 이름, 이메일 주소, 메시지 텍스트가 모두 포함됩니다. 모듈이 활성화되면 바로 켜집니다.
- 의미로 검색 (자체 AI 키): 각 대화는 무엇에 관한 것인지에 대한 간결한 지문을 받아 FreeScout 데이터베이스에 저장됩니다. 검색은 의미와 키워드로 매칭되며 두 목록이 혼합되어 최적의 답변이 먼저 나옵니다. 이 모드는 다음도 지원합니다 유사한 대화 대화 사이드바의 패널.
검색 페이지에 작은 시맨틱 또는 키워드 결과 수 옆의 레이블로 상담원이 어떤 모드가 답변했는지 알 수 있습니다.
검색 구문
일반적인 검색 엔진 약어가 두 모드 모두에서 작동합니다:
| 입력합니다 | 하는 일 |
|---|---|
frank invoice | 두 단어 모두 대화 어딘가에 나타나야 합니다. |
"out of stock" | 정확한 문구가 나타나야 합니다. |
-refund 또는 -"out of stock" | 단어나 구문이 포함된 대화는 제외됩니다. |
cart OR basket | 어느 단어든 충분합니다. OR 대문자여야 합니다. |
admin@example.com 또는 example.com | 이메일 주소 또는 도메인이 정확히 일치합니다. |
의미로 검색은 입력한 단어와 명확히 같은 주제인 대화만 추가합니다. 인용된 구문, 주소, -exclusions 해당 결과에도 여전히 적용되므로 이메일 주소 검색이 관련 없는 대화로 채워지지 않습니다.
검색 바 및 필터
검색 결과 페이지에서 검색 상자는 바로 옆에 위치합니다 대화 그리고 고객 탭이므로 맨 위로 스크롤하지 않고도 검색을 변경할 수 있습니다. 정렬 드롭다운은 다음 오른쪽에 있습니다 고객 탭.

검색 상자 옆의 슬라이더 버튼을 클릭하여 다음을 여세요 필터 패널. 위의 축약어를 기억할 필요가 없습니다. 네 단어 규칙이 검색 상자에 자동으로 입력해 줍니다.
| 필터 | 작성하는 것 | 하는 일 |
|---|---|---|
| 이 모든 단어 | frank invoice | 모든 단어가 나타나야 합니다. |
| 이 정확한 문구 | "out of stock" | 단어가 이 순서대로 함께 나타나야 합니다. |
| 이 단어 중 하나 | cart OR basket | 단어 중 하나면 충분합니다. |
| 이 단어 중 어느 것도 아님 | -refund | 단어가 포함된 대화는 제외됩니다. |

표준 FreeScout 필터(메일박스, 상태, 담당자, 고객, 날짜 등)는 다음에 있습니다 고급 패널 하단의 섹션. 패널을 짧게 유지하기 위해 접혀 있으며, 해당 필터 중 하나가 이미 사용 중이면 자동으로 열립니다. 슬라이더 버튼의 작은 숫자는 활성 필터 수를 보여줍니다. 클릭 적용 검색을 실행하려면, 또는 모두 지우기 다시 시작하려면.

1.1.3부터 고객 탭은 각 단어도 개별적으로 봅니다. 모든 단어와 일치하는 고객이 없으면, 그중 하나라도 일치하는 고객을 가장 가까운 순서로 나열하므로 invoice frank 여전히 Frank라는 고객을 찾습니다.
사전 요구 사항
시작하기 전에 다음이 있는지 확인하세요:
- PHP 8.1 이상에서 FreeScout 1.8.101 이상.
- 작동하는 FreeScout 큐 워커 및 스케줄러(
php artisan queue:work그리고schedule:runcron). 인덱싱이 이들에서 실행됩니다. - 다음에서 Semantic Search 라이선스 ReplyRabbit 계정. 구매 이메일에 라이선스 키가 포함되어 있습니다.
- 선택 사항, 의미 기반 검색용: OpenAI 또는 Google Gemini의 API 키, 또는 OpenRouter, Ollama, LM Studio 같은 호환 서비스의 기본 URL 및 임베딩 모델 이름.
모듈 설치
ZIP 다운로드
로그인 위치 app.replyrabbit.app 결제 시 사용한 이메일 주소로 열고 Semantic Search 대시보드의 카드. 다운로드semantic-search.zip.Modules 폴더에 복사하세요
압축 해제semantic-search.zip그리고 복사SemanticSearch폴더를 다음에 넣으세요ModulesFreeScout 설치 디렉터리의 다른 모듈 옆에, SFTP 또는 호스트의 파일 관리자를 통해 배치합니다. FreeScout에는 타사 모듈용 인앱 업로드 기능이 없습니다.모듈 활성화
활성화 Semantic Search 모듈 목록에서. 활성화하면 두 개의 인덱스 테이블을 생성하는 데이터베이스 마이그레이션이 실행됩니다.검색 시도
고객 이름과 주제를 검색하세요. 예를 들어 이름과 "invoice"를 검색합니다. 이제 결과는 대화 내 어디에 나타나든 모든 단어와 일치하며, 검색 페이지에 다음이 표시됩니다 키워드 레이블.
키워드 모드는 이 시점에서 추가 설정 없이 작동합니다. 아래 단계를 통해 의미 기반 검색과 유사 대화 패널을 사용할 수 있습니다.
라이선스 키 입력
설정 페이지 열기
FreeScout에서 다음으로 이동하세요 관리, 그런 다음 설정, 그런 다음 Semantic Search.라이선스 키 붙여넣기
다음에서 라이선스 섹션에서 구매 이메일의 키를 붙여넣고 저장하세요. 상태에 표시됩니다 라이선스 있음 마지막 확인 시간과 함께.
라이선스는 FreeScout 설치의 사이트 URL에 연결됩니다. FreeScout를 새 도메인으로 이전하는 경우 문의하세요 hey@replyrabbit.app 그러면 재설정해 드립니다.
의미 기반 검색 설정
제공자 선택
다음에서 임베딩 제공자 섹션에서 선택하세요 OpenAI, Google, 또는 OpenAI 호환. 기본 모델은 OpenAI와 Google에 대해 채워집니다. 호환 서비스의 경우 기본 URL과 예상 모델 이름을 입력하세요.키를 추가하고 테스트
제공자에 필요한 경우 API 키를 붙여넣은 다음 클릭하세요 임베딩 테스트. 테스트는 임베딩 엔드포인트에 짧은 문장 하나를 보내고 응답을 확인합니다. 키는 암호화되어 저장되며 저장 후 마스킹된 미리보기만 표시됩니다.인덱싱할 메일함 선택
다음에서 인덱싱 중 섹션에서 포함할 사서함을 체크하세요. 내부 노트 포함 은 기본적으로 켜져 있습니다. 상담원이 종종 자신의 노트를 검색하기 때문입니다. 설정하세요 백필 일수 인덱싱할 기간(기본값은 365일).의미로 검색 켜기
체크 의미로 검색 그리고 저장하세요. 공급자, 모델 또는 기본 URL이 변경된 경우 페이지에서 대화가 백그라운드에서 다시 인덱싱될 것이라고 알려줍니다.첫 번째 인덱스 시작
클릭 지금 인덱싱. 상태 블록은 "Indexed 1,240 of 8,900 (14%)" 같은 진행 상황, 마지막 실행 시간, 마지막 오류(있는 경우), 예상 남은 비용을 표시합니다. 인덱싱은 5분마다 약 200개 대화 배치로 실행되므로 큰 데스크는 몇 시간이 걸립니다. 검색은 그동안 계속 작동합니다.
어떤 공급자인가요?
사용자 지정 임베딩 엔드포인트를 사용하세요
다음과 같은 API 기본 URL을 입력하세요 https://embeddings.example.com/v1 또는 http://10.0.0.25:8001/v1, 그 뒤에 해당 위치에서 제공되는 정확한 임베딩 모델 ID가 이어집니다. Semantic Search는 추가합니다 /embeddings 기본 URL로. 공개 주소는 HTTPS가 필요합니다. 사설 또는 루프백 HTTP 주소는 FreeScout이 접근할 수 있는 신뢰할 수 있는 네트워크에 있어야 합니다.
하나의 게이트웨이가 채팅과 임베딩을 모두 처리한다면 동일한 /v1 여기와 다음에서 기본 URL ReplyRabbit의 사용자 지정 제공자 설정. 여기서 임베딩 모델을 구성하고 ReplyRabbit에서 채팅 모델을 구성하세요. 채팅 서버와 임베딩 서버의 URL이 다르면 각 URL을 해당 제품에 입력하세요. 제품은 토큰이나 설정을 공유하지 않습니다.
그 임베딩 테스트 action은 임베딩 벡터를 반환해야 합니다. 답변만 하는 채팅 모델은 /chat/completions 의미 기반 검색을 지원할 수 없습니다. 엔드포인트나 모델을 변경하면 새 인덱스 프로필이 시작되고, 토큰만 변경하면 기존 벡터가 유지됩니다.


최신 상태로 유지하기
새 버전이 출시되면 FreeScout이 다음에 표시합니다 관리, 그런 다음 모듈, 그리고 지금 업데이트 제자리에서 설치합니다: SFTP 없음, 재업로드 없음. 대시보드에서 다운로드한 ZIP에는 자체 라이선스의 다운로드 링크가 포함되어 있으므로, 업데이트는 첫 다운로드와 동일한 라이선스 확인 뒤에서 가져옵니다.
알아야 할 두 가지:
- 업데이트는 대시보드에서 다운로드한 사본에만 작동하며, 사본을 전달해서는 안 됩니다. 업데이트 링크에 귀하의 라이선스 다운로드 키가 포함되어 있어 ZIP을 가진 사람은 누구나 귀하의 라이선스로 업데이트를 가져올 수 있습니다. 다른 사람의 사본은 그들의 라이선스에 연결되어 그들의 키로 업데이트됩니다.
- FreeScout에서 다운로드 오류가 보고되면 대시보드에서 새 ZIP을 다운로드하고 위 설치 단계처럼 폴더를 직접 교체하세요. index와 설정은 유지됩니다. 이들은 모듈 폴더가 아니라 데이터베이스에 있기 때문입니다.
비용
인덱싱은 각 대화의 텍스트를 제공자에게 한 번 전송하며, 대화에 새 답변이 있으면 다시 전송합니다. 검색은 검색 단어만 전송합니다.
| 제공업체 | 모델 | 가격 | 약 100개의 대화 |
|---|---|---|---|
| OpenAI | text-embedding-3-small | 백만 토큰당 0.02 USD | 약 0.01 USD |
| Google Gemini | gemini-embedding-001 | 무료 티어, 이후 토큰당 가격 | 보통 무료 |
| Ollama 또는 LM Studio | 모든 임베딩 모델 | 없음 | 없음 |
설정 페이지에 아직 색인 대기 중인 대화의 예상치가 표시되어 클릭 전에 숫자를 확인할 수 있습니다 지금 인덱싱. 재인덱싱은 제공업체나 모델을 변경하거나 클릭할 때만 발생합니다 모두 다시 인덱싱.
유사한 대화 패널
의미 기반 검색이 켜져 있으면 유사한 대화 대화 사이드바에 패널이 나타납니다. 같은 사서함에서 같은 주제를 다루는 다른 대화들을 제목, 고객 이름, 날짜와 함께 나열합니다. 상담원은 이미 접근 권한이 있는 대화만 볼 수 있습니다.
다음을 사용하여 모든 사람에 대해 패널 끄기 유사한 대화 설정 페이지에서 토글하세요. 새 대화는 인덱싱될 때까지(몇 분 소요) "아직 유사한 항목 없음"을 표시합니다.

명령줄
SSH를 통해 FreeScout을 관리할 때 두 가지 명령이 도움이 됩니다:
php artisan semanticsearch:status
php artisan semanticsearch:reindex --limit=2000status 설정 페이지와 동일한 적용 범위 수치를 출력합니다. reindex 스케줄러를 기다리지 않고 즉시 배치를 실행하며, 대규모 데스크의 첫 인덱스에 유용합니다.
문제 해결
| 증상 | 확인할 것 |
|---|---|
| 검색 페이지에 표시됩니다 키워드 대신 시맨틱 | 확인 의미로 검색 이 체크되어 있으면 라이선스 상태는 라이선스 있음, 상태 블록에 최근 오류가 없습니다. 키가 실패하면 수정될 때까지 검색이 키워드 모드로 대체됩니다. |
| 검색 페이지에 레이블이 전혀 표시되지 않음 | 검색이 FreeScout 자체 검색으로 넘겨졌습니다. 이는 숫자만 있는 검색(티켓 또는 주문 번호)의 경우로, 코어에서 이미 잘 처리합니다. |
| 임베딩 테스트 실패합니다 | 키에 앞뒤 공백이 없고 올바른 제공자에 속하는지 확인하세요. 호환 서비스의 경우 기본 URL이 FreeScout 서버에서 접근 가능한지, 임베딩 모델 이름이 서비스가 기대하는 것과 정확히 일치하는지 확인하세요. |
| 상태에 "아직 인덱싱된 항목 없음"이 표시됨 | 큐 워커와 스케줄러 cron이 실행 중인지 확인합니다. 클릭 지금 인덱싱 그리고 1분 후 새로 고침하세요. 공유 호스팅에서는 첫 배치가 시작되는 데 몇 분이 걸릴 수 있습니다. |
| 인덱싱이 중간에 중지됨 | 상태 블록에서 마지막 오류를 확인하세요. 제공업체의 속도 제한 및 할당량 오류가 일반적인 원인이며, 인덱싱은 다음 예약 실행 시 재개됩니다. |
| 매우 큰 데스크에서 검색 결과가 느립니다 | 키워드 모드는 모든 검색 단어를 메시지 텍스트와 대조하므로 코어의 단일 구문 일치보다 무겁습니다. 검색을 몇 단어로 제한하거나 인덱싱에 포함되는 메일박스를 줄이세요. |
| 유사한 대화 패널이 비어 있음 | 대화가 아직 인덱싱되지 않았거나 설정에서 패널이 꺼져 있습니다. 새 대화는 몇 분 이내에 인덱싱됩니다. |
개인정보 및 데이터 처리
키워드 검색은 전적으로 FreeScout 데이터베이스 내부에서 실행되며 어디에도 아무것도 전송하지 않습니다. 의미 기반 검색이 켜져 있으면 인덱싱된 각 대화의 텍스트(제목, 고객 메시지, 상담원 답장, 포함된 경우 내부 메모)가 구성한 공급자에게 전송됩니다. 공개 엔드포인트는 HTTPS를 사용하고, 비공개 HTTP 엔드포인트는 구성한 네트워크에 머뭅니다. 호환 엔드포인트의 경우 키는 선택 사항입니다. 반환된 지문만 저장됩니다.
replyrabbit.app과의 유일한 접촉은 라이선스 확인이며, 라이선스 키, FreeScout 사이트 URL 및 모듈 버전을 전송합니다. 대화 텍스트, 검색어 또는 고객 데이터는 우리에게 전송되지 않습니다.
대화 텍스트가 자체 서버에 있어야 한다면 로컬 제공자나 신뢰할 수 있는 사설 네트워크의 호환 엔드포인트를 사용하거나 키워드 모드에 머무르세요. 호환되는 공개 엔드포인트의 경우 텍스트는 HTTPS를 통해 전송됩니다. 사설 HTTP 엔드포인트는 신뢰할 수 있는 네트워크에서만 허용됩니다.
FAQ
Semantic Search를 사용하려면 ReplyRabbit이 필요한가요?
아니요. Semantic Search는 동일 제작자의 별도 FreeScout 모듈입니다. 자체적으로 설치 및 실행됩니다. ReplyRabbit은 구매, 다운로드 및 라이선스 키 관리만 담당합니다.
Semantic Search가 AI 키 없이 작동하나요?
예. 키워드 모드는 모듈을 활성화하는 순간부터 키나 설정 없이 켜집니다. 검색어의 모든 단어가 제목, 고객 이름, 이메일 주소 또는 메시지 텍스트 중 어딘가에 나타나야 합니다. AI 키는 의미 기반 검색과 유사 대화 패널만 추가합니다.
어떤 AI 공급자를 사용할 수 있나요?
OpenAI(기본값 text-embedding-3-small), Google Gemini(기본값 gemini-embedding-001), 또는 OpenRouter, Ollama, LM Studio처럼 기본 URL과 모델을 직접 입력하는 OpenAI 호환 서비스. Z.AI는 임베딩 서비스가 없어 지원되지 않습니다.
AI 키 비용은 얼마인가요?
백만 토큰당 0.02 USD의 OpenAI text-embedding-3-small을 사용하면 약 100개 대화를 인덱싱하는 데 대략 0.01 USD가 듭니다. 10,000개 대화가 있는 데스크는 모든 것을 한 번 인덱싱하는 데 약 1 USD를 지불한 다음 새 메일에 대해 월 몇 센트를 지불합니다. 설정 페이지에서 첫 인덱스 실행 전에 예상치를 표시합니다.
검색 데이터는 어디에 저장되나요?
기존 FreeScout 데이터베이스 내의 두 테이블에 저장됩니다. 인덱싱된 각 대화는 약 0.5킬로바이트를 추가합니다. 별도의 검색 서버가 필요하지 않으며 replyrabbit.app에 아무것도 저장되지 않습니다.
PostgreSQL에서 작동하나요?
예. 키워드 검색과 의미 기반 검색 모두 MySQL, MariaDB, PostgreSQL에서 작동합니다.
키가 작동을 멈추거나 라이선스가 만료되면 어떻게 되나요?
검색은 자동으로 키워드 모드로 전환되므로 상담원은 계속 결과를 받습니다. 설정 페이지에 이유가 표시됩니다. 키워드 검색은 라이선스나 키에 의존하지 않습니다.