메인 콘텐츠로 건너뛰기
Exa는 FIM One의 일급 웹 검색 백엔드로 통합되어 있습니다. 智能体는 전체 Exa 검색 표면에 접근할 수 있습니다 — auto (Exa의 권장 기본값), neural, fast, deep-lite, deep, deep-reasoning, 및 instant — 구조화된 콘텐츠 검색(하이라이트, 텍스트, 요약) 및 풍부한 필터링(카테고리, 도메인 포함/제외, 날짜 범위 및 최대 기간 윈도우)을 포함합니다. 합리적인 기본값이 기본으로 제공되므로 다운스트림 개발자는 수동 조정 없이 Exa 모범 사례를 얻을 수 있습니다.

​
FIM One에서 Exa를 사용하는 이유

  • 에이전트 추론을 위한 신경망 검색 — Exa의 임베딩 기반 검색은 단순 키워드 매칭이 아닌 의미론적으로 관련된 결과를 반환합니다. 이는 웹 콘텐츠를 기반으로 추론하는 연구 에이전트에 중요합니다.
  • 어려운 쿼리를 위한 심화 추론 모드 — 에이전트가 직접 하위 쿼리를 조율하지 않고도 공개 웹에 대한 단일 호출 다중 홉 추론을 수행합니다.
  • 내장된 콘텐츠 추출 — 하이라이트 + 텍스트 + 선택적 요약이 검색 호출과 함께 제공되어 페이지 콘텐츠를 가져오고 정리하는 두 번째 왕복을 제거합니다.
  • 엄격한 도메인 / 최신성 제어 — 도메인 목록 포함/제외(최대 1200개 항목), ISO-8601 날짜 범위, 시간에 민감한 워크플로우를 위한 maxAgeHours를 포함합니다.

​
빠른 시작

​
1. Exa API 키 받기

exa.ai에서 가입하고 대시보드에서 API 키를 받으세요.

​
2. FIM One에서 키 설정

.env에 다음을 추가하세요: 
EXA_API_KEY=your_key_here
완료입니다. WEB_SEARCH_PROVIDER가 설정되지 않은 경우, EXA_API_KEY가 있으면 FIM One이 자동으로 Exa를 선택합니다. Exa를 명시적으로 설정하려면: 
WEB_SEARCH_PROVIDER=exa
EXA_API_KEY=your_key_here

​
3. 모든 에이전트에서 사용하기

웹 검색은 에이전트에 기본 제공 도구로 노출됩니다 — 추가 설정이 필요하지 않습니다. web_search가 활성화된 에이전트는 자동으로 Exa를 통해 라우팅됩니다.

​
구성

모든 Exa 관련 설정에는 합리적인 기본값이 있습니다. 환경 변수를 통해 다음 중 하나를 재정의할 수 있습니다:
변수기본값설명
EXA_API_KEY—필수. Exa API 키입니다.
EXA_SEARCH_TYPEautoauto, neural, fast, deep-lite, deep, deep-reasoning, instant 중 하나입니다.
EXA_CATEGORY—company, research paper, news, personal site, financial report, people 중 하나입니다.
EXA_INCLUDE_DOMAINS—쉼표로 구분된 허용 목록(최대 1200개 항목).
EXA_EXCLUDE_DOMAINS—쉼표로 구분된 차단 목록(최대 1200개 항목).
EXA_START_PUBLISHED_DATE—ISO-8601, 예: 2025-01-01.
EXA_END_PUBLISHED_DATE—ISO-8601.
EXA_MAX_AGE_HOURS—지난 N시간 내에 색인된 페이지만 반환합니다.
EXA_INCLUDE_HIGHLIGHTStrue결과에서 하이라이트 스니펫을 가져옵니다.
EXA_TEXT_MAX_CHARS800결과당 텍스트/스니펫 길이 상한선입니다.
EXA_SUMMARY_QUERY—결과당 선택적 사용자 정의 요약 프롬프트입니다.

​
스니펫이 어떻게 조립되는지

FIM One은 Exa의 콘텐츠 필드를 통해 API가 채운 콘텐츠 유형에 관계없이 모든 결과에 유용한 스니펫을 생성합니다:
  1. highlights (…로 결합) — 존재할 때 선호됨
  2. text — 추출된 기사 텍스트로 폴백, EXA_TEXT_MAX_CHARS로 잘림
  3. summary — 위의 두 항목이 모두 비어있을 때 사용됨
이는 Exa가 하이라이트를 추출할 수 없었던 결과에 대해서도 다운스트림 에이전트가 항상 비어있지 않은 스니펫을 추론할 수 있도록 보장합니다.

​
사전 설정: 뉴스 모니터링

EXA_SEARCH_TYPE=fast
EXA_CATEGORY=news
EXA_MAX_AGE_HOURS=24
EXA_TEXT_MAX_CHARS=1200

​
사전 설정: 연구 논문 검색

EXA_SEARCH_TYPE=neural
EXA_CATEGORY=research paper
EXA_INCLUDE_HIGHLIGHTS=true
EXA_TEXT_MAX_CHARS=2000

​
Preset: deep-reasoning 에이전트

EXA_SEARCH_TYPE=deep-reasoning
EXA_TEXT_MAX_CHARS=1500
EXA_SUMMARY_QUERY=What is the key finding and its supporting evidence?

​
속성 지정

FIM One의 모든 Exa 요청에는 x-exa-integration: fim-one 헤더가 포함되어 있어 Exa가 유지보수자 대시보드에서 이 통합으로 API 사용을 추적할 수 있습니다. 이는 통합 수준의 속성 지정에만 사용되며, 최종 사용자 식별이나 추적에는 사용되지 않습니다. Exa 커넥터는 src/fim_one/core/web/search/exa.py에 위치하며, Jina, Tavily, Brave와 동일한 BaseWebSearch 프로토콜을 따릅니다 — 제공자 전환은 단일 환경 변수 변경으로 가능합니다.

​
링크