스킬 트레이너 문제

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

스킬 트레이너를 사용하면서 발생할 수 있는 문제와 해결 방법에 대해 설명합니다.

스킬셋 답변 형식 문제

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

원인

스킬과 유저 쿼리의 복잡도에 따라 설정한 답변 형식이 최종 답변에 제대로 적용되지 않을 수 있습니다.

해결 방법

데이터 수집 화면에서 최종 답변을 직접 수정한 뒤 학습을 수행해 보십시오.
예를 들어, 스킬셋의 답변 형식을 '포맷: JSON 형식'이라고 설정했지만 실제로 모델이 생성한 '최종 답변 A' 형태인 경우, '최종 답변 B' 형태로 수정하여 저장해 주십시오. 이런 유형의 데이터를 여러 건 수집한 뒤 학습을 진행하면 개선된 답변을 받을 수 있습니다.

• 최종 답변 A

  2025년 8월 9일 기준 모자 쇼핑 구매 전환 이용자 수는 다음과 같습니다. 페이지 뷰 수는 1,003,120, 이용자 수는 1,222,334입니다.
  

• 최종 답변 B

  {
     "20250809":{
        "purchase":[
           {
              "pv":"1,003,120",
              "user":"1,222,334"
           }
        ]
     }
  }
  

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

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

원인

API Spec을 상세하게 작성하지 않은 경우, 의도에 맞지 않는 결과가 생성될 수 있습니다.

해결 방법

API Spec에서 파라미터의 'description'에 예시를 추가해 주십시오. 예시가 있으면 언어 모델이 API Spec을 기반으로 유저 쿼리를 이해하여 올바른 파라미터를 갖춘 URL을 생성할 수 있습니다.
<작성 예시>

{
    "keyword": {
        "type": "string",
        "description": "수식어를 의미하며, 관형어와 부사어의 형태입니다. <예시> 친절한, 만족스러운, 좋은",
    },
    "review": {
        "type": "string",
        "description": "긍부정 선호도. <예시> pos, neg 둘 중 하나의 값"
    }
}

"플래닝 가능한 스킬이 없습니다" 오류 메시지

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

원인

스킬이 저장되지 않은 경우 발생할 수 있습니다.
모델이 스킬의 API Spec 또는 Manifest를 제대로 이해하지 못한 경우 발생할 수 있습니다.

해결 방법

• 스킬이 '완료' 상태로 저장되었는지 확인해 줏비시오.
• API Spec 및 Manifest 작성 가이드에 따라 모델이 충분히 이해할 수 있도록 다시 작성해 주십시오. 문제가 계속 발생할 경우, 포럼 문의해 주십시오.

"토큰 수 초과" 오류 메시지

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

원인

데이터 수집 시 단계별로 최대 토큰 수가 8,192으로 제한되어 있습니다.

해결 방법

각 단계별로 합산되는 값은 다음을 참고해 주십시오. 토큰 수를 계산하려면 CLOVA Studio의 익스플로러 > 토큰 계산기(HCX)를 이용해 주십시오.

• 쿼리 분석: 시스템 프롬프트, 유저 쿼리, Manifest, 쿼리 분석 결과
• 스킬 호출
  • Step 2(API 조회 결과 확인): 시스템 프롬프트, 호출 방안, 호출 스킬, API 조회 내용, API 조회 결과, 액션, 액션입력
  • Step 3(호출 결과 정리): 시스템 프롬프트, 호출 방안, 호출 스킬, API 조회 내용, API 조회 결과, 액션, 액션입력, 호출 결과, 생각, 결과 정리
• 최종 답변: 시스템 프롬프트, 결과 정리, 최종 답변

호출 옵션 초기화

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

원인

호출 옵션을 적용하여 데이터 수집을 진행한 후, 다음 데이터 수집을 위해 [초기화] 버튼을 클릭하더라도 호출 옵션은 그대로 유지됩니다. 단, 데이터 수집 화면에서 벗어난 후에 데이터 수집 화면에 다시 접속한 경우에는 호출 옵션이 초기화됩니다.

해결 방법

데이터 수집 화면에 다시 접속하여 호출 옵션이 초기화된 경우에는 불러오기 기능으로 임시 저장한 작업을 불러와 주십시오. 이전에 사용한 호출 옵션도 함께 불러올 수 있습니다.

"데이터 수집 로그" 오류

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

해결 방법

작업 중 오류가 발생하면 다음 정보와 함께 고객 지원에 문의해 주십시오.

• 오류가 발생한 화면 이미지
• 스킬셋
• 스킬 정보

데이터 수집을 실행했으나 작업이 진행되지 않음

API Spec이랑 manifest 모두 작성한 후에 유저 쿼리 입력한 후 실행했으나 작업이 진행되지 않습니다.

원인

• API Spec 명세에 문제가 있습니다.
• API Spec에 파라미터를 넣는 방식이 잘못되었습니다.

해결 방법

API Spec 작성과 스킬 트레이너 활용 예제를 참조하여 API Spec 명세 및 파라미터를 점검해 주십시오.

스킬 트레이너 이용 시 API 응답 시간 지연

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

원인

스킬 트레이너는 연동 API에 따라 해당 API 처리 속도의 영향을 받습니다. 스킬 엔진 속도와 별개로, 실제 호출되는 API가 복잡하다거나 사용자 요청에 따라 한번에 여러 스킬(API)호출이 필요하면 응답 속도가 느려질 수 있습니다.

해결 방법

• 실제 호출되는 API가 너무 복잡하게 구성되어 있지 않은지 점검해 주십시오.
• 한 번에 여러 스킬(API)호출되지 않도록 수정해 주십시오.
• 지연이 발생하는 구간을 확인한 후 고객 지원에 전달해 주십시오.