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.

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(
    "다음 한국어 문서를 영어로 요약해주세요: [문서 내용]"
)