Tavily 도구
도구 선택 가이드
| 필요 사항 | 도구 | 사용 시기 |
|---|
| 빠른 웹 검색 | web_search | 기본 쿼리, 특별 옵션이 필요하지 않을 때 |
| 고급 옵션을 사용한 검색 | tavily_search | 검색 깊이, 주제, 도메인 필터, 시간 범위 또는 AI 답변이 필요할 때 |
| URL에서 콘텐츠 추출 | tavily_extract | 특정 URL이 있고 해당 콘텐츠가 필요할 때 |
web_search
Tavily는 검색 제공자로 선택되면 자동으로 이 도구를 실행합니다. Tavily 특정 옵션이 필요 없는 단순한 쿼리에 사용하세요.
| 매개변수 | 설명 |
|---|
query | 검색 쿼리 문자열 |
count | 결과 수 (1-20) |
tavily_search
검색 동작을 세밀하게 제어해야 할 때 사용합니다.
| 매개변수 | 설명 |
|---|
query | 검색 쿼리 문자열 (400자 미만 유지) |
search_depth | basic (기본값, 균형 잡힘) 또는 advanced (최고 관련성, 느림) |
topic | general (기본값), news (실시간 업데이트) 또는 finance |
max_results | 결과 수, 1-20 (기본값: 5) |
include_answer | AI 생성 답변 요약 포함 여부 (기본값: false) |
time_range | 최신순으로 필터링: day, week, month 또는 year |
include_domains | 결과를 제한할 도메인 배열 |
exclude_domains | 결과에서 제외할 도메인 배열 |
검색 깊이
| 깊이 | 속도 | 관련성 | 최적 사용 사례 |
|---|
basic | 빠름 | 높음 | 일반 목적 쿼리 (기본값) |
advanced | 느림 | 최고 | 정밀도, 특정 사실, 상세 연구 |
팁
- 쿼리를 400자 미만으로 유지하세요 — 프롬프트가 아닌 검색 쿼리로 생각하세요.
- 복잡한 쿼리는 여러 하위 쿼리로 나누세요 — 더 나은 결과를 얻을 수 있습니다.
include_domains를 사용하세요 — 신뢰할 수 있는 출처에 집중할 수 있습니다.time_range를 사용하세요 — 최신 정보(뉴스, 현재 이슈)를 위해 사용합니다.include_answer를 사용하세요 — 빠르게 요약된 답변이 필요할 때 사용합니다.
tavily_extract
특정 URL이 있고 해당 콘텐츠가 필요할 때 사용합니다. JavaScript로 렌더링된 페이지를 처리하고 깨끗한 마크다운을 반환합니다. 대상 추출을 위한 쿼리 기반 청킹을 지원합니다.
| 매개변수 | 설명 |
|---|
urls | 추출할 URL 배열 (요청당 1-20개) |
query | 추출된 청크를 이 쿼리와의 관련성에 따라 재정렬 |
extract_depth | basic (기본값, 빠름) 또는 advanced (JS-heavy 페이지, 표) |
chunks_per_source | URL당 청크 수, 1-5 (query 필요) |
include_images | 결과에 이미지 URL 포함 여부 (기본값: false) |
추출 깊이
| 깊이 | 사용 시기 |
|---|
basic | 간단한 페이지 — 먼저 시도하세요 |
advanced | JS 렌더링 SPA, 동적 콘텐츠, 표, 임베디드 콘텐츠 |
팁
- 요청당 최대 20개의 URL — 더 큰 목록은 여러 호출로 나누세요.
query + chunks_per_source를 사용하세요 — 전체 페이지 대신 관련 콘텐츠만 가져올 수 있습니다.basic부터 시도하세요 — 콘텐츠가 누락되거나 불완전하면 advanced로 대체하세요.tavily_search 결과에 이미 필요한 스니펫이 포함되어 있다면 추출 단계를 건너뛰세요.
올바른 워크플로 선택하기
다음 에스컬레이션 패턴을 따르세요 — 간단하게 시작하고 필요할 때만 확장하세요:
web_search — 빠른 조회, 특별한 옵션이 필요하지 않을 때.tavily_search — 검색 깊이 제어, 주제 필터링, 도메인 필터, 시간 범위 또는 AI 답변이 필요할 때.tavily_extract — 특정 URL이 있고 전체 콘텐츠 또는 대상 청크가 필요할 때.
먼저 페이지를 찾은 다음 전체 콘텐츠를 가져와야 할 때는 검색 + 추출을 결합하세요.