Vercel AI Gateway로 어떤 모델에도 Perplexity 웹 검색 연결하기

Vercel AI Gateway가 Perplexity Search 툴 통합으로 네이티브 검색 기능이 없는 모델에도 웹 검색을 제공한다. maxResults, searchRecencyFilter, searchLanguageFilter 등 세부 필터를 지원하며, 여러 모델 제공자에 걸쳐 균일한 검색 동작을 유지하고 자동 폴백도 설정할 수 있다.

핵심 포인트

Vercel AI Gateway의 Perplexity Search 툴은 제공자에 관계없이 어떤 모델에도 웹 검색을 추가한다.
maxResults, searchRecencyFilter(최근 N개월), searchLanguageFilter로 검색 결과를 세밀하게 조정한다.
네이티브 검색이 없는 GLM-4.7 같은 모델에 웹 검색 능력을 부여할 수 있다.
여러 제공자를 provider options에 지정해 자동 폴백으로 검색 연속성을 보장한다.
도메인 필터링, 시간 범위 필터, 결과 수 제한을 조합해 사용할 수 있다.

상세 정리

배경: 각 모델 제공자가 자체 검색 툴을 갖거나 아예 없어, 제공자별로 다른 검색 로직을 구현해야 했다. Vercel AI Gateway가 Perplexity Search를 공통 레이어로 제공해 통합 방식을 표준화한다.
임포트: @ai-sdk/gateway에서 gateway와 Perplexity search tool을 임포트해 generateText의 tools 파라미터로 전달한다.
maxResults: 반환할 검색 결과 수를 지정한다.
searchRecencyFilter: "지난 한 달" 처럼 시간 범위를 지정해 최신 정보만 검색한다. 시간에 민감한 정보 조회에 유용하다.
searchLanguageFilter: 특정 언어 결과만 반환하도록 필터링한다.
도메인 필터링: 특정 도메인의 결과만 포함하거나 제외할 수 있다.
활용 사례 — 네이티브 검색 없는 모델 보강: GLM-4.7처럼 자체 검색이 없는 모델에 웹 검색 능력을 추가한다.
활용 사례 — 개발 도구: 최신 npm 패키지 버전, 최근 PR, 문서 업데이트를 코드로 조회할 수 있다.
제공자 일관성: 여러 모델 제공자에 동일한 검색 로직을 적용해 제공자 전환 시 재구현이 불필요하다.
폴백 체인: provider options에 여러 제공자를 지정하면 자동 폴백으로 검색 서비스 연속성을 보장한다.