생성 및 출력 문제

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

CLOVA Studio를 사용하면서 발생할 수 있는 문제와 해결 방법에 대해 설명합니다.

추론 과정 미노출

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

원인

플레이그라운드에서는 추론 내용(생각 과정, thinking/reasoning trace)을 표시하지 않습니다.

해결 방법

HCX-007 모델의 추론 내용(생각 과정, thinking/reasoning trace)은 Chat Completions v3 API 응답에서의 result.message.thinkingContent 필드, 또는 오픈AI 호환 API(/chat/completions) 응답에서의 choices[0].message.thinking_content 필드에서 확인해 주십시오.

입력한 글자와 토큰 수의 불일치

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

원인

토큰 수는 단순한 글자 수가 아니라, 문장의 구성 요소를 언어별 토큰화 기준으로 분리한 '단어 조각(token)' 수로 계산됩니다. 또한, Chat Completions API에서는 system, user, assistant 등 message 전체가 모두 입력 토큰 수에 포함되며, 특히 시스템 프롬프트를 길게 설정한 경우 이용 토큰 수가 많아질 수 있습니다.

해결 방법

요청 구문 전체에 대한 토큰 수를 토큰 계산기를 사용하여 미리 확인해 주십시오.

HCX-007로 도구 호출 시 오류

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

원인

HCX-007은 하이브리드 추론 모델입니다. 추론 기능을 이용할 경우 Function calling 등의 기능을 사용할 수 없습니다. 추론 여부 및 사고 과정 깊이를 설정하는 파라미터인 thinking.effort의 기본값이 'low'이므로 별도로 설정하지 않으면 추론 기능이 사용됩니다.

해결 방법

HCX-007로 Function calling 사용이 필요한 경우, 추론 기능을 활용하지 않도록 추가 파라미터를 정의해야 합니다.

model_hcx007 = ChatClovaX(model="HCX-007", api_key={api_key}, reasoning_effort="none")

자세한 설명은 추론, Function calling을 참조해 주십시오.

특정 정보(전화번호, URL)의 마스킹 처리

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

원인

클로바 스튜디오 약관 제 10조(권리 및 의무 등)의 2항에 따라, 개인정보는 CLOVA Studio 사용 시 입력되어서는 안됩니다.

해결 방법

CLOVA Studio에서는 개인정보 보호를 위해 전화번호, 이메일, URL 등 개인 식별 가능 정보가 자동으로 마스킹 처리됩니다. 해당 기능은 시스템 보안 및 개인정보 보호 정책에 따라 해제할 수 없습니다. 개인 정보가 필요한 테스트나 서비스 검증이 필요한 경우에는 샘플 데이터(예: 010-XXXX-XXXX, test@example.com 등) 또는 비식별 처리된 데이터를 사용해 주십시오.