CLOVA Studio 스킬 트레이너로 영화순위 API 연동해서 사용하기

외계공룡 · April 8

안녕하세요 네이버클라우드의 테크엠버서더 주니어마스터 서현석 입니다.

HyperCLOVA X로 부터 “어제 영화 순위 알려줘”, “오늘 날씨 알려줘”와 같은 질문들에 대해서 답변하도록 만들기 위해서는 어떻게 해야 까요?

이와 같은 문제들을 해결하기 위해서 CLOVA Studio에서는 스킬 트레이너라는 기능을 제공하고 있습니다.

스킬 트레이너는 HyperCLOVA X가 학습하지 않은 데이터들에 대해서도 간단하게 외부 API를 연결하여 답변을 만들어내는 기능입니다.

아래는 CLOVA Studio 스킬 트레이너로 영화진흥위원회에서 제공하고 있는 일별 박스오피스 API를 학습시키는 간단한 순서입니다.

스킬셋 생성하기 (스킬셋 이름 예시 : 일상대화 도우미)
스킬 정보 입력하기 (스킬 이름 예시 : 영화순위)
API Spec 작성하기 (영화순위 API Spec 작성)
Manifest 작성하기 (학습 프롬프트 작성)

여기서 중요한 것은 3,4번인데요. 3번 API Spec 작성방법 부터 차근차근 확인해보도록 하겠습니다.

아래는 영화 진흥위원회에서 제공하고 있는 일별 박스오피스 API Spec 명세서 입니다.

이 정보들을 CLOVA Studio에서 모델이 학습할 수 있도록 포멧팅을 해줘야 하는데요.

API Spec은 기본적으로 OpenAPI v3를 기반으로 동작하기 때문에 해당 스펙에 맞게 다음과 같이 등록해 주시면 됩니다.

{
  "openapi": "3.0.0",
  "info": {
    "title": "영화 순위",
    "version": "1.0.0"
  },
  "servers": [
    {
      "url": "http://www.kobis.or.kr/kobisopenapi/webservice/rest/boxoffice"
    }
  ],
  "paths": {
    "/searchDailyBoxOfficeList.json": {
      "get": {
        "description": "일별 영화 순위 목록을 조회하는 API 입니다.",
        "operationId": "searchDailyBoxOfficeList",
        "parameters": [
          {
            "name": "key",
            "in": "query",
            "description": "발급받은 API key 값을 입력합니다.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "targetDt",
            "in": "query",
            "description": "조회하고자 하는 날짜를 yyyymmdd 형식으로 입력합니다.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "response" {
          "...": "...생략..."
        }
      }
    }
  }
}

API Spec을 작성하셨다면 다음으로는 4번 Manifest에서 모델이 API를 학습할 수 있도록 프롬프트를 입력해주시면 됩니다.

Manifest가 스킬 트레이너를 사용하는 데 있어서 가장 중요한 부분이 아닐까 싶은데요.

이 Manifest를 어떻게 작성하느냐에 따라 답변의 품질을 결정지을 수 있게 됩니다.