Tavily Python SDK 참조 — 클라이언트 사용법

Tavily Python SDK 참조 — 클라이언트 사용법

Tavily Python SDK 참조 문서는 TavilyClient 의 동기·비동기 클라이언트와 각 메서드를 상세히 설명해요.

클라이언트 생성

from tavily import TavilyClient, AsyncTavilyClient
client = TavilyClient(api_key="tvly-...")
async_client = AsyncTavilyClient(api_key="tvly-...")

주요 메서드

  • search(query, ...): 검색 결과 반환. max_results, search_depth, include_answer 등 옵션.
  • extract(urls, ...): 지정 URL 콘텐츠 추출.
  • crawl(url, ...): 페이지 크롤링.
  • map(url, ...): 사이트 구조 파악.
  • research(input, ...): 자율 심층 리서치(비동기 완료 폴링).

특징

  • 결과는 content, score, origin(로컬/외부) 필드를 가진 문서 구조로 돌아와요.
  • 하이브리드 RAG(TavilyHybridClient)로 웹 + 데이터베이스 컬렉션을 함께 검색할 수 있어요.
  • 프로젝트 ID를 붙여 사용량을 추적할 수 있어요.

더 알아보기