---
title: "스킬 트레이너 문제"
slug: "clovastudio-troubleshoot-skill"
updated: 2026-10-26T11:00:03Z
published: 2026-10-26T11:00:03Z
canonical: "guide-gov.ncloud-docs.com/clovastudio-troubleshoot-skill"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://guide-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 스킬 트레이너 문제

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 작성 가이드에 따라 모델이 충분히 이해할 수 있도록 다시 작성해 주십시오. 문제가 계속 발생할 경우, [고객 지원](https://www.gov-ncloud.com/v2/support/question/service)에 전달해 주십시오.

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

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

#### 원인

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

#### 해결 방법

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

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

## 호출 옵션 초기화

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

#### 원인

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

#### 해결 방법

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

## "데이터 수집 로그" 오류

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

#### 해결 방법

작업 중 오류가 발생하면 다음 정보와 함께 [고객 지원](https://www.gov-ncloud.com/v2/support/question/service)에 문의해 주십시오.

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

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

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

#### 원인

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

#### 해결 방법

[API Spec 작성](/docs/clovastudio-skill#APISpec%EC%9E%91%EC%84%B1)과 [스킬 트레이너 활용 예제](/docs/clovastudio-skilltrainer-usecase)를 참조하여 API Spec 명세 및 파라미터를 점검해 주십시오.

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

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

#### 원인

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

#### 해결 방법

- 실제 호출되는 API가 너무 복잡하게 구성되어 있지 않은지 점검해 주십시오.
- 한 번에 여러 스킬(API)이 호출되지 않도록 수정해 주십시오.
- 지연이 발생하는 구간을 확인한 후 [고객 지원](https://www.gov-ncloud.com/v2/support/question/service)에 전달해 주십시오.

              참고

              

이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.