CLOVA Studio

!!! info “Language Support” This provider is only supported in Python.

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.

Installation

CLOVA Studio integration is available as a separate community package:

pip install strands-agents strands-clova

Usage

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)

Configuration

Environment Variables

export CLOVA_API_KEY="your-api-key"
export CLOVA_REQUEST_ID="optional-request-id"  # For request tracking

Model Configuration

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"]`	`[]`

Advanced Features

Korean Language Optimization

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("제품 반품 절차를 알려주세요")

Bilingual Capabilities

Handle both Korean and English seamlessly:

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