선택한 cPanel 문서 섹션만 FlowHunt 챗봇에 연동하는 방법 (전체 사이트 불필요)

소개 – 이 글이 해결하는 문제는?

많은 조직들이 FlowHunt 챗봇을 cPanel & WHM과 같은 특정 기술 제품의 도메인 전문가로 만들고 싶어합니다. 하지만 cPanel 공식 문서 사이트(docs.cpanel.net)는 방대하고 다양한 주제를 다루고 있어, 실제로 챗봇 사용자에게 불필요하거나 혼란을 줄 수 있는 정보도 많이 포함되어 있습니다. 전체 문서 사이트를 가져오면 챗봇이 너무 많은 정보를 받아 인덱싱 시간이 길어지고, 답변의 정확성도 떨어질 수 있습니다.

다행히 FlowHunt의 Document Retriever를 활용하면 챗봇이 선택한 문서 페이지만 학습하도록 할 수 있습니다. 이 글에서는 필요한 cPanel 문서만 직접 선별해 단계별로 FlowHunt에 가져오고, 챗봇의 지식이 최신 상태와 적합성을 유지하도록 하는 전체 과정을 안내합니다. 예를 들어, 챗봇이 오직 cPanel의 DNS, API, 보안, 사용자 관리 등 특정 주제만 답하도록 만들고 싶다면, 불필요한 문서 없이 전문성을 세밀하게 조정할 수 있습니다.

이 과정을 따르면 불필요한 데이터 과부하를 피하고, 유지 관리도 수월해지며, 사용자에게 더 빠르고 정확한 답변을 제공할 수 있습니다. 아래 가이드에서는 기술적 절차뿐 아니라 장기적인 활용을 위한 모범 사례와 팁도 함께 다룹니다.

FlowHunt란 무엇이며, 지식은 어떻게 인입하나요?

FlowHunt는 조직이 내부/외부 지식원을 활용해 AI 챗봇을 쉽고 빠르게 구축·학습·배포할 수 있도록 설계된 노코드 플랫폼입니다. 그중 Document Retriever 컴포넌트는 정적 문서(매뉴얼, 가이드, API 레퍼런스 등)와 챗봇의 동적 상호작용을 연결하는 역할로, 챗봇에 특정 URL이나 파일을 바로 연결할 수 있게 해줍니다.

일부 챗봇 프레임워크처럼 전체 사이트를 크롤링할 필요 없이, FlowHunt에서는 원하는 웹페이지, 문서 섹션, PDF만 개별적으로 선택해 가져올 수 있습니다. 즉, 챗봇이 알아야 할 지식을 세밀하게 제어할 수 있습니다. Document Retriever는 가져온 콘텐츠를 파싱·인덱싱하여, 챗봇이 실시간으로 맥락에 맞는 답변을 할 수 있도록 만듭니다.

대표적인 활용 예시로는 제품 매뉴얼을 학습한 고객지원 챗봇, HR 정책에 특화된 온보딩 챗봇, 특정 제품 영역만 아는 기술 지원 챗봇 등이 있습니다. cPanel의 경우, 예를 들어 DNS 관리만 완벽하게 알고, 보안이나 메일 등 다른 모듈은 전혀 모르는 챗봇을 만들 수도 있습니다.

docs.cpanel.net 구조 이해하기

cPanel 공식 문서 포털(docs.cpanel.net)은 명확한 계층 구조로 구성되어 있으며, 각 주제나 기능별로 고유한 URL을 가지고 있습니다. 예를 들어 “도메인”, “API 2 Functions”, “사용자 관리” 등 각각의 페이지가 별도의 URL로 제공됩니다. 페이지는 대체로 정적이며, 주소가 일정하게 유지되어 링크나 즐겨찾기에 용이합니다.

챗봇이 학습할 문서를 고르려면, docs.cpanel.net 메인 페이지를 탐색하거나 검색 기능을 활용하세요. 각 섹션/주제는 새 페이지로 열리고, 브라우저 주소창의 URL이 바로 그 문서의 직접 링크입니다. 예시:

• https://docs.cpanel.net/cpanel/domains/domains/
• https://docs.cpanel.net/whm/api/api-functions/
• https://docs.cpanel.net/knowledge-base/security/

조직이나 사용자에게 필요한 섹션의 URL만 복사해서, 챗봇 지식 베이스를 해당 주제로만 제한할 수 있습니다. 특히, 지원팀이 일부 cPanel 모듈만 다루거나, 베타/폐기/파트너 전용 문서는 제외하고 싶을 때 이 방식이 유용합니다.

필요한 cPanel 문서 URL을 수집·정리하는 방법

FlowHunt에 가져오기 전에, 챗봇이 이해하길 원하는 문서 URL 목록을 먼저 준비해야 합니다. 다음 단계대로 따라 해보세요:

1. 관심 주제 선정: 챗봇이 다룰 cPanel 기능·모듈·가이드의 범위를 정하세요. 예컨대 “도메인”, “SSL/TLS”, “API 토큰” 섹션만 필요하다면 해당 주제만 고릅니다.

2. 탐색 및 URL 복사: https://docs.cpanel.net 에 접속해 사이드바나 검색창으로 각 주제를 찾고, 포함할 페이지마다 브라우저의 전체 주소(URL)를 복사합니다.

3. 목록 정리: 복사한 URL을 스프레드시트(Google Sheets, Excel)나 텍스트 파일에 붙여넣으세요. 원하는 경우 주제별로 그룹화할 수도 있습니다. 이러면 추후 관리나 업데이트가 쉬워집니다.

4. 콘텐츠 안정성 확인: 선택한 페이지가 ‘폐기됨’ 또는 ‘공사 중’으로 표시되어 있지 않은지 확인하세요. 변경 가능성이 낮고 잘 관리되는 섹션 위주로 고르세요.

5. (선택) 업데이트 주기 메모: 자주 변경되는 문서(API 레퍼런스 등)는 주기적으로 다시 확인 및 재가져오기가 필요합니다. 이를 별도 메모해두면 좋습니다.

예시 URL 목록:

https://docs.cpanel.net/cpanel/domains/domains/
https://docs.cpanel.net/whm/api/api-functions/
https://docs.cpanel.net/knowledge-base/security/

FlowHunt에 선택한 cPanel 문서 URL 가져오기

목록 준비가 끝났다면, 이제 FlowHunt에 문서를 가져올 차례입니다. 이 과정은 Document Retriever 컴포넌트를 사용하며, 한 번에 여러 URL도 입력할 수 있습니다. 방법은 다음과 같습니다:

1단계: FlowHunt 관리자 콘솔 접속

FlowHunt 워크스페이스에 로그인한 뒤, 학습시킬 챗봇을 선택하세요. 챗봇 설정에서 “지식 베이스” 또는 “Document Retriever” 섹션으로 이동합니다.

2단계: 새로운 지식원 추가

“소스 추가(Add Source)” 또는 “문서 추가(Add Document)” 버튼을 찾으세요. 이때 파일 업로드가 아니라 URL 추가 옵션을 선택합니다.

3단계: URL 붙여넣기

• 단일 가져오기: 원하는 docs.cpanel.net URL을 입력란에 붙여넣고 확인합니다.
• 일괄 가져오기: 지원될 경우, 여러 URL을 줄바꿈으로 구분해 붙여넣거나, 텍스트 파일을 업로드하세요.

4단계: 파싱 옵션 설정

FlowHunt는 가져온 콘텐츠를 어떻게 인식할지 옵션을 제공합니다:

• H1부터 시작: 첫 번째 메인 헤더(H1)부터 인덱싱(네비게이션/서문 건너뜀)
• 마지막 헤더 건너뜀: 푸터나 불필요한 네비게이션 제외
• 포인터로 불러오기: CSS 선택자 등으로 본문 영역만 지정 가능

챗봇이 네비게이션, 푸터 등 불필요한 내용을 자주 언급한다면 이 옵션을 조정하세요.

5단계: 저장 및 인덱싱

URL 추가 후 “저장” 또는 “인덱스”를 클릭하면, FlowHunt가 페이지를 처리해 본문을 추출하고 챗봇 지식 베이스에 추가합니다.

6단계: 테스트 및 보완

가져오기가 끝나면 챗봇 테스트 기능으로 관련 질문을 해보세요. 답변이 누락되거나 불필요한 정보가 나오거나, 오래된 내용이 보이면 URL 목록을 다시 확인하거나 파싱 옵션을 조정하세요.

참고: docs.cpanel.net의 문서가 업데이트될 경우, 해당 URL을 수동으로 다시 가져와야 챗봇의 지식이 최신으로 유지됩니다.

FlowHunt에서 cPanel 문서 활용 시 모범 사례와 한계

모범 사례

• 선택적 인입: 사용자에게 꼭 필요한 문서만 가져오세요. 너무 많은 정보는 답변을 산만하게 만듭니다.
• 주제별 정리: URL을 도메인, 보안, API 등 기능별로 그룹화하면 유지보수와 문제 해결이 편리해집니다.
• 업데이트 모니터링: cPanel 문서는 변동될 수 있으니, 월 1회 또는 분기별로 주요 변경사항을 확인하고 URL을 갱신하세요.
• 명확한 제목 사용: URL 추가 시 FlowHunt에서 “cPanel 도메인 가이드”처럼 구체적인 이름을 붙이면 관리에 도움이 됩니다.
• 철저한 테스트: 가져오기·업데이트 후 실제 질문을 던져서 올바른 정보가 제공되는지 항상 확인하세요.

알려진 한계

• 동적/인터랙티브 콘텐츠: FlowHunt Document Retriever는 정적 텍스트 위주 문서에 최적화되어 있습니다. 일부 인터랙티브 요소나 위젯은 제대로 파싱되지 않을 수 있습니다.
• 수동 업데이트 필요: docs.cpanel.net 변경 시 자동 동기화 기능이 없으므로, 바뀐 URL은 직접 주기적으로 다시 가져와야 합니다.
• 페이지 구조 의존성: cPanel이 문서 레이아웃이나 구조를 크게 바꾸면, 이전에 추가한 URL이 무의미해지거나 적합성이 떨어질 수 있습니다.
• 콘텐츠 범위 제한: 추가된 URL 페이지 내 콘텐츠만 챗봇이 인식합니다. “참고” 등 링크된 타 페이지는 자동으로 포함되지 않으니, 필요한 페이지는 각각 URL을 명확히 추가해야 합니다.

위 가이드대로 따라 하면, 전체 문서셋의 방해 없이 FlowHunt 챗봇이 정확하고 최신의 cPanel 답변을 제공할 수 있습니다. 이 방식은 챗봇을 빠르고 정확하게 유지하고, 대상 사용자에 딱 맞는 정보만 제공하도록 만들어줍니다.