웹 검색
Elftia는 여러 웹 검색 엔진을 통합하여 AI가 대화 중에 실시간 인터넷 정보에 접근할 수 있게 합니다. API 검색 서비스와 로컬 브라우저 자동화 모드를 모두 지원하며, 여러 엔진을 동시에 활성화하여 결과를 집계할 수 있습니다.
사용 사례
- 대화에서 AI가 최신 뉴스, 기술 문서, 제품 정보를 검색하게 하기
- 실시간 데이터 가져오기 (주가, 날씨, 경기 점수 등)
- 검색 결과를 바탕으로 AI가 인터넷 연결이 필요한 질문에 답하게 하기
- Jina Reader로 웹페이지 전문을 추출하여 AI 분석에 활용
- API 키가 없을 때 로컬 브라우저 검색 사용
지원 검색 엔진
| 엔진 | 유형 | API 키 필요 | 설명 |
|---|---|---|---|
| Tavily | API 검색 | 예 | AI에 최적화된 검색 API, 구조화된 요약 반환 |
| Jina | API 검색 + 웹 리더 | 예 | 검색 엔진 + 웹 콘텐츠 전문 추출 (Jina Reader) |
| Searxng | 자체 호스팅 메타 검색 | 아니요 (인스턴스 URL 필요) | 여러 검색 엔진을 집계하는 오픈소스 메타 검색 엔진 |
| Zhipu (Zhipu AI) | API 검색 | 예 | Zhipu AI의 웹 검색 API, 중국어 콘텐츠에 최적화 |
| Z.AI | API 검색 | 예 | Z.AI의 검색 API |
| Claude Search | API 검색 | 예 | Claude의 내장 검색 기능 |
| Local Google | 로컬 브라우저 | 아니요 | 로컬 브라우저 자동화를 통한 Google 검색 |
| Local Bing | 로컬 브라우저 | 아니요 | 로컬 브라우저 자동화를 통한 Bing 검색 |
| Local Baidu | 로컬 브라우저 | 아니요 | 로컬 브라우저 자동화를 통한 바이두 검색 |
검색 엔진 구성
단계
- 설정 > 웹 검색 열기
- 사용할 검색 엔진 찾기
- 엔진 유형에 따라 구성 (아래 구성 표 참조)
- 엔진 활성화
API 검색 엔진 구성
| 구성 항목 | 설명 | 적용 엔진 |
|---|---|---|
| API 키 | 검색 서비스의 API 키 | Tavily, Jina, Zhipu, Z.AI, Claude |
| API Host | 사용자 정의 API 엔드포인트 (선택 사항) | 모든 API 엔진 |
| 활성화 상태 | 이 엔진 활성화 여부 | 모든 엔진 |
Searxng 구성
| 구성 항목 | 설명 |
|---|---|
| API Host | Searxng 인스턴스의 URL (예: http://localhost:8888) |
| Basic Auth 사용자명 | HTTP 기본 인증 사용자명 (선택 사항) |
| Basic Auth 비밀번호 | HTTP 기본 인증 비밀번호 (선택 사항) |
| 활성화 상태 | 활성화 여부 |
로컬 브라우저 엔진
로컬 브라우저 엔진은 API 키가 필요 없으며 브라우저 자동화를 통해 검색 엔진에 직접 접근합니다:
- Local Google — 브라우저를 자동으로 조작하여 Google 검색
- Local Bing — 브라우저를 자동으로 조작하여 Bing 검색
- Local Baidu — 브라우저를 자동으로 조작하여 바이두 검색
설정에서 활성화하기만 하면 사용할 수 있습니다.
:::info 로그인 창 일부 검색 엔진은 로그인이 필요할 수 있습니다. Elftia는 전용 로그인 창을 제공하여 검색 엔진에 로그인 작업을 완료할 수 있으며, 로그인 상태가 유지됩니다. :::
대화에서 검색 사용하기
검색 활성화
웹 검색은 세션별로 활성화됩니다. 채팅 인터페이스에서:
- 현재 세션의 설정 패널 열기
- 웹 검색 옵션 활성화
- 사용할 검색 엔진 선택 (여러 개가 구성된 경우)
검색 흐름
검색을 활성화하면 AI는 실시간 정보가 필요할 때 자동으로 검색을 트리거합니다:
사용자 질문 → AI가 검색 필요 여부 판단 → 검색 요청 전송 → 검색 결과 가져오기 → AI가 결과를 종합하여 답변
검색 결과는 AI에게 컨텍스트로 제공되며, AI는 찾은 정보를 바탕으로 더 정확한 답변을 생성합니다.
다중 엔진 결과 집계
여러 검색 엔진이 동시에 활성화된 경우, Elftia는 병렬 다중 엔진 검색 및 결과 집계를 지원합니다:
- 활성화된 모든 엔진에 병렬로 검색 요청 전송
- 모든 엔진의 결과 집계
- 중복 제거 및 순위 지정 후 AI에게 제공
이 방식으로 더 포괄적인 검색 결과를 얻어 답변 품질을 향상시킬 수 있습니다.
Jina Reader
Jina Reader는 Jina 검색 엔진에 포함된 웹페이지 전문 읽기 기능으로, 모든 URL의 웹페이지 콘텐츠를 구조화된 텍스트 형식으로 추출할 수 있습니다.
기능
- 웹페이지의 주요 텍스트 콘텐츠 추출 (내비게이션, 광고 및 기타 방해 요소 제거)
- 제목, 설명, 본문 내용 반환
- 타임아웃 구성 지원
- Jina 검색 엔진에 API 키를 구성하면 Reader 기능이 자동으로 사용 가능
사용 사례
- AI가 지정된 웹페이지의 콘텐츠를 읽고 분석하게 하기
- 온라인 문서에서 정보 추출
- 기사 및 논문의 전문 가져오기
검색 결과 형식
각 검색 결과에는 다음 정보가 포함됩니다:
| 필드 | 설명 |
|---|---|
| 제목 (title) | 검색 결과의 제목 |
| 내용 (content) | 결과 요약 또는 텍스트 스니펫 |
| URL (url) | 소스 웹페이지 주소 |
검색 응답에는 다음도 포함됩니다:
| 필드 | 설명 |
|---|---|
| 성공 여부 (success) | 검색 요청 성공 여부 |
| 쿼리 (query) | 사용된 검색 키워드 |
| 제공업체 (provider) | 검색을 실행한 검색 엔진 식별자 |
검색 엔진 선택 권장 사항
| 필요 | 권장 엔진 |
|---|---|
| 일반 검색, AI 최적화 | Tavily |
| 중국어 콘텐츠 검색 | Zhipu (Zhipu AI) 또는 Local Baidu |
| 웹페이지 전문 추출 | Jina (검색 + Reader) |
| API 키 불필요 | Local Google / Local Bing / Local Baidu |
| 자체 호스팅, 프라이버시 우선 | Searxng |
| 데이터 보안, 내부 네트워크 | Searxng (자체 호스팅) 또는 로컬 엔진 |
API 키 순환
일부 검색 엔진 (예: Tavily, Jina)은 여러 API 키 구성을 지원합니다. API 키를 구성할 때 쉼표로 구분된 여러 키를 사용하면 시스템이 자동으로 순환합니다:
key1,key2,key3
키가 속도 제한에 도달하면 시스템이 자동으로 다음 키로 전환합니다.
자주 묻는 질문
| 질문 | 해결 방법 |
|---|---|
| 검색 결과가 반환되지 않음 | 검색 엔진이 활성화되어 있는지, API 키가 올바른지 확인 |
| 검색이 느림 | 로컬 브라우저 엔진이 느릴 수 있으므로 API 엔진을 먼저 권장 |
| Searxng 연결 실패 | Searxng 인스턴스가 실행 중인지 확인, URL 및 인증 정보 점검 |
| 로컬 엔진이 검색 엔진에 의해 차단됨 | 로컬 엔진을 자주 사용하면 크롤링 방지가 트리거될 수 있으므로 API 엔진으로 전환 |
| AI가 검색 결과를 사용하지 않음 | 현재 세션에서 웹 검색이 활성화되어 있는지 확인 |
| 검색 결과가 질문과 관련 없음 | 문제를 더 명확하게 설명하거나 다른 검색 엔진 사용 |
| Jina Reader 콘텐츠가 불완전함 | 일부 웹페이지에 크롤링 방지 보호가 있을 수 있으므로 먼저 로그인 창으로 로그인 시도 |