시작하기 Knocket AI 에이전트

개요 — 콘솔의 구성 방식

AI 에이전트는 들어오는 방문자 메시지와 귀하의 받은 편지함 사이에 위치합니다. 제공하신 정보를 바탕으로 자신 있게 답변할 수 있다면, 방문자의 언어로 즉시 응답합니다. 그렇지 않거나 방문자가 사람에게 문의를 요청하면, 채팅을 조용히 전달하고 알림 채널을 통해 귀하에게 알립니다.

콘솔 왼쪽 사이드바에서 AI 에이전트는 세 개의 하위 페이지가 있는 그룹입니다. 이 튜토리얼의 모든 내용은 동일한 계층 구조를 따르므로 각 화면을 빠르게 찾을 수 있습니다:

• 설정 — 마스터 설정 페이지, 한 화면에 네 개의 접을 수 있는 카드
  • AI 에이전트 — 마스터 토글, 에이전트가 커버하는 채널, 활성화 시점
  • 봇 — 방문자가 보는 아바타, 이름, 인사말 및 시스템 프롬프트
  • LLM — 답변을 제공하는 제공자, API 키, 엔드포인트 및 모델
  • 핸드오프 — 트리거 문구 및 핸드오프 알림이 전송되는 위치
• 지식 — 한 페이지에 세 개의 탭: 자주 묻는 질문(FAQ) 쌍, URL 크롤링, 그리고 파일 업로드(에이전트가 응답 시 검색)
• 사용량 — 일일 요청 수, 모델별 토큰 사용량, 채널 분포

설정 — 한 페이지, 네 장 카드

사이드바에서 AI 에이전트 → 설정을 클릭하세요. 네 개의 접을 수 있는 카드(AI 에이전트, 봇, LLM, 전달)가 있는 페이지로 이동합니다. 각 항목이 완전히 설정되면 녹색 점이 표시됩니다. 하단의 단일 저장 버튼을 누르면 네 항목 모두에 변경사항이 적용됩니다.

이 AI 에이전트 카드 — 활성화하고, 채널과 시간을 선택하세요

상단 카드는 마스터 스위치입니다. 상단 오른쪽의 토글을 뒤집으면, LLM 핸드셰이크가 성공하면 연결됨 배지가 녹색으로 켜집니다.

AI 에이전트 채널 — 에이전트가 응답할 세 개의 진입점 중 어느 것을 선택할지 정하세요. 원하는 조합을 모두 활성화할 수 있습니다:

• 웹 위젯 — 웹사이트에 나타나는 채팅 버블.
• 모바일 위젯 — 네이티브 / RN / 플러터 앱에 내장된 채팅 버블.
• 문의 페이지 — 공유 가능한 knocket.ai 프로필 페이지.

꺼진 채널도 여전히 인박스로 라우팅됩니다 — 메시지는 AI 사전 분류 없이 바로 사람에게 전달됩니다.

AI 에이전트 지원 시간:

• 항상 — 상담원은 24시간 연중무휴로 팀과 병행하여 답변합니다.
• 오프라인일 때 — 에이전트는 근무 외 시간에만 응답하므로, 당신이 업무 중일 때는 사람의 답변이 기본값으로 유지됩니다.

이 봇 카드 — 아바타, 이름, 인사말, 시스템 프롬프트

봇 카드를 확장하세요. 이것은 방문자가 보는 것과 모델이 행동하는 방식입니다. 아바타를 제외한 네 개의 필드가 모두 필수입니다:

• 아바타 — JPG / JPEG / PNG, 최대 1MB. 드래그 앤 드롭하거나 클릭하여 업로드하세요. 비워두면 위젯이 텍스트만 표시하는 헤더를 보여줍니다.
• 이름 — 채팅 헤더에 표시되는 이름(예: AI 어시스턴트, Acme에 문의).
• 인사말 — 최대 400자. 방문자가 채팅을 열 때 에이전트가 보내는 첫 번째 메시지.
• 시스템 프롬프트 — 최대 2000자. 모델이 모든 대화 시작 시 읽는 평이한 언어의 간략한 설명입니다.

콘솔에 기본 제공되는 시스템 프롬프트 템플릿은 좋은 출발점입니다 — 간결하게 유지하고, 책임과 규칙을 명확히 설명하며, 모델에 사실을 기억하도록 지시하기보다는 지식 기반을 활용하세요:

당신은 AI 기반 고객 지원 에이전트입니다. 회사의 제품, 문서, 가격, 서비스에 대한 질문에 답변하여 웹사이트 방문자를 돕습니다. 당신의 책임: - 제공된 지식 기반을 검색하고 사용하여 사용자 질문에 답변합니다. - 명확하고 정확하며 간결한 응답을 제공합니다. - 가능한 경우 유용한 리소스로 사용자를 안내합니다. - 문제를 해결할 수 없는 경우 인간 지원으로 에스컬레이션합니다. 규칙: - 정보를 날조하지 마세요. - 제공된 지식 소스를 기반으로만 답변하세요. - 정보가 없는 경우 정중하게 말하세요. - 전문적인 고객 지원 어조를 유지하세요.

이 LLM 카드 — 제공자, 키, 엔드포인트, 모델

LLM 카드를 확장하세요. 이것은 에이전트를 OpenAI 챗 완성 프로토콜을 지원하는 모든 제공업체와 연결합니다. 지식 기반에 대한 자격 증명 포함은 Knocket 플랫폼에서 관리되며, 여기서는 챗 완성 쪽만 구성하면 됩니다.

• 제공자 — 사전 설정(OpenAI, Hunyuan, DeepSeek 등)을 선택하거나 사용자 정의를 선택하여 직접 엔드포인트를 가져올 수 있습니다.
• API 키 — 선택한 제공자의 비밀번호입니다. 암호화되어 저장되며, 저장 후에는 점으로 표시됩니다.
• API URL — OpenAI 호환 엔드포인트의 기본 URL(예: https://tokenhub.tencentmaas.com/v1)입니다.
• LLM 모델 — 엔드포인트가 예상하는 모델 ID 문자열(예: kimi-k3, deepseek-v4-flash)입니다.

호환성: 이 카드는 OpenAI 챗 완성과 호환되는 API가 필요합니다. 드롭인 OpenAI 클라이언트를 제공하는 모든 공급자가 작동합니다.

이 인수 카드 — 문구 및 알림 채널

핸드오프 카드를 확장하세요 — 설정 페이지의 마지막 카드입니다. 이 카드는 채팅이 AI에서 벗어나는 시점과 누가 알림을 받는지를 결정합니다.

사람에게 연결 문구 — 트리거 문구 사전입니다. 방문자 메시지가 어떤 문구와 일치하면 채팅이 사람에게 라우팅됩니다. 이전 AI는 결정적이고 즉각적이며 모델 호출 없이도 실행됩니다. Knocket은 47개 언어에 걸쳐 기본 라이브러리를 제공합니다 (상담원 연결, 사람, 인간 상담원, …); 클릭 추가 예: 도메인 특화 트리거를 추가하려면 청구 문의하기 또는 상향 처리. 전체 라이브러리 보기: 기본 핸드오프 문구(47개 언어) →

알림 채널 — 핸드오프 자체가 전달되는 곳:

• 브라우저 푸시 — 채팅이 전달될 때마다 콘솔 탭에 알림이 표시됩니다. 기본 알림 설정에서 브라우저 권한을 구성할 수 있으며, 알림으로 이동 단축키를 통해 해당 설정으로 이동할 수 있습니다.
• 텔레그램 — 연결된 텔레그램 봇에 핸드오프 요약을 보냅니다. 텔레그램 봇이 통합 및 알림에서 설정되면 이 기능을 켜주세요.

인계 알림은 일반 메시지 도착 알림과 별개입니다 — 메시지 알림을 끄고 인계 알림만 받을 수 있으며, 이는 대부분의 1인 창업자들이 선택하는 저소음 설정입니다.

지식 — FAQ, URL, 파일 탭

사이드바에서 AI 에이전트 → 지식을 클릭하세요. 이 페이지가 환각(hallucination)을 방지합니다. 추가하는 모든 출처는 청크로 나뉘어 임베딩되고, 응답 시 검색됩니다 — 에이전트는 시스템 프롬프트의 규칙에 따라 찾은 내용만 인용합니다. 세 가지 출처 유형이 각각 자체 탭에 있으며, 공통적으로 10개 항목 제한이 있습니다.

이 자주 묻는 질문 탭 — 수작업으로 선별된 Q&A 쌍

에이전트가 다른 어떤 것보다 선호해야 할 질문/답변 쌍을 추가합니다. 가격, 환불 정책, 플랜 차이 등 — 공식 답변을 원하는 모든 항목에 적합합니다. 임베딩이 완료되면(보통 몇 초 내) 각 행에 색인화됨 배지가 표시됩니다.

이 URL 탭 — 페이지 크롤링

공개 URL을 붙여넣으면 Knocket이 해당 페이지를 크롤링하여 깔끔한 텍스트를 추출하고 인덱싱합니다. 마케팅 사이트, 문서 페이지, 변경 로그, 기능 상세 페이지에 적합합니다. 마지막 동기화 열에서 각 URL이 마지막으로 갱신된 시간을 확인할 수 있으며, 행을 삭제하면 다시 크롤링하도록 강제할 수 있습니다.

이 파일 탭 — 문서 업로드

드래그 앤 드롭 또는 클릭하여 업로드하세요. 지원 형식: PDF, TXT, DOC, DOCX, HTML, MD, CSV, XLSX. 파일당 최대 크기는 10MB입니다. 행에 색인됨이 표시되면 에이전트가 해당 내용을 인용할 수 있습니다.

사용법 — 요청, 토큰, 채널

사이드바에서 AI 에이전트 → 사용량을 클릭하세요. 이 페이지는 에이전트의 운영 상태 보고서입니다. 상단의 기간 선택기(오늘 / 어제 / 지난 7일 / 지난 14일 / 사용자 지정 시작–종료).

상위 세 가지 주요 KPI:

• AI 요청 — 에이전트가 실제로 응답한 방문자 메시지 수 범위입니다.
• 인계 — 인간에게 전달된 채팅 수(구문 트리거 또는 모델 결정).
• 평균 응답 시간 — 메시지 도착부터 답변 전송까지의 중앙값 벽시계 시간(초 단위).

KPI 아래:

• AI 요청 차트 — 에이전트가 답변한 메시지의 일일 막대 그래프. 양이 급증하는 날과 활동이 없는 날을 파악할 수 있습니다.
• 모델 사용량 표 — 공급자 및 모델별로 그룹화된 토큰 소비량. 입력 토큰 / 출력 토큰 열은 어떤 모델이 작업을 하고 있는지, 그리고 대략적으로 비용이 얼마인지를 알려줍니다.
• 채널 분포 표 — AI 요청 / 인계 / 평균 응답 / 비율, 채널(web_widget, mobile_widget, contact_page)별로 분류. 에이전트에게 과부하가 걸리는 채널을 파악하는 데 유용합니다.

자주 묻는 질문

AI 에이전트는 무료로 사용할 수 있나요?

예 — AI 에이전트 자체는 무료 플랜에 포함되어 제공됩니다. 귀하는 자체 LLM 자격 증명(OpenAI와 호환되는 모든 공급자)을 제공하므로, 유일한 가변 비용은 선택한 모델에 사용하는 토큰입니다. 지식 베이스의 임베딩은 플랫폼에서 관리하며 포함되어 있습니다.

어떤 LLM 제공업체를 연결할 수 있나요?

OpenAI 챗 완성 프로토콜을 지원하는 모든 것. 공급자 드롭다운은 일반적인 것들에 대한 사전 설정을 제공합니다; 사용자 정의는 모든 기본 URL + 키 + 모델 ID를 사용할 수 있습니다.

몇 개의 지식 소스를 추가할 수 있나요?

탭당 최대 10개 항목 — 10개의 FAQ, 10개의 URL, 10개의 파일. 파일은 각각 최대 10MB까지 가능합니다. 이 제한은 일반적으로 소규모 SaaS에 충분하며, 제한에 도달한 경우 저희에게 문의하세요.

에이전트가 어떤 언어로 답변하나요?

방문자가 어떤 언어로 작성하든 — 기본 모델이 이를 처리합니다. 내장된 인계 구문 라이브러리가 포함되어 있습니다. 기본 제공 47개 언어.

특정 채널에 대해 상담원을 끌 수 있나요?

예 — 설정 → AI 에이전트 → AI 에이전트 채널에서 해당 채널의 체크를 해제하세요. 해당 채널에서 온 메시지는 바로 사람이 처리하는 받은 편지함으로 전달됩니다.

Knocket은 제3자 모델 학습을 위해 내 지식 기반을 사용합니까?

아니요. 지식 기반 콘텐츠와 대화 기록은 회신 시 검색 및 본인 계정 내 분석 목적으로만 사용됩니다.