에이전틱 RAG 노드#
에이전트가 검색 전략을 스스로 판단하며 문서를 탐색하는 RAG 노드입니다. 탐색 과정에서 폴더 및 문서 범위를 선택하고, 다양한 검색 방식을 조합해 단계적으로 탐색과 추론을 수행합니다.에이전틱 RAG 노드는 기존 검색(RAG) 노드와 달리, 에이전트가 매 라운드마다 검색 전략을 스스로 결정하며 문서를 탐색하는 노드입니다.
단일 쿼리로 1회 검색하는 것이 아니라, 여러 라운드에 걸쳐 탐색과 판단을 반복하며 답변에 필요한 근거를 수집합니다.
여러 문서를 교차 참조해야 하는 분석·비교·종합형 질문처럼, 한 번의 검색으로는 충분한 답을 얻기 어려운 경우에 적합합니다.
동작 방식#
에이전틱 RAG 노드는 내부적으로 다중 라운드의 탐색·추론 파이프라인으로 동작합니다.
각 라운드에서 에이전트는 어떤 검색 스킬을 사용할지, 어떤 범위를 탐색할지를 자율적으로 판단합니다.
3.
검색된 청크로부터 핵심 사실(팩트)을 추출하고 축적
충분한 근거가 수집되었거나 설정한 조건에 도달하면, 수집된 결과를 종합하여 최종 답변을 생성합니다.
추론 과정에 등장하는 스킬#
| 스킬 | 무엇을 하나요? | 언제 작동하나요? |
|---|
| 이전 기억 탐색 | 이전 대화에서 축적된 검색 전략과 데이터 관련 사전 지식을 불러옵니다. | 질문 처리가 시작될 때 최초 1회 수행됩니다. |
| 파일 검색 | 질문과 관련된 문서 및 파일을 식별하여 검색 범위를 설정합니다. | 자료의 범위를 좁혀야 할 때 수행됩니다. |
| 청크 검색 | 선별된 문서 내에서 질문에 대한 답변이 포함된 단락을 탐색합니다. | 문서의 세부 내용을 확인해야 할 때 수행됩니다. |
| SQL 검색 | 데이터베이스에 직접 질의하여 수치, 집계, 표 형태의 데이터를 조회합니다. | 통계 및 정량적 정보가 필요한 질문에 수행됩니다. |
| 답변 생성 | 수집된 자료를 종합하여 최종 답변을 생성합니다. | 모든 검색 과정이 완료된 후 마지막에 수행됩니다. |
검색 쿼리#
에이전트가 문서 탐색을 시작할 때 사용하는 초기 검색 쿼리입니다.
RAG 탐색의 출발점이 되며, 해당 쿼리를 기준으로 첫 번째 탐색이 수행됩니다.
기본값으로 {{query}}(사용자 입력)가 설정되어 있으며, 변수를 활용하여 직접 정의할 수도 있습니다.
RAG 탐색 가이드#
에이전트가 탐색할 때 참고할 추가 맥락 정보를 제공하는 선택 입력 항목입니다.
탐색 전략, 도메인 지식, 학습된 문서의 구조나 범위 등을 안내하면 더 정확한 탐색이 가능합니다.
입력하지 않아도 동작하지만, 문서량이 많거나 도메인이 전문적인 경우 입력을 권장합니다.
검색할 지식 범위#
에이전트에 학습된 전체 문서: 등록된 모든 지식을 대상으로 탐색합니다.
특정 폴더에 학습된 문서: 선택한 폴더 내 문서만을 대상으로 탐색합니다.
폴더를 지정하면 불필요한 문서 탐색을 줄여 정확도와 속도를 높일 수 있습니다.
최대 탐색 라운드#
에이전트가 문서 탐색과 판단을 반복할 수 있는 최대 횟수를 설정합니다. (범위: 1~20, 기본값: 10)
각 라운드마다 탐색 대상과 검색 방식을 재결정하며, 설정한 라운드 수에 도달하면 추가 탐색을 중단합니다.
라운드 수를 높이면 더 깊이 탐색하지만, 그만큼 응답 시간과 토큰 비용이 증가합니다.
최대 탐색 허용 시간#
탐색에 허용되는 최대 시간을 설정합니다. (범위: 0~1,200초, 기본값: 180초)
시간 내에 모든 라운드가 끝나지 않아도, 그 시점까지 수집된 결과를 기반으로 답변이 자동 생성됩니다.
응답 시간에 제약이 있는 서비스에서는 이 값을 조절하여 응답 속도를 제어할 수 있습니다.
히스토리 턴 수#
에이전트가 응답 생성 시 참고할 이전 대화의 턴 수를 설정합니다. (범위: 0~5, 기본값: 5)
멀티턴 대화에서 맥락을 유지하고 싶다면 이 값을 유지하고, 매 질문을 독립적으로 처리하려면 0으로 설정합니다.
탐색 종료 조건#
에이전틱 RAG 노드의 탐색은 아래 조건 중 하나가 충족되면 종료됩니다.
| 종료 조건 | 동작 |
|---|
| 충분한 근거 수집 | 에이전트가 답변에 충분하다고 판단 → 최종 답변 생성 |
| 최대 라운드 도달 | 설정한 라운드 수에 도달 → 현재까지 결과로 답변 생성 |
| 최대 시간 초과 | 설정한 허용 시간 초과 → 현재까지 결과로 답변 생성 |
어떤 조건으로 종료되었는지는 실행 로그의 추론 과정 탭에서 확인할 수 있습니다.
실행 로그 확인#
에이전틱 RAG 노드의 실행 로그에서는 에이전트의 추론 과정을 상세하게 확인할 수 있습니다.
추론 과정 탭: 각 라운드에서 사용한 검색 스킬, 검색된 청크 수, 추출된 팩트 수, 토큰 사용량, 신뢰도 점수를 시간 순서대로 표시합니다.
상세로그 탭: 최종 답변 생성 결과와 전체 실행 데이터를 JSON 형태로 확인할 수 있습니다.
활용 예시#
여러 문서를 교차 참조하여 종합적인 분석이 필요한 질문 응답
대량의 문서에서 특정 정보를 정밀하게 찾아야 하는 탐색
단순 키워드 매칭으로는 찾기 어려운, 맥락 기반의 복합 질의 처리
내부 문서와 웹 검색을 조합하여 포괄적인 답변을 구성해야 하는 경우
에이전틱 RAG 노드를 워크플로우 내에서 병렬 실행하는 경우, 토큰 비용이 크게 증가할 수 있습니다.
병렬 구성이 필요한 경우 탐색 라운드와 허용 시간을 보수적으로 설정하는 것을 권장합니다.
