XML 문서 검색 컴포넌트는 XML 문서 내에서 검색을 용이하게 하기 위해 설계된 다재다능한 도구입니다. 단순 텍스트 검색은 물론 pandas에서 사용하는 것과 유사한 고급 쿼리도 지원하여, AI 워크플로우에서 구조화된 데이터 자원에서 특정 정보를 추출하는 데 적합합니다.
이 컴포넌트가 하는 일
이 컴포넌트를 사용하면 사용자는 XML 파일 내에서 검색을 수행할 수 있습니다. 내부 문서를 업로드하거나 XML 파일의 URL을 제공하는 방식으로 사용할 수 있습니다. 특정 요소나 값을 찾거나, 다양한 기준에 따라 콘텐츠를 필터링하며, AI 파이프라인의 후속 처리에 필요한 데이터를 추출할 수 있습니다.
주요 기능 및 역량
- 텍스트 및 쿼리 검색: 기본 텍스트 매칭 또는 pandas와 유사한 쿼리 표현식을 이용해 더욱 복잡한 데이터 검색이 가능합니다.
- 유연한 소스 선택: 내부 문서(ID로 선택)와 외부 XML 파일(URL로 불러오기) 모두 지원합니다.
- 요소 필터링: 경로 지정으로 특정 XML 요소로 검색 범위를 제한할 수 있습니다.
- 대소문자 구분: 검색 시 대소문자 구분 여부를 선택할 수 있습니다.
- 결과 제한: 반환할 최대 결과 수를 지정하여 과도한 출력 방지.
- 캐싱: XML 파일의 내용을 지정한 기간 동안 캐싱하여 성능 향상 및 불필요한 처리 감소.
- 상세 출력: 실행 시 로그를 더 자세하게 확인할 수 있는 상세 모드 지원.
입력
이 컴포넌트에는 별도의 입력 핸들이 제공되지 않습니다.
설정
아래는 구성 가능한 입력 파라미터 요약입니다:
| 입력명 | 설명 | 필수 여부 | 기본값 | 고급 |
|---|---|---|---|---|
| XML 문서 ID | 내부 XML 문서를 ID로 선택합니다. | 아니오 | (비어 있음) | 예 |
| XML 파일 URL | 내부 문서 사용이 아닌 경우 외부 XML 파일의 URL을 입력합니다. | 아니오 | (비어 있음) | 예 |
| 요소 경로 | 검색을 제한할 XML 요소 경로를 콤마로 구분하여 입력 (예: product,category). | 아니오 | (비어 있음) | 예 |
| 대소문자 구분 | 검색 시 대소문자 구분 여부. | 아니오 | False | 예 |
| 최대 결과 수 | 반환할 최대 결과 개수. | 예 | 50 | 아니오 |
| 캐시 TTL | XML 내용 캐싱 기간 (예: 캐싱 안 함, 5분, 2주 등). | 아니오 | 2주 | 예 |
| 상세 출력 | 디버깅 또는 상세 로그 출력을 활성화할지 여부. | 아니오 | False | 예 |
| 도구 이름 | 에이전트 워크플로우에서 참조할 때 유용한 사용자 지정 도구 이름. | 아니오 | (비어 있음) | 예 |
| 도구 설명 | 에이전트가 도구의 목적과 사용법을 이해하는 데 도움이 되는 설명. | 아니오 | (비어 있음) | 예 |
참고: 소스 XML 파일을 지정하려면 XML 문서 ID 또는 XML 파일 URL 중 하나를 제공해야 합니다.
출력
- 툴: 이 컴포넌트의 출력은 더 큰 AI 워크플로우 프로세스에 통합할 수 있는 툴 인스턴스입니다. 설정한 입력값에 따라 검색 결과를 반환합니다.
활용 사례 및 이점
- 데이터 추출: XML 파일에서 구조화 데이터를 신속하게 찾아 기계학습 모델이나 데이터 분석 작업에 활용.
- 콘텐츠 필터링: 요소 경로 지정으로 대형 XML 문서에서 특정 섹션이나 요소만 분리.
- 워크플로우 자동화: XML 데이터 검색을 자동화 파이프라인에 통합하여 원활한 데이터 수집 및 변환.
- 성능 최적화: 캐싱을 활용해 대용량 XML 파일의 반복 다운로드 또는 처리 방지, 워크플로우 효율 향상.
사용 시기
이 컴포넌트는 제품 카탈로그, 설정 파일, 구조화된 보고서 등 XML 형식의 정보를 활용해야 하는 AI 프로세스에서 특히 유용합니다. 간단한 조회부터 복잡한 쿼리까지 구성 가능하여, 다양한 데이터 추출 및 변환 시나리오에 적합합니다.
XML 문서 검색 컴포넌트를 활용하면 AI 워크플로우 내에서 XML 데이터 소스와 상호작용하고 가치를 추출하는 과정을 간소화할 수 있습니다.