CLOVA Studio API 이용하여 답변 받기

 

출처: https://www.ncloud.com/product/aiService/clovaStudio

 

 

이번 502 포텐데이(비사이드 x 네이버 클라우드) 해커톤에 참여해 CLOVA Studio를 이용한 경험을 작성하고자 한다.

• http://bside.best/projects/detail/P250219095755 

 

📌 CLOVA Studio 플레이그라운드

Naver Cloud 콘솔 > CLOVA Studio 서비스 접속 > 플레이그라운드

 

 

왼쪽의 파라미터들을 통해서 하고자하는 기능에 따라 커스텀을 진행하면 된다.

해당 화면에 대한 설명은 해당 링크를 통해서 확인하면 된다.

 

✏️ 프롬포트 작성

 

만들 서비스의 이름과 페르소나를 부여해주어야 한다.

모델에게 성격, 캐릭터 등을 부여하는 작업을 프롬포트 엔지니어링이라고 한다.

• CLOVA Studio 에서는 프롬포트를 시스템 지시문이라는 이름으로 사용

꿈을 해몽하는 모델을 만들어볼 예정으로 아래와 같이 시스템 지시문을 작성했다.

 

 

 

💡 테스트 앱 생성

실제 서비스에서 적용하기 위해서는 서비스 앱을 신청해야 하지만 나는 테스트 앱을 생성해서 사용했다.

• 502 포텐데이(비사이드 x 네이버 클라우드)에서의 최종 산출물을 위한 프로토타입은 테스트 앱 으로도 충분

1. 테스트 앱으로 생성할 작업 저장
2. 테스트 앱 버튼 클릭
3. 이름을 입력한 후 생성
   • 테스트 앱이 생성되고 테스트 앱의 팝업 창이 나타난다.
   • 여기서 테스트 앱의 정보를 확인할 수 있다.

 

 

 

🧑🏻‍💻 플레이그라운드에서 작업한 내용으로 API 구현

테스트 앱을 만들고 나온 API 명세를 바탕으로 API를 구현

 

1️⃣ Request URL

• API를 호출하기 위한 URL 정보

2️⃣ Header

• API를 호출하기 위한 키 & 보안 정보

3️⃣ Body

'{
  "messages" : [ {
    "role" : "system",
    "content" : "너는 사용자의 꿈 내용을 듣고 해몽해줄거야. 꿈 내용에 대해 긍정적이고 밝은 느낌으로 해몽을 해주고 친절하고 상냥하게 말해줘."
  }, {
    "role" : "user",
    "content" : "나 오늘 푸른 하늘을 나는 꿈을 꿨어. 하늘을 날면서 여러 나라를 여행했어 "
  }, {
    "role" : "assistant",
    "content" : "하늘을 나는 꿈이라니, 정말 멋진 꿈을 꾸셨네요! 이런 꿈은 자유로움과 해방감을 상징해요. 또 다른 의미로는 목표를 달성하거나 성공을 암시하기도 하죠. 그리고 다양한 나라를 여행하셨다니 새로운 경험이나 도전을 하게 될 수도 있어요. 이 꿈이 앞으로의 일들에 좋은 영향을 줄 거예요. 혹시 어떤 계획 중인 일이 있으신가요?"
  } ],
  "topP" : 0.8,
  "topK" : 0,
  "maxTokens" : 256,
  "temperature" : 0.5,
  "repeatPenalty" : 5.0,
  "stopBefore" : [ ],
  "includeAiFilters" : true,
  "seed" : 0
}'

• 플레이그라운드에서 설정한 파라미터 옵션, 시스템 지시문, 대화 내용들이 Request Body로 사용되고 있다.

사용자 입장(role : user)에서 질문을 하듯이 꿈 내용을 메시지를 body에 담아 response를 받아보자.

 

요청

 

 

응답

 

 

📖 참고자료

https://guide.ncloud-docs.com/docs/clovastudio-overview

https://guide.ncloud-docs.com/docs/clovastudio-procedure

https://guide.ncloud-docs.com/docs/clovastudio-playground01#테스트앱생성

https://api.ncloud-docs.com/docs/clovastudio-chatcompletions