Documentation Index

Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

멀티미디어 인텐트 연동

Prev Next

사용자가 텍스트가 아닌 멀티미디어를 보낸 경우, 사용자에게 받은 멀티미디어를 외부 분석 API로 전달하여 분석한 후 답변을 응답할 수 있습니다. 현재 이미지 인텐트만 지원하고 있으며 LINE 메신저에서 가장 원활하게 동작합니다.

  • 네이버 클라우드 플랫폼에서 멀티미디어(이미지) 인텐트를 활용하는 CLOVA OCR 서비스를 제공하고 있으며, 멀티미디어 인텐트 연동을 통해 챗봇에 OCR 서비스를 연동하는 기능을 지원합니다.
  • LINE 메신저에서는 기존에 이미지를 처리할 수 있는 스펙과 Push 스펙을 제공하고 있습니다. LINE 메신저와 연동할 경우, 챗봇에서는 멀티미디어를 입력 받아 OCR로 인텐트를 확인한 후, 특정 정보를 챗봇에게 질문으로 다시 던지게 할 수 있습니다. 그러나 LINE 메신저 외의 플랫폼에서 해당 기능을 사용할 경우, 이미지 분석은 가능하나 챗봇의 답변 응답은 지원하지 않습니다. 채널별 특성으로 인해 단방향으로만 멀티미디어 인텐트를 인식하고 연동할 수 있다는 제약이 있습니다.

멀티미디어 인텐트 연동하기

이미지 인텐트를 연동하는 방법은 다음과 같습니다.

  1. 네이버 클라우드 플랫폼 콘솔에서 Menu > Services > AI Services > CLOVA Chatbot > Domain 메뉴를 차례대로 클릭해 주십시오.
  2. 원하는 도메인의 [빌더 실행하기] 버튼을 클릭하여 챗봇 빌더를 실행해 주십시오.
  3. 챗봇 빌더에서 챗봇 설정 > 멀티미디어 인텐트 탭을 클릭해 주십시오.
  4. 이미지 인텐트의 [연동] 버튼을 클릭해 주십시오.
  5. 외부 이미지 분석 솔루션 연동하기를 선택해 주십시오.
    • CLOVA OCR을 사용 중이라면 CLOVA OCR과 연동하기 선택 (단, OCR 템플릿 도메인만 지원)
  6. 이미지를 인증할 수 있는 API URL과 Secret key를 입력해 주십시오.
    • 사용자가 이미지를 전송하면 입력된 API URL에 이미지 전달

이미지 전달 양식: LINE 메신저인 경우

{
  "domainCode": "ai.company.v6",
  "userId": "U77c8fe9743a0af83d4dbd57dc2f39e8a",
  "platform": "line",
  "query": "",
  "multimediaLine": {
    "contentId": 11096934827632,
    "typ": "image"
  }
}
필수 타입 설명
multimediaLine Object N 이미지 등 content id 정보를 넘겨줄 필요가 있을 때 사용
multimediaLine.contentId Long Y 해당 content의 id
multimediaLine.typ String Y 해당 content의 유형 명시. 현재는 image만 가능
multimediaLine Object N 이미지 등 content id 정보를 넘겨줄 필요가 있을 때 사용

이미지 전달 양식: Custom 채널인 경우
Push 기능을 활용하고 있기 때문에, LINE 메신저 외의 플랫폼에서 해당 기능을 사용할 경우 이미지 분석은 가능하나 챗봇 답변 응답은 지원하지 않습니다.

{
  "domainCode": "ai.company.v6",
  "userId": "U77c8fe9743a0af83d4dbd57dc2f39e8a",
  "platform": "custom",
  "query": "",
  "multimedia": {
    "data": "",
    "typ": "",
    "extension": ""
  }
}
필수 타입 설명
multimedia Object N 이미지 등 멀티미디어를 넘겨줄 필요가 있을 때 사용
multimedia.data String Y 해당 멀티미디어의 데이터
해당 데이터는 base64 encoding되어 있어야 함
multimedia.typ String Y 해당 멀티미디어의 종류 표기. 현재는 image만 가능
multimedia.extension String Y 해당 멀티미디어의 파일 확장자 정보. jpeg, png 등 가능

이미지 분석 완료 후 챗봇에게 다시 응답해야 하는 양식
matchedTemplate의 name을 챗봇에게 질문으로 다시 던지게 됩니다.

{
  "matchedTemplate": {
  "name": "분석된 템플릿 이름",
   }
}

멀티미디어 인텐트를 활용한 대화 작성

멀티미디어 인텐트를 활용하려면 대화 질문 등록 시 질문 유형을 ‘정규식 질문’으로 선택하고 질문에 CLOVA OCR의 템플릿 이름을 입력합니다. CLOVA OCR에서 분석한 템플릿명을 챗봇이 질문으로 던지게 됩니다.
외부 이미지 분석 솔루션과 연동된 경우에도 동일한 방법으로 활용할 수 있습니다.
chatbot-chatbot-6-6_01_ko