Exa 검색 API: AI Flowi Workflow의 Exa Search 도구 연동

Exa 검색 API를 AI Flowi Workflow에서 사용할 때 Exa Search는 검색 및 콘텐츠 가져오기 툴킷으로서 검색 결과 행을 직접 반환하는 대신 Tool을 반환합니다. 제공업체 키와 툴킷 제어를 설정한 뒤, 출력을 Agent에 연결하기 전에 도구 정의를 점검합니다. 내보낸 Exa Search 노드에는 질의 필드가 없습니다.

이 툴킷은 카탈로그에 문서화되어 있으며, Ai Flowi가 프로덕션 환경에서 테스트하지 않았습니다. 이 페이지는 2026년 10월 9일에 내보낸 AI Flowi Workflow 1.9.2 카탈로그를 기준으로 합니다. 도구를 준비하는 작업과 실제로 호출하여 검색된 자료를 검토하는 작업을 구분합니다.

작성: Ai Flowi · 게시일 2026-10-10

공식 출처: Exa 문서

결과를 직접 반환하는 노드가 아닌 툴킷의 규약

Exa 툴킷 표는 가로 스크롤을 지원하여 작은 화면에서도 자격 증명과 출력 이름을 읽을 수 있습니다.

exa.ExaSearch를 사용해 구성 요소 카탈로그에서 대상 항목을 식별합니다. 기존 Web Search 참고 자료는 직접 질의하는 Table 인터페이스를 다룹니다. 그 인터페이스를 Exa에 그대로 적용하면 이 툴킷에 없는 질의 입력과 Table 출력을 만들어 내게 됩니다.

키, 검색 제한, 유사 결과 제한, autoprompt

자격 증명 이름은 내보낸 그대로 metaphor_api_key를 유지합니다. 제공업체의 표시 이름에 맞추려고 필드 이름을 바꾸면 이 스냅샷에 없는 설정이 됩니다. 필수 여부도 주의해서 읽어야 합니다. 선택 메타데이터는 누락된 자격 증명을 어디에서 확보하는지 설명하지 않으며, 자격 증명 없이 제공업체 호출을 실행할 수 있다는 증거도 아닙니다.

두 결과 수 제어는 각각 기록해야 합니다. 검색 결과 설정만으로 유사 콘텐츠 작업의 결과 수가 결정되지는 않으며, 어느 정수도 Agent의 반복 한도를 설정하지 않습니다. use_autoprompt를 테스트할 때는 여러 설정 변경이 비교에 섞이지 않도록 다른 설정과 작업 텍스트를 고정합니다.

tools 포트가 전달 지점입니다

유일한 출력의 이름은 tools이고, 표시 이름은 Tools, 유형은 Tool입니다. 이 항목에는 JSON, Message, Table 결과 포트가 없습니다. Agent가 툴킷을 사용할 수 있다는 사실만으로 Agent가 실제로 선택했는지, 적절한 인수를 사용했는지, 유용한 원문 콘텐츠를 받았는지는 확인되지 않습니다.

사용하기 전에 작업 공간에서 생성된 도구 이름, 설명, 허용 인수를 점검합니다. 카탈로그 항목에는 개별 도구 목록이나 질의 스키마가 없습니다. 따라서 툴킷 설명만으로 특정 검색 방식, 유사도 인수, 콘텐츠 키, 응답 구조를 보장하는 것은 이릅니다.

제공업체와 모델 접근을 별도로 준비합니다

설정한 제공업체 경로에는 본인의 Exa 계정과 API 키가 필요하며, 제공업체 사용료는 별도로 지불합니다. 내보낸 metaphor_api_key 필드로 자격 증명을 입력합니다. 자격 증명 방식은 연결 가이드를 참고합니다. 허용 유형 목록이 비어 있다는 이유로 변수 로딩 기능을 가정하지 말고, 이 필드에서 지원되는지 확인합니다.

출력을 받는 Agent를 설정할 때는 Agent 연결 참고 자료와 해당 자료에 연결된 모델 접근 지침을 따릅니다.

범위를 제한한 Agent 설정을 점검합니다

예시 설정이며, 기록된 테스트가 아닙니다

1. Exa Search를 추가하고 metaphor_api_key로 본인의 제공업체 키를 입력합니다. 명시적인 점검 설정으로 search_num_results를 3, similar_num_results를 2, use_autoprompt를 false로 설정합니다.
2. 생성된 툴킷 정의를 점검합니다. 계획한 작업에 적합한 도구를 식별하고 필요한 인수를 확인합니다. 이 페이지에서는 추측한 인수 이름을 제공하지 않습니다.
3. Language Model을 추가하고 필수 model과 제공업체 접근을 설정합니다. 그런 다음 model_output을 Agent의 필수 model에 연결합니다.
4. Exa Search의 tools를 Agent.tools에 연결합니다. Agent의 input_value를 Find source material explaining workflow input validation and retain the source references.로 설정합니다.
5. system_prompt에서 관찰된 도구 근거, 출처 참조 보존, 검색 실패 시 명시적인 미해결 결과를 요구합니다. 점검 한도로 max_iterations를 2로 설정합니다. 완료나 정확한 호출 횟수를 보장하지 않습니다.
6. Agent.response를 Message를 받는 Chat Output의 input_value에 연결합니다. 검색된 주장을 받아들이기 전에 실제 도구 활동과 응답을 검토합니다.

의도한 결과는 본인의 실행에서 점검할 수 있는 검색 근거가 동반된 Agent 응답입니다. Agent가 검색했다고 말하는 문장만으로는 충분하지 않습니다. 도구 호출이 관찰되지 않으면 생성된 텍스트를 Exa 출력으로 취급하지 말고 호출이 없었다는 사실을 기록합니다.

출처 품질보다 먼저 도구 인수를 점검합니다

먼저 선택한 도구가 작업에 적합했는지, 관찰된 인수가 의도한 질문을 반영했는지 확인합니다. 그런 다음 반환된 참조와 콘텐츠를 검토합니다. 이 순서는 품질이 낮은 출처 후보와 올바른 검색 질문을 하지 않은 Agent를 구분합니다.

툴킷의 실제 인터페이스를 알 때까지 검색과 유사 콘텐츠 점검을 구분합니다. similar_num_results 필드는 유사도 작업이 어떤 출처를 사용하는지 설명하지 않습니다. 실제 호출을 점검할 때 해당 출처나 인수를 기록하고, 설명되지 않은 결과 집합을 문서화된 유사도 절차의 결과라고 판단하지 않습니다.

관련 자료: arXiv API 사용법: AI Flowi Workflow 논문 검색 연동; DuckDuckGo 검색 API: AI Flowi Workflow의 검색·결과 제한.

Exa 툴킷 설정이 적합하지 않은 경우는 언제인가요?

내보낸 자료에는 질의 입력란, 날짜 필터, 도메인 허용 목록, 콘텐츠 크기 제한, 시간 초과, 재시도 필드가 없습니다. autoprompt의 재작성 규칙도 없습니다. 작업에 이런 제어가 필요하다면 이 노드에서 지원된다고 설명하기 전에 도구 정의와 실제 제공업체 규약을 점검합니다.

워크플로우에 Agent가 도구를 선택하는 방식 대신, 질의를 Table 결과로 직접 연결하는 정해진 경로가 필요하다면 직접 결과를 반환하는 구성 요소를 선택합니다. Exa 출력을 검색된 텍스트로 취급하거나 Table만 받는 필드에 연결하지 않습니다. 호환되는 Tool 연결은 시작 설정이며, 도구 실행, 출처 점검, 오류 처리는 여전히 검증해야 합니다.

서로 구분되는 세 가지 툴킷 점검

비교를 설정하기 전에 툴킷 정의로 어떤 점검이 가능한지 결정합니다. 배포된 Exa 항목이 제공하는 호출 가능 항목의 이름과 허용 인수를 기록합니다. 계획한 작업에 해당하는 호출 가능 항목이 없다면 정의 단계에서 해당 연습을 중단합니다. search_num_results와 similar_num_results라는 이름은 별도 설정 대상을 시사하지만, 누락된 호출 가능 항목 이름이나 인수 스키마를 제공하지는 않습니다.

검색 연습에서는 제안된 Agent 설정의 문서 탐색 작업으로 시작합니다. 어떤 호출 가능 항목이 선택되었는지, 노출된다면 실제 질의 인수가 무엇인지 관찰합니다. 그 인수가 워크플로우 입력 검증을 묻는지, Agent가 도입한 더 넓은 주제를 묻는지 확인합니다. 검색 전에 작업이 바뀌었다면 반환 후보를 판단하기 전에 그 변경을 검토합니다. 이어서 선택한 검색 제어와 반환 표현의 관계를 점검합니다. 툴킷의 모든 호출 가능 항목에서 제한이 동일하게 적용된다고 가정하지 않습니다.

유사 콘텐츠 연습에는 허용 인수 규약에 따라 정한 기준 입력이 필요합니다. 출처 주소를 요구한다면 점검 가능한 주소를 선택하고, 그 출처가 원하는 주제를 대표하는 이유를 설명합니다. 다른 값을 요구한다면 문서화된 형식을 사용합니다. similar_num_results를 점검할 때 기준 입력은 고정합니다. 부적절한 기준 입력에 연관된 결과 집합은 일관된 유사도 결과이면서도 원래 탐색 작업에는 실패할 수 있습니다. 기준 입력과 제한을 함께 바꾸면 이 차이가 가려집니다.

autoprompt 연습에서는 같은 작업, 호출 가능 항목, 관련 제한을 유지하면서 use_autoprompt를 false에서 true로 바꿉니다. 관찰 가능한 요청 변환을 점검합니다. 변환이 숨겨져 있다면 스위치는 변경했지만 재작성된 요청은 점검할 수 없었다고 보고합니다. 후보가 달라졌다는 사실만으로 재작성 규칙을 알아낼 수 없습니다. 마찬가지로 후보가 그대로라는 사실도 스위치가 아무 일도 하지 않았다는 증거가 아닙니다. 내보낸 자료에는 그런 결론과 대조할 내부 동작 설명이 없습니다.

호출 가능 항목 부재, 관찰되지 않은 호출, 인수 불일치, 부적합한 검색 콘텐츠를 서로 다른 결과로 기록합니다. 각각 조사해야 할 툴킷 전달 단계가 다릅니다. 예를 들어 similar_num_results를 낮춰도 잘못된 질문을 전달한 검색 호출을 고칠 수는 없습니다. 이러한 점검은 이 툴킷이 작업에 맞는지 판단할 근거를 제공합니다. Exa 벤치마크를 입증하거나 직접 결과 행만 필요한 워크플로우에 모델 단계를 추가하도록 요구하지는 않습니다.

툴킷 및 Agent 사용량

요금제: Go 연간 결제 시 월 USD8부터(월간 USD10), Plus 월 USD16부터(월간 USD20), Pro 100 월 USD80부터(월간 USD100), Pro 200 월 USD160부터(월간 USD200), Pro 500 월 USD400부터(월간 USD500). 매월 5,000~250,000 Flowi Tokens가 제공되며 충전도 가능합니다. 노드 실행 1회당 1토큰, 타사 API 및 모델 사용 요금은 포함되지 않습니다.

연동 목록에는 전달 유형이 다른 검색 항목들이 포함되어 있습니다.