Kakao i Agent::Service Agent 등록

페이지 이동경로

Service Agent

실제 사용자는 다양한 디바이스 또는 애플리케이션을 통해 카카오 i 플랫폼의 AI 음성 서비스를 연동하고 사용할 수 있습니다. 다양한 디바이스 또는 애플리케이션에는 카카오 계정을 통해 AI 음성 서비스를 수행할 수 있는 Service Agent가 탑재되어 있어야 하며, Service Agent는 여러 사용자(클라이언트)가 이용하고 있는 디바이스 및 애플리케이션을 구별할 수 있어야 합니다.

AI Service Agent의 대화형 서비스인 헤이카카오(Hey Kakao)를 고객사의 디바이스 또는 애플리케이션에서 사용하기 위해서는 사전에 카카오 i 플랫폼에 Service Agent를 등록하고, 각 디바이스 및 애플리케이션의 식별자인 AI Instance ID(이하 AIID)를 발급받아야 합니다.

Service Agent 등록

Service Agent 등록 프로세스 그림Service Agent 등록 프로세스

  1. 고객사의 애플리케이션을 Kakao Developers 사이트에 등록하기 위해 먼저 계정을 생성합니다.

  2. Kakao Developers에 고객사의 애플리케이션을 등록하고, 해당 애플리케이션과 클라이언트의 정보를 획득합니다.

    애플리케이션 및 클라이언트 정보
    구분 항목 설명
    애플리케이션 정보 App Key 애플리케이션의 정보를 담고 있는 고유 Key 값
    App ID 등록한 애플리케이션의 고유 ID 값
    클라이언트 정보 Client ID 클라이언트의 고유 ID 값
    - 토큰 재발급을 위해 필요
    Client Secret 토큰을 재발급할 때, 보안을 강화하기 위해 사용
  3. 토큰 발급 및 인증 작업을 거쳐 해당 Service Agent 등록과 AI Instance ID(AIID) 발급에 필요한 값들을 획득합니다.

    토큰 관련 정보
    획득 정보 설명
    App User ID 애플리케이션의 사용자 식별 ID 값
    Access Token 사용자가 로그인에 성공했을 때 발급되는 인증 토큰
    - 사용자를 인증하고 카카오 API 호출 권한을 부여
    Refresh Token access_token이 만료되었을 때, 새로운 토큰을 발급받기 위해 사용되는 토큰
    - 한 번 사용된 토큰은 폐기됨
  4. 인증 작업에서 획득한 토큰 관련 정보(access_token, app_user_id)를 사용하여 AIID 발급을 진행합니다.

관련 문서

AI Service Agent Kakao i Agent Service Agent 등록 Kakao i Agent Service Agent Interface Kakao i Agent 구현 시나리오 Kakao i Agent Troubleshooting Kakao i Agent

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

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