CLOVA Studio 문제 해결

Classic/VPC 환경에서 이용 가능합니다.

CLOVA Studio를 이용하면서 겪을 수 있는 문제 상황과 해결 방법을 안내합니다. 각 문제 상황을 클릭하면 관련 페이지로 이동합니다.

일반적인 문제

사용자가 겪을 수 있는 일반적인 문제 상황은 다음과 같습니다.

동시 요청 급증 시 오류
다수 사용자가 동시에 API 요청을 보냈을 때 오류가 발생합니다.

오류 코드 반환
API 호출 시 오류 코드가 반환되었습니다.

서비스 앱 수정/삭제 불가
서비스 앱 신청/등록 후 수정하거나 삭제할 수 없습니다.

서비스 앱 신청 시 신청할 작업이 나타나지 않음
서비스 앱 신청 정보에서 신청 모델을 선택했는데 신청할 작업 목록에 아무것도 나타나지 않습니다.

생성·출력 문제

사용자가 겪을 수 있는 생성/출력 관련 문제 상황은 다음과 같습니다.

추론 과정 미노출
HCX-007 모델 사용 시 추론/생각 과정이 보이지 않습니다.

입력한 글자와 토큰 수의 불일치
입력 글자 수는 짧은데 이용한 토큰 수가 크게 나옵니다.

HCX-007로 도구 호출 시 오류
도구 호출 시 HCX-005는 정상적으로 작동하나 HCX-007은 오류가 발생합니다.

특정 정보(전화번호, URL)의 마스킹 처리
전화번호, URL 등 일부 정보가 *로 자동으로 마스킹처리 되어 전달됩니다. 마스킹 처리를 해제하고 싶습니다.

튜닝 문제

사용자가 겪을 수 있는 튜닝 관련 문제 상황은 다음과 같습니다.

결과가 부정확하거나 일관되지 않음
튜닝을 완료했으나 테스트 시 기대한 답변이 정확하지 않습니다.
싱글턴 예제 데이터셋(데이터셋 준비 화면에서 다운로드한 예제 파일)을 활용하여 튜닝을 실행했는데 원하는 결과가 나오지 않았습니다.

"데이터셋에 오류가 있습니다" 오류 메시지
데이터셋 업로드 시 "데이터셋에 오류가 있습니다" 오류 메시지가 표시됩니다.

“데이터셋이 존재하지 않습니다” 오류 메시지
튜닝 시 데이터셋을 첨부했는데도 데이터셋이 없다는 오류 메시지가 표시됩니다.

스킬 트레이너 문제

사용자가 겪을 수 있는 스킬 트레이너 관련 문제 상황은 다음과 같습니다.

스킬셋 답변 형식 문제
스킬셋 답변 형식을 설정했는데, 데이터 수집 시 최종 답변에 제대로 적용되지 않습니다.

액션 입력 생성 결과가 의도한 대로 나오지 않음
액션 입력 생성 결과가 의도한 대로 나오지 않습니다.

"플래닝 가능한 스킬이 없습니다" 오류 메시지
데이터 수집 시 "플래닝 가능한 스킬이 없습니다" 오류 메시지가 표시됩니다.

"토큰 수 초과" 오류 메시지
데이터 수집 시 "토큰 수 초과" 오류 메시지가 나타납니다.

호출 옵션 초기화
데이터 수집할 때마다 호출 옵션이 초기화됩니다.

"데이터 수집 로그" 오류
데이터 수집 작업 중에 오류가 발생했습니다.

데이터 수집을 실행했으나 작업이 진행되지 않음
API Spec이랑 manifest 모두 작성한 후에 유저 쿼리 입력한 후 실행했으나 작업 중 상태에서 진행되지 않습니다.

스킬 트레이너 이용 시 API 응답 시간 지연
스킬 트레이너 이용 시 API 응답 시간이 너무 오래 걸립니다.

둘러볼 콘텐츠

• API 가이드: CLOVA Studio API 가이드
• 오류 코드별 해결 방법: API 가이드의 CLOVA Studio 문제 해결
• CLOVA 테크 블로그 : 테크 블로그
• 네이버 클라우드 플랫폼 블로그: [클로바 스튜디오 Cookbook] 🦜🔗 랭체인으로Advanced RAG 구현하기