DuckDuckGoSearch 컴포넌트 개요
DuckDuckGoSearch 컴포넌트는 DuckDuckGo 검색 엔진을 이용해 실시간 웹 검색을 AI 워크플로우에서 수행할 수 있도록 해줍니다. 사용자가 정의한 검색 쿼리를 받아, 관련 웹 결과( URL 및 콘텐츠 포함 )를 반환하여, 지식 검색, 연구 작업 또는 LLM에 최신 인터넷 정보를 보강하는 데 강력한 도구가 됩니다.
이 컴포넌트는 무엇을 하나요?
- 제공된 키워드(쿼리)로 DuckDuckGo에서 검색을 실행합니다.
- 결과 개수를 설정할 수 있습니다(기본값: 3개).
- 지역, 세이프서치 수준, 기간별 필터링이 가능합니다.
- 구조화된 URL 레코드와 일반 텍스트로 결과를 반환하여, 추가 자동 처리나 화면 표시 등에 적합합니다.
- 독립형 도구로도, 에이전트 기반 워크플로우에 통합해서도 사용할 수 있습니다.
입력값
| 이름 | 설명 | 타입 | 필수 | 기본값 | 고급 |
|---|---|---|---|---|---|
| 입력 키워드 | 검색할 키워드 또는 쿼리 문자열입니다. | 문자열 | 예 | (빈값) | 아니오 |
| 최대 결과 수 | 반환할 결과의 개수입니다. | 정수 | 예 | 3 | 아니오 |
| 지역 | 지역/언어 코드로 현지화된 결과를 반환합니다 (예: us-en, uk-en, ru-ru). | 문자열 | 예 | us-en | 예 |
| 세이프서치 | 세이프서치 필터: strict, moderate, off 중 선택합니다. | 문자열 | 예 | moderate | 예 |
| 기간 제한 | 결과를 기간별로 제한: d(일), w(주), m(월), y(년). | 문자열 | 예 | y | 예 |
| 도구 설명 | (선택) 에이전트가 이 도구를 어떻게 사용하는지 이해할 수 있도록 설명을 추가합니다. | 문자열 | 아니오 | (빈값) | 예 |
| 도구 이름 | (선택) 에이전트 프레임워크 내에서 이 도구를 참조할 별칭입니다. | 문자열 | 아니오 | (빈값) | 예 |
| Verbose | 실행 중 자세한/디버그 출력을 출력할지 여부입니다. | 불리언 | 아니오 | false | 예 |
출력값
이 컴포넌트는 세 가지 출력 형식을 제공합니다:
URL 레코드 (
UrlRecord)- 각 검색 결과의 URL과 해당 콘텐츠를 포함한 구조화된 리스트입니다. 프로그래밍적 활용이나 다른 컴포넌트와 연결할 때 유용합니다.
텍스트로 된 URL (
Message)- 검색 결과를 읽기 쉬운 텍스트로 포매팅한 형태로, 바로 표시하거나 메시지 기반 플로우에 통합하기에 적합합니다.
도구로서의 DuckDuckGo 검색 (
Tool)- 전체 검색 동작을 도구 객체로 감싸, 에이전트 기반 또는 도구 사용형 AI 시스템에서 활용할 수 있게 합니다.
이 컴포넌트를 써야 하는 이유
- 최신 정보 접근: AI 워크플로우가 최신 웹 정보를 쿼리할 수 있어, LLM이나 AI 에이전트가 학습 데이터에 없는 최근 데이터를 필요로 할 때 특히 유용합니다.
- 유연한 설정: 지역, 세이프서치, 기간 필터링 등 다양한 맞춤 설정을 지원합니다.
- 다양한 출력 형식: 후속 작업에 가장 적합한 출력 형식을 선택할 수 있어, 자동 처리나 최종 사용자에게 보여줄 때 모두 유용합니다.
- 에이전트 통합: 에이전트 기반 프레임워크에서 쉽게 참조와 설명이 가능하도록 설계되어, 복잡한 AI 오케스트레이션에 적합합니다.
예시 사용 사례
- 답변 보강: LLM의 답변을 실시간 웹 검색 결과로 강화.
- 지식 추출: 요약이나 분석을 위한 최신 웹 콘텐츠 수집.
- 연구 자동화: 특정 주제, 분야, 기간에 대한 정보 수집 자동화.
이 컴포넌트는 외부 지식과 최신 웹 데이터를 필요로 하는 워크플로우에 필수적이면서도 다재다능한 빌딩 블록입니다.