Exa API Deprecation으로 인한 RAG 파이프라인의 Silent Failure 분석

Exa Just Removed /research and Started Silently Ignoring Two Date Filters — Your Agent Is Probably Pulling Stale Pages Right Now

FlareCanary2026년 5월 2일9분intermediate

AI 요약

Context

Exa API의 /research 엔드포인트 중단 및 검색 필터 변경으로 인한 AI Agent의 데이터 무결성 훼손 상황. HTTP 200 응답에도 불구하고 내부 파라미터가 무시되는 'Silent Breakage'로 인해 RAG 시스템이 최신성 없는 데이터를 처리하는 병목 발생.

Technical Solution

/research/v1 엔드포인트를 /search 엔드포인트의 type: "deep-reasoning" 설정으로 대체하는 마이그레이션 수행
startCrawlDate 및 endCrawlDate 필터 무효화에 따른 최신 데이터 필터링 로직의 클라이언트 사이드 검증 필요성 증대
resolvedSearchType 및 highlightScores 필드의 null 반환으로 인한 런타임 에러 방지를 위해 Optional Chaining 및 기본값 처리 로직 적용
정적 가격 책정 방식에서 응답 값의 costDollars 필드를 참조하는 동적 비용 추적 구조로 변경
JSON.parse 오류 방지를 위해 outputSchema를 명시적으로 정의하여 구조화된 출력(Structured Output) 강제
HTTP 상태 코드(200 OK) 의존성을 탈피하여 응답 스키마의 실제 데이터 유무를 감시하는 모니터링 체계 도입

실천 포인트

- 외부 API 통합 시 HTTP 상태 코드 외에 필수 필드의 Presence 및 Type 변경을 감시하는 스키마 검증 로직 추가 - Date Filter와 같이 '성공 응답 내 무시되는 파라미터'를 탐지하기 위한 결과 데이터의 정량적 샘플링 테스트 구현 - API 응답 필드의 null/undefined 처리를 위한 방어적 프로그래밍(Defensive Programming) 적용 여부 검토 - 하드코딩된 API 비용 상수를 제거하고 응답 바디의 실제 과금 지표를 활용한 비용 트래킹 시스템 구축

태그

#Deep Reasoning #API Deprecation #Silent Failure #RAG #Schema Validation

원문 읽기