auto(Exa의 권장 검색 유형), neural, fast, deep-lite, deep, deep-reasoning, instant — 그리고 구조화된 콘텐츠 검색(하이라이트, 텍스트, 요약) 및 풍부한 필터링(카테고리, 도메인 포함/제외, 날짜 범위, 최대 기간 윈도우)을 제공합니다. 합리적인 Exa 측 기본값이 기본으로 제공되므로 수동 조정 없이 Exa 모범 사례를 얻을 수 있습니다.
FIM One에서 Exa를 사용하는 이유
- 에이전트 추론을 위한 신경망 검색 — Exa의 임베딩 기반 검색은 단순 키워드 매칭이 아닌 의미론적으로 관련된 결과를 반환합니다. 웹 콘텐츠를 기반으로 추론하는 연구 에이전트에 중요합니다.
- 어려운 쿼리를 위한 심화 추론 모드 — 에이전트가 하위 쿼리를 직접 조율하지 않고도 오픈 웹에 대한 단일 호출 다중 홉 추론을 수행합니다.
- 내장된 콘텐츠 추출 — 하이라이트 + 텍스트 + 선택적 요약이 검색 호출과 함께 제공되어 페이지 콘텐츠를 가져오고 정리하는 두 번째 왕복을 제거합니다.
- 엄격한 도메인 / 최신성 제어 — 도메인 목록 포함/제외(최대 1200개 항목), ISO-8601 날짜 범위, 시간에 민감한 워크플로우를 위한
maxAgeHours를 포함합니다.
빠른 시작
1. Exa API 키 받기
exa.ai에서 가입하고 대시보드에서 API 키를 받으세요.2. FIM One에서 Exa 활성화
.env에 다음을 추가하세요:
web_search가 Exa를 통해 라우팅되도록 하세요. 키 자동 감지에만 의존하기보다는 명시적인 WEB_SEARCH_PROVIDER=exa를 선호하세요.
3. 모든 에이전트에서 사용하기
웹 검색은 에이전트에 기본 제공 도구로 노출됩니다 — 추가 설정이 필요하지 않습니다. 위와 같이 Exa가 구성되면,web_search가 활성화된 에이전트는 검색 호출을 Exa를 통해 라우팅합니다.
구성
모든 Exa 관련 설정에는 합리적인 기본값이 있습니다. 환경 변수를 통해 다음 중 하나를 재정의할 수 있습니다:스니펫이 조합되는 방식
FIM One은 Exa의 콘텐츠 필드를 통해 계단식으로 처리하여 API가 채운 콘텐츠 유형에 관계없이 모든 결과에서 유용한 스니펫을 생성합니다:highlights(…로 결합) — 존재할 때 선호됨text— 추출된 기사 텍스트로 폴백,EXA_TEXT_MAX_CHARS로 잘림summary— 위의 두 가지가 모두 비어 있을 때 사용됨
사전 설정: 뉴스 모니터링
사전 설정: 연구 논문 검색
사전 설정: deep-reasoning 에이전트
속성
FIM One의 모든 Exa 요청에는x-exa-integration: fim-one 헤더가 포함되어 있어 Exa가 유지보수자 대시보드에서 API 사용량을 이 통합으로 추적할 수 있습니다. 이는 통합 수준의 속성 지정에만 사용되며 최종 사용자 식별이나 추적에는 사용되지 않습니다.
Translation (ko)
Exa 커넥터는src/fim_one/core/web/search/exa.py에 위치하며, Jina, Tavily, Brave와 동일한 BaseWebSearch 프로토콜을 따릅니다 — 제공자 전환은 단일 환경 변수 변경으로 가능합니다.