API 사용 FAQ

{
  "model": "HCX-GOV-THINK",
  "messages": [...]
}

messages = [
    {"role": "system", "content": "당신은 도움이 되는 AI 어시스턴트입니다."},
    {"role": "user", "content": "Python이 뭐야?"},
    {"role": "assistant", "content": "Python은 프로그래밍 언어입니다."},
    {"role": "user", "content": "그럼 어디에 사용돼?"}  # 이전 맥락 유지
]

response = requests.post(
    url,
    headers=headers,
    json={
        "model": "HCX-GOV-THINK",
        "messages": messages,
        "stream": True  # 스트리밍 활성화
    },
    stream=True
)

for line in response.iter_lines():
    # 실시간으로 처리
    print(line)

messages = [
    {
        "role": "system",
        "content": "당신은 Python 프로그래밍 전문가입니다. "
                  "항상 코드 예제와 함께 설명하세요."
    },
    {
        "role": "user",
        "content": "리스트 컴프리헨션을 설명해주세요."
    }
]

POST /api/v1/teams/{team_id}/agent/{agent_workflow_id}/a2a

{
  "jsonrpc": "2.0",
  "method": "message/send",
  "params": {
    "message": {
      "role": "user",
      "messageId": "msg-123456",
      "parts": [{"text": "사용자 질문"}]
    },
    "metadata": {
      "chat_session_id": 123
    }
  },
  "id": "req-12345"
}

# 타임스탬프 사용
message_id = f"msg-{int(time.time())}"

# UUID 사용
import uuid
message_id = f"msg-{uuid.uuid4()}"

response = requests.post(
    f"{base_url}/tools/pii-mask",
    headers=headers,
    json={
        "text": "제 이메일은 user@example.com입니다.",
        "mask_types": ["email"]
    }
)
# 결과: "제 이메일은 [EMAIL]입니다."

response = requests.post(
    f"{base_url}/tools/embeddings",
    headers=headers,
    json={
        "texts": ["안녕하세요", "Hello"],
        "model": "clova-embedding"
    }
)
# 각 텍스트가 벡터로 변환됨

import time

for attempt in range(max_retries):
    try:
        response = make_request()
        break
    except RateLimitError:
        wait_time = 2 ** attempt
        time.sleep(wait_time)