카카오 챗봇 구축 쉽게 따라하기 - 3단계

이전단계 다시보기 : https://yeolco.tistory.com/228

 

🧠 카카오 챗봇 튜토리얼 3: 엔티티(Entity) 마스터 가이드

엔티티는 사용자의 발화에서 챗봇이 이해해야 할 핵심 단어(명사)를 정의하는 사전과 같습니다. 예를 들어 "삼성전자 주가 알려줘"라는 문장에서 '삼성전자'라는 데이터만 쏙 뽑아내어 서버로 전달하는 역할을 합니다.

Step 1. 엔티티(Entity)의 개념 이해

엔티티는 크게 두 가지 종류로 나뉩니다.

• 시스템 엔티티 (System Entity): 카카오에서 미리 정의해둔 사전입니다. 날짜(@sys.date), 시간(@sys.time), 장소(@sys.location), 숫자(@sys.number) 등 범용적인 데이터를 자동으로 인식합니다.
• 나의 엔티티 (User Entity): 개발자가 서비스 특성에 맞춰 직접 만드는 사전입니다. 예를 들어 주식 종목명, 메뉴 이름, PDF 문서 종류 등이 해당합니다.

---

Step 2. 나의 엔티티(User Entity) 생성 및 등록

개발자님의 프로젝트에 필요한 전용 단어장을 만드는 과정입니다.

1. 메뉴 이동: 왼쪽 사이드바에서 [엔티티] 메뉴를 클릭합니다.
2. 엔티티 생성: [생성] 버튼을 누르고 이름을 지정합니다. (예: @주식종목)
3. 데이터 입력 (Entry): 해당 엔티티에 속할 대표 단어들을 입력합니다.
   • 대표어: 삼성전자
   • 동의어: 삼전, Samsung, 삼성
   • Tip: 동의어를 풍부하게 등록할수록 사용자가 어떤 식으로 말해도 챗봇이 '삼성전자'라는 데이터로 정확히 이해하게 됩니다.

---

Step 3. 시나리오 블록에 엔티티 적용하기 (슬롯 필링)

이제 사용자의 발화에서 엔티티를 추출하도록 설정해야 합니다.

1. 발화 등록: 시나리오 블록에서 "삼성전자 주가 알려줘"라고 입력합니다.
2. 태깅(Tagging): 입력한 문장에서 '삼성전자' 부분을 마우스로 드래그하면 팝업이 뜹니다. 여기서 미리 만든 @주식종목 엔티티를 선택합니다.
3. 파라미터 설정: 태깅을 완료하면 하단에 파라미터가 자동으로 생성됩니다. 이 파라미터 이름(예: stock_name)이 나중에 스킬 서버로 전달되는 변수명이 됩니다.

---

Step 4. 되묻기 설정 (Slot Filling)

사용자가 필수 정보를 빼먹고 말했을 때, 봇이 스스로 질문을 던져 정보를 채우는 고급 기능입니다.

• 상황: 사용자가 그냥 "주가 알려줘"라고만 말한 경우.
• 설정: 파라미터 설정에서 [필수 여부]를 체크합니다.
• 되묻기 질문: "어떤 종목의 주가가 궁금하신가요?"라는 문구를 등록합니다.
• 결과: 사용자가 종목명을 말할 때까지 봇이 반복해서 질문을 던지고, 정보가 채워지면 그때서야 스킬 서버를 호출합니다.

---

Step 5. 스킬 서버에서 엔티티 활용하기 (Java/Spring 연동)

추출된 데이터는 서버로 전달되는 JSON 데이터의 특정 위치에 담깁니다.

1. JSON 구조: 서버로 전송되는 데이터 중 action -> params 객체 안에 사용자가 입력한 엔티티 값이 담겨 있습니다.
2. JSON

    

   "action": {
     "params": {
       "stock_name": "삼성전자"
     }
   }
   

3. 서버 로직: Java 컨트롤러에서 이 stock_name 값을 읽어와 DB 조회나 외부 API 연동에 사용합니다.

---

🧪 Step 6. 테스트 및 검증

1. 봇 테스트: 우측 상단 테스트 창에서 "삼전 시세"라고 입력해 봅니다.
2. 결과 확인: 봇이 '삼전'을 '삼성전자'로 치환하여 인식하고, 서버에 정상적으로 데이터를 보내는지 확인합니다.
3. 배포: 모든 데이터 추출이 완벽하다면 최종적으로 [배포]를 진행합니다.