Skip to content

CLOVA Studio

CLOVA Studio is Naver Cloud Platform’s AI service that provides large language models optimized for Korean language processing. The strands-clova package (GitHub) provides a community-maintained integration for the Strands Agents SDK, enabling seamless use of CLOVA Studio’s Korean-optimized AI models.

CLOVA Studio integration is available as a separate community package:

Terminal window
pip install strands-agents strands-clova

After installing strands-clova, you can import and initialize the CLOVA Studio provider:

from strands import Agent
from strands_clova import ClovaModel
model = ClovaModel(
api_key="your-clova-api-key", # or set CLOVA_API_KEY env var
model="HCX-005",
temperature=0.7,
max_tokens=2048
)
agent = Agent(model=model)
response = await agent.invoke_async("안녕하세요! 오늘 날씨가 어떤가요?")
print(response.message)
Terminal window
export CLOVA_API_KEY="your-api-key"
export CLOVA_REQUEST_ID="optional-request-id" # For request tracking

The supported configurations are:

| Parameter | Description | Example | Default | |------------|-------------|---------|---------| | model | Model ID | HCX-005 | HCX-005 | | temperature | Sampling temperature (0.0-1.0) | 0.7 | 0.7 | | max_tokens | Maximum tokens to generate | 4096 | 2048 | | top_p | Nucleus sampling parameter | 0.8 | 0.8 | | top_k | Top-k sampling parameter | 0 | 0 | | repeat_penalty | Repetition penalty | 1.1 | 1.1 | | stop | Stop sequences | ["\\n\\n"] | [] |

CLOVA Studio excels at Korean language tasks:

# Korean customer support bot
model = ClovaModel(api_key="your-api-key", temperature=0.3)
agent = Agent(
model=model,
system_prompt="당신은 친절한 고객 서비스 상담원입니다."
)
response = await agent.invoke_async("제품 반품 절차를 알려주세요")

Handle both Korean and English seamlessly:

# Process Korean document and get English summary
response = await agent.invoke_async(
"다음 한국어 문서를 영어로 요약해주세요: [문서 내용]"
)