웹 검색
웹 검색은 최신 공개 정보용 web_search를 노출합니다. 활성 사용자 지정 백엔드가 없으면 키 없는 DuckDuckGo HTML 검색을 사용합니다. 백엔드를 선택하고 대기 설정을 테스트해 대화에 활성화할 수 있습니다.
Dashboard에서 구성
Dashboard → Tools → Web Search를 엽니다.
- 공급자를 선택합니다.
- 필요하면 API 키를 입력합니다.
- 엔드포인트를 검토·입력합니다.
- Test를 선택합니다.
- 원하는 백엔드와 테스트 결과가 일치할 때만 저장합니다.
테스트는 실제 검색 요청이며 공급자 할당량·비용이 들 수 있습니다.
CLI 설정도 가능합니다.
anyy tools websearch
지원 백엔드
설정 카탈로그 선택지:
| 옵션 | web_search.provider |
|---|---|
| Firecrawl Cloud / 자체 호스팅 Firecrawl | firecrawl (엔드포인트로 구분) |
| Exa / Parallel / Tavily / SearXNG | exa / parallel / tavily / searxng |
| Brave Search Free Tier / Brave Search | brave-free / brave |
| Perplexity / Gemini Search / xAI Grok Search | perplexity / gemini / grok |
이는 구현 어댑터 범위이며 모든 외부 계정·요금제·네트워크 검증이 아닙니다. Gemini/Grok 검색은 대화 모델 프로토콜과 별개이며 네이티브 대화 API를 추가하지 않습니다.
클라우드는 보통 키가 필요합니다. 자체 Firecrawl·SearXNG에는 절대 HTTP(S) 엔드포인트가 필요합니다. 지원 키는 config.yaml 값 대신 프로필 비밀정보 참조로 저장합니다.
Tavily 옵션
추가 제어 네 가지:
| 옵션 | 값 |
|---|---|
| 검색 깊이 | basic 또는 advanced |
| 최대 결과 | 1~20, 기본 10 |
| 이미지 포함 | 불리언, 기본 false |
| 원시 콘텐츠 포함 | 불리언, 기본 false |
고급 검색은 자원을 더 쓸 수 있습니다. web_search.options 아래 search_depth, max_results, include_images, include_raw_content 키이며 다른 백엔드는 거부합니다. max_results는 Tavily 요청을 제어하고 모델 도구 limit는 1~10으로 반환 결과를 계속 제한합니다. 이미지 포함이 채팅 인라인 표시를 보장하지 않습니다.
검색 사용
최신 사실과 링크 필요 여부를 요청하세요.
Find the latest stable release of this library, summarize the changes, and include links to primary sources.
Anyy가 검색 필요를 판단하고 구성 백엔드가 제공한 것만 반환합니다. 검색은 후보 소스를 찾을 뿐 신뢰하지 않는 페이지에 권위를 주지 않습니다.
기술·법률·의료·금융 질문은 일차·공식 자료를 명시적으로 요청하고 중요한 결론을 직접 확인하세요.
비활성화와 공급자 변경
Dashboard → Tools → Web Search 스위치는 사용자 지정 백엔드를 켜고 끕니다. web_search.enabled: false 또는 공급자 미구성이면 web_search는 기본 DuckDuckGo를 쓰며 네트워킹을 끄지 않습니다. 대화 검색을 제거하려면 도구 선택에서 web_search를 제외하세요. web_fetch, web_extract는 별도입니다.
공급자 변경 시 새 자격 증명으로 재테스트하세요. 다른 엔드포인트·옵션에 이전 검증을 재사용하지 않습니다. 활성 사용자 백엔드 실패 시 기본 검색으로 몰래 전환하지 않습니다. 기본 DuckDuckGo는 자동화 방지 챌린지를 반환할 수 있으며 이를 결과로 보지 않고 검색 불가를 보고합니다.
문제 해결
| 증상 | 확인 사항 |
|---|---|
| 인증 실패 | 키 교체 및 제품/요금제 접근 확인 |
| 자체 백엔드 접근 불가 | Gateway 호스트에서 접근 가능한 절대 URL |
| 테스트는 되지만 채팅 불가 | 사용자 백엔드 활성 및 대화 web_search 노출 |
| 껐는데 DuckDuckGo 접근 | 사용자 백엔드만 꺼진 것. 대화 도구에서 web_search 제외 |
| Tavily 설정 거부 | basic/advanced와 결과 1~20 사용 |
| 결과가 약하거나 오래됨 | 검색어 개선, 일차 자료 요청, 적합 백엔드 선택 |