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 테크 블로그 : 테크 블로그
• 포럼: CLOVA Studio 포럼
• 네이버 클라우드 플랫폼 블로그: [클로바 스튜디오 Cookbook] 🦜🔗 랭체인으로Advanced RAG 구현하기