Classic/VPC 환경에서 이용 가능합니다.
CLOVA Studio를 이용하면서 겪을 수 있는 문제 상황과 해결 방법을 안내합니다. 각 문제 상황을 클릭하면 관련 페이지로 이동합니다. ## 일반적인 문제 사용자가 겪을 수 있는 일반적인 문제 상황은 다음과 같습니다. [동시 요청 급증 시 오류](/docs/clovastudio-troubleshoot-common#동시요청급증시오류) 다수 사용자가 동시에 API 요청을 보냈을 때 오류가 발생합니다. [오류 코드 반환](/docs/clovastudio-troubleshoot-common#오류코드반환) API 호출 시 오류 코드가 반환되었습니다. [서비스 앱 수정/삭제 불가](/docs/clovastudio-troubleshoot-common#서비스앱수정삭제불가) 서비스 앱 신청/등록 후 수정하거나 삭제할 수 없습니다. [서비스 앱 신청 시 신청할 작업이 나타나지 않음](/docs/clovastudio-troubleshoot-common#서비스앱신청시신청할작업이나타나지않음) 서비스 앱 신청 정보에서 신청 모델을 선택했는데 **신청할 작업** 목록에 아무것도 나타나지 않습니다. ## 생성·출력 문제 사용자가 겪을 수 있는 생성/출력 관련 문제 상황은 다음과 같습니다. [추론 과정 미노출](/docs/clovastudio-troubleshoot-generation#추론과정미노출) HCX-007 모델 사용 시 추론/생각 과정이 보이지 않습니다. [입력한 글자와 토큰 수의 불일치](/docs/clovastudio-troubleshoot-generation#입력한글자와토큰수의불일치) 입력 글자 수는 짧은데 이용한 토큰 수가 크게 나옵니다. [HCX-007로 도구 호출 시 오류](/docs/clovastudio-troubleshoot-generation#HCX007로도구호출시오류) 도구 호출 시 HCX-005는 정상적으로 작동하나 HCX-007은 오류가 발생합니다. [특정 정보(전화번호, URL)의 마스킹 처리](/docs/clovastudio-troubleshoot-generation#특정정보전화번호URL의마스킹처리) 전화번호, URL 등 일부 정보가 *로 자동으로 마스킹처리 되어 전달됩니다. 마스킹 처리를 해제하고 싶습니다. ## 튜닝 문제 사용자가 겪을 수 있는 튜닝 관련 문제 상황은 다음과 같습니다. [결과가 부정확하거나 일관되지 않음](/docs/clovastudio-troubleshoot-tuning#결과가부정확하거나일관되지않음) 튜닝을 완료했으나 테스트 시 기대한 답변이 정확하지 않습니다. 싱글턴 예제 데이터셋(데이터셋 준비 화면에서 다운로드한 예제 파일)을 활용하여 튜닝을 실행했는데 원하는 결과가 나오지 않았습니다. ["데이터셋에 오류가 있습니다" 오류 메시지](/docs/clovastudio-troubleshoot-tuning#데이터셋에오류가있습니다오류메시지) 데이터셋 업로드 시 "데이터셋에 오류가 있습니다" 오류 메시지가 표시됩니다. [“데이터셋이 존재하지 않습니다” 오류 메시지](/docs/clovastudio-troubleshoot-tuning#데이터데이터셋이존재하지않습니다오류메시지) 튜닝 시 데이터셋을 첨부했는데도 데이터셋이 없다는 오류 메시지가 표시됩니다. ## 스킬 트레이너 문제 사용자가 겪을 수 있는 스킬 트레이너 관련 문제 상황은 다음과 같습니다. [스킬셋 답변 형식 문제](/docs/clovastudio-troubleshoot-skill#스킬셋답변형식문제) 스킬셋 답변 형식을 설정했는데, 데이터 수집 시 최종 답변에 제대로 적용되지 않습니다. [액션 입력 생성 결과가 의도한 대로 나오지 않음](/docs/clovastudio-troubleshoot-skill#액션입력생성결과가의도한대로나오지않음) 액션 입력 생성 결과가 의도한 대로 나오지 않습니다. ["플래닝 가능한 스킬이 없습니다" 오류 메시지](/docs/clovastudio-troubleshoot-skill#플래닝가능한스킬이없습니다오류메시지) 데이터 수집 시 "플래닝 가능한 스킬이 없습니다" 오류 메시지가 표시됩니다. ["토큰 수 초과" 오류 메시지](/docs/clovastudio-troubleshoot-skill#토큰수초과오류메시지) 데이터 수집 시 "토큰 수 초과" 오류 메시지가 나타납니다. [호출 옵션 초기화](/docs/clovastudio-troubleshoot-skill#호출옵션초기화) 데이터 수집할 때마다 호출 옵션이 초기화됩니다. ["데이터 수집 로그" 오류](/docs/clovastudio-troubleshoot-skill#데이터수집로그오류) 데이터 수집 작업 중에 오류가 발생했습니다. [데이터 수집을 실행했으나 작업이 진행되지 않음](/docs/clovastudio-troubleshoot-skill#데이터수집을실행했으나작업이진행되지않음) API Spec이랑 manifest 모두 작성한 후에 유저 쿼리 입력한 후 실행했으나 작업 중 상태에서 진행되지 않습니다. [스킬 트레이너 이용 시 API 응답 시간 지연](/docs/clovastudio-troubleshoot-skill#스킬트레이너이용시API응답시간지연) 스킬 트레이너 이용 시 API 응답 시간이 너무 오래 걸립니다. ## 둘러볼 콘텐츠 * API 가이드: [CLOVA Studio API 가이드](https://api-gov.ncloud-docs.com/docs/clovastudio-overview){target="_blank"} * 오류 코드별 해결 방법: [API 가이드의 CLOVA Studio 문제 해결](https://api-gov.ncloud-docs.com/docs/clovastudio-troubleshoot){target="_blank"} * CLOVA 테크 블로그 : [테크 블로그](https://clova.ai/tech-blog){target="_blank"} * 네이버 클라우드 플랫폼 블로그: [[클로바 스튜디오 Cookbook] 🦜🔗 랭체인으로Advanced RAG 구현하기](https://blog.naver.com/n_cloudplatform/223979300412){target="_blank"} :::(Info) (참고) 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다. :::