엔티티

Classic/VPC 환경에서 이용 가능합니다.

엔티티는 인명, 기관명, 장소, 날짜와 상품명 등의 단어들이 등록된 사전을 의미합니다. 챗봇은 사용자 발화 속에서 분석한 엔티티를 통해 의도를 파악하고 슬롯을 추출하는데 활용합니다. 같은 의미인 단어를 엔티티로 정의해 두면, 사용자의 발화를 파악하는데 도움이 됩니다. 엔티티를 생성, 수정, 삭제한 후에는 빌드하거나 변경된 설정 적용을 완료해야 챗봇 서비스에 반영됩니다.

엔티티의 종류

• 도메인 엔티티: 특정 도메인에서만 자주 사용하는 엔티티. 사전 기반의 사전형 엔티티와 정규식 패턴 기반의 패턴형 엔티티로 나뉨
• 시스템 엔티티: 모든 도메인에서 공통으로 사용 가능한 엔티티. 빌트인으로 제공됨
• API 엔티티: 챗봇 빌더 내부에 직접 엔티티를 정의하지 않고 외부 DB에 저장된 엔티티 데이터를 활용하는 엔티티

도메인 엔티티 생성

도메인 엔티티는 해당 도메인에서 사용될 것으로 예상되는 주요 단어들의 모음입니다. 예를 들어 커피 주문과 관련된 챗봇을 생성한다고 가정했을 때, 커피 주문에 필요한 커피 종류, 커피 사이즈 등을 도메인 엔티티에 등록하여 활용할 수 있습니다.
도메인 엔티티를 등록하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼의 콘솔에서 Services > CLOVA Chatbot > Domain 메뉴를 차례대로 클릭해 주십시오.
2. 원하는 도메인의 [빌더 실행하기] 버튼을 클릭하여 챗봇 빌더를 실행해 주십시오.
3. 챗봇 빌더에서 엔티티 > [도메인 엔티티] 탭을 클릭해 주십시오.
4. [엔티티 생성] 버튼을 클릭해 주십시오.

5. 엔티티 정보 입력이 완료되면 [저장] 버튼을 클릭해 주십시오.

<예시> 패턴형 엔티티

<예시> 사전형 엔티티

시스템 엔티티 생성

시스템 엔티티는 모든 도메인에서 공통으로 사용 가능한 엔티티입니다. 네이버 클라우드 플랫폼에서 관리하며, 챗봇 제작자는 등록된 시스템 엔티티 중 사용할 시스템 엔티티만 활성화합니다.

API 연동형 엔티티 생성

API 연동형 엔티티는 다음과 같은 경우에만 사용합니다.

• 태스크의 슬롯으로 사용하는 경우
• 답변 조건에서 엔티티 조건을 체크할 경우
• 액션 메소드v1을 호출할 경우

API 연동형 엔티티를 사용하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼의 콘솔에서 Services > CLOVA Chatbot > Domain 메뉴를 차례대로 클릭해 주십시오.
2. 원하는 도메인의 [빌더 실행하기] 버튼을 클릭하여 챗봇 빌더를 실행해 주십시오.
3. 챗봇 빌더에서 엔티티 > [API 엔티티] 탭을 클릭해 주십시오.
4. URL 영역의 [수정] 버튼을 클릭해 주십시오.
5. URL 필드에 엔티티를 분석할 수 있는 API의 주소를 입력하고 [저장] 버튼을 클릭해 주십시오.
   • 챗봇은 입력된 URL을 통해 형태소를 분석한 결과를 포함하여 호출함
6. [엔티티 생성] 버튼을 클릭해 주십시오.
7. 엔티티 생성 창이 나타나면 엔티티 이름을 입력하고 [중복확인] 버튼을 클릭하고 [저장] 버튼을 클릭해 주십시오.
8. 생성된 엔티티를 확인해 주십시오.

요청 형식

{
  "query": "한국살아",
  "nlpResult": {
    "data": [
      {
        "words": [
          {
            "in": [
              {
                "morph": "한국",
                "tag": "NOUN",
                "ner": "Ner=B-한국 엔티티 이름",
                "lemma": null,
                "start": 0,
                "end": 5,
                "feature": 0,
                "additionals": ""
              },
              {
                "morph": "살아",
                "tag": "NORMALVERB",
                "ner": "Ner=O",
                "lemma": "살다",
                "start": 6,
                "end": 11,
                "feature": 0,
                "additionals": "아"
              }
            ],
            "word": "한국살아"
          }
        ]
      }
    ],
    "success": true
  }
}

응답 형식

{
  "code": "OK",
  "message": "Option[String]",
  "entity": [
    {
      "name": "국가",
      "userInput": "한국",
      "represent": "Korea"
    }
  ]
}

수동으로 엔티티 태깅

사전형 엔티티는 대화의 일반 질문에 태깅할 수 있습니다. 엔티티를 등록한 후 모델 빌드가 완료되면 일반 질문 등록 시 엔티티에 해당하는 단어가 자동으로 태깅되며, 태깅된 엔티티는 대화의 질문 목록에서 파란색 글자로 표현됩니다. 엔티티가 태깅된 질문은 대화 모델 학습에 반영되어 사용자의 발화를 인식하는데 도움을 줍니다.
대화 모델 빌드 전이거나 엔티티가 자동으로 태깅되지 않은 경우에는 챗봇 제작자가 엔티티를 수동으로 태깅할 수 있습니다.
수동으로 엔티티를 태깅하는 방법은 다음과 같습니다.

1. 사전 작업을 완료해 주십시오.
   • ‘피자종류’ 엔티티 추가, 대표어: 포테이토 피자
     
2. 질문을 등록한 후, 엔티티로 태깅할 단어를 드래그해 주십시오.
   • 이 시나리오에서는 ‘포테이토 피자’를 드래그합니다.
     
3. 엔티티 선택 창이 나타나면 태깅하고자 하는 엔티티를 선택하고 [적용] 버튼을 클릭해 주십시오.
   • 새로운 대표어로 추가하거나, 이미 등록된 대표어의 유의어로 추가할 수 있습니다.
   • 만약 엔티티가 없는 경우 [엔티티 생성] 버튼을 클릭하여 신규 생성합니다.
     
4. 엔티티 태깅이 완료되었는지 확인해 주십시오.