임베디드 가능한 AI 채팅 위젯, 하이브리드 RAG 검색 및 에이전트 이식성 구축 방법 — 방법 소개 (CrewForm v1.8.0)

임베디드 챗 위젯: 한 줄 스크립트로 사이트 채팅 버블 배포(https://runner.crewform.tech/chat/widget.js) — data-key·data-theme 지원.

위젯은 React나 npm 불필요—단일 Vite 번들, Shadow DOM으로 CSS 격리, 페이지 리로드 간 대화 기억, 방문자별 속도 제한, 설정 UI(임베드 스니펫 생성기·라이브 미리보기), SSE 스트리밍, Docker 이미지 포함.

Knowledge Base의 하이브리드 검색은 pgvector의 코사인 유사도와 PostgreSQL full-text(tsvector + ts_rank_cd)를 결합.

최종 점수는 0.7×cosine_similarity + 0.3×ts_rank이며, 과다조회(over-fetch) 후 재정렬하여 상위 K개를 반환.

문서에 'FAQ','Technical','Policy' 등 메타태그를 붙여 GIN 인덱스 기반 필터링 가능; Retrieval Tester로 쿼리 테스트·색상 코드 유사도 표시·모드 전환·태그/문서 필터·top-K 조정 가능.