Kakao i Agent SDK::Wallpad

페이지 이동경로

Kakao i Agent SDK

Kakao i Agent SDK는 기본적으로 사용자의 음성 명령을 입력받고, 명령어를 분석하여 사용자 요청에 맞는 응답(음성 또는 UI)을 출력하는 기능을 제공합니다. Wallpad 버전의 Kakao i Agent SDK는 Wallpad 용 애플리케이션에서 Kakao i 음성 인식 서비스를 사용할 수 있는 기능을 제공합니다. SDK는 기능별 모듈로 구성되며, Kakao i 음성 인식 서비스에서 제공하는 기능을 처리하기 위한 별도의 메서드를 제공합니다.
또한 애플리케이션 통합(Integration) 이전에 인터랙션을 테스트하기 위한 목적으로 SDK와 함께 Sample App을 함께 제공하고 있습니다. Sample App을 사용하여 신규 Android Studio 프로젝트를 생성하지 않고, Wallpad 샘플 코드에서 일부 항목을 수정하여 별도의 애플리케이션을 구현하는 방법은 부록 A. Sample App 구현 을 참고하시기 바랍니다.

안내
이 문서는 Kakao i Android SDK Version 1.3.2.25(2021. 10월)을 기반으로 작성되었습니다.

SDK 구성 모듈

Kakao i Agent SDK를 구성하는 모듈은 다음과 같습니다.

Kakao i Agent SDK 구성 모듈
구성 모듈 설명
Kakao i Agent 음성 인식의 주요 기능을 포함하는 모듈
- 음성 인식, 인식 상태 전달 등
Kakao i Client Kakao i 서버와 SDK의 연동을 위한 모듈
- 음성 인식 데이터와 음성 인식 상태 정보를 Kakao i 서버와 송신/수신할 때 사용
AppClient 애플리케이션의 통신 관련 설정을 할 수 있는 모듈
Auditorium 음성 입력 관련 모듈
- 사용자의 음성 명령을 녹음하고, 녹음된 결과(오디오 버퍼)를 필요한 곳에 공급
Dialoid(Wake-up) 음성 발화 모듈
- Wake-Up Word(호출명령어)를 설정하고, 인식된 발화 음성에 대한 상태와 정보를 확인
Kapi Adapter Kakao i 음성 인식 서비스 인증 관련 모듈

주의
Kakao i 음성 인식 서비스를 이용하기 위해서는 사전에 헤이카카오(HeyKakao) 서비스에 가입해야 합니다.

  • Kakao i 음성 인식 서비스는 Kakao 서비스와 구분되는 별도의 헤이카카오 서비스입니다.
  • 헤이카카오 서비스는 Kakao 계정을 사용해 가입할 수 있습니다.

인터랙션 시나리오

다음은 사용자가 “오늘 날씨 알려줘"라는 음성 명령을 발화했을 때, 사용자, 고객사 애플리케이션, SDK 간의 인터랙션을 정리한 시나리오입니다.

인터랙션 시나리오 그림인터랙션 시나리오

  1. Wallpad 애플리케이션에서 Kakao i Agent SDK 초기화를 수행합니다.
  2. Kakao i 계정 정보를 인증합니다.
    • Kakao i 계정 인증은 Kakao 계정을 기반으로 진행됩니다.
  3. 사용자가 Wake-up Word(호출명령어)인 “헤이 카카오!”를 발화하면, SDK는 발화 명령어를 인식하고 발화 효과음을 재생하여 사용자에게 명령어를 입력받을 수 있는 상태임을 알립니다.
  4. 사용자가 “오늘 날씨 알려줘"라는 음성 명령을 하면, SDK는 사용자 음성 명령을 인식하고 애플리케이션에 인식 상태를 실시간으로 전달합니다.
    • SDK는 명령어 인식을 완료하면 더 이상 사용자 음성을 입력받지 않고, 해당 음성 명령에 대한 응답을 출력합니다.
  5. 음성 답변과 함께, SDK의 기본 응답 UI 템플릿인 View Template을 통해 응답 UI를 출력합니다.
    • View Template에 대한 자세한 설명은 View Template 수정 문서를 참고하시기 바랍니다.
안내
필요 시 SDK에서 제공하는 기본 응답 UI 템플릿인 View Template을 수정할 수 있습니다.
자세한 설명은 View Template 수정 문서를 참고하시기 바랍니다.

관련 문서

Wallpad Kakao i Agent SDK

이 문서가 만족스러운 이유를 알려주세요.
이 문서에 아쉬운 점을 알려주세요.
평가해주셔서 감사합니다.

더 자세한 의견은 documentation@kakaoenterprise.com 으로 제보해주세요.