강의 계획 레슨 250개 중 115번째 · 진짜 LLM 호출하기
진짜 LLM 호출하기

Messages 페이로드 만들기

채팅 모델에 대한 모든 호출은 JSON 본문을 실은 HTTP 요청일 뿐이고, 그 본문을 제대로 만드는 게 실제 코드가 하는 첫 일이에요. 이 모듈 내내 Anthropic API가 받고 돌려주는 바로 그 dict와 리스트를 평범한 Python으로 직접 만들어요 -> 그래서 전체가 오프라인으로 돌고 채점될 수 있어요. 각 레슨은 내 컴퓨터에서 API 키로 실행할 진짜 한 줄도 보여 줘요. 여기서 만드는 모양이 바로 네트워크로 오가는 모양이에요.

SDK가 설치되어 있으면 메시지를 보내는 건 이렇게 생겼어요(보여 주기만 해요 -> 여기서는 네트워크를 부르지 않아요):

import anthropic
client = anthropic.Anthropic()   # reads ANTHROPIC_API_KEY from the environment
resp = client.messages.create(
    model="claude-opus-5-5",
    max_tokens=1024,
    system="You are a terse assistant.",
    messages=[{"role": "user", "content": "Hello"}],
)

모양에 주목하세요: system은 자기만의 최상위 필드이고(메시지가 아니에요), messages는 차례들의 리스트로, 각각 role과 content가 있는 dict예요. messages 안에서 올바른 역할은 대화처럼 번갈아 오는 "user"와 "assistant"뿐이에요. 흔한 버그는 다른 API들처럼 지시를 messages 맨 앞의 {"role": "system", ...} 차례에 넣는 거예요. Anthropic API는 첫 메시지로 오는 system 차례를 거부해요: 시스템 프롬프트에는 자기만의 최상위 자리가 있어요. (최근 Claude 모델은 중간에 도착하는 지시를 위해 대화 뒷부분의 system 메시지를 받아 주지만, 그건 고급 기능이에요. 이 강좌는 늘 최상위 자리를 쓰니, 내 build_request는 어떤 system 차례든 거부해요.)

build_request(system, messages, model="claude-opus-5-5", max_tokens=1024)를 만들어요. 요청 dict를 돌려줘요:

{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}
  • model과 max_tokens는 그대로 옮기고, system은 자기 키에 두세요.
  • messages의 각 차례에 대해 역할이 정확히 "user"나 "assistant"인지 확인하세요. 그 밖의 것("system" 차례, "User" 같은 오타, 빠진 역할)은 ValueError를 일으켜야 해요 -> API에 닿아 왕복을 낭비하기 전에 시끄럽게 실패하세요.
  • messages의 차례는 바꾸지 말고 돌려주세요(같은 순서, 같은 내용).

방금 만든 dict로 할 진짜 호출은 이거예요. **는 dict를 키워드 인자로 풀어 줘요:

resp = client.messages.create(**build_request("Be brief.", history))

서로 다른 두 (system, messages) 쌍이 서로 다른 두 요청 dict를 만들고, user나 assistant가 아닌 역할의 차례는 오류를 일으키도록 만드세요.

내 차례

Anthropic 모양의 요청 dict {"model", "max_tokens", "system", "messages"}를 돌려주는 build_request(system, messages, model="claude-opus-5-5", max_tokens=1024)를 쓰세요. messages는 {"role", "content"} 차례들의 리스트예요. 모든 역할이 정확히 "user"나 "assistant"인지 확인하고, 그 밖의 것(몰래 들어온 "system" 차례 포함)에는 ValueError를 일으키세요. 차례는 바꾸지 말고 돌려주세요.

이 레슨에서 문제를 발견했나요? 알려 주세요 · 이 레슨에 대해 묻기

이 연습은 곧 열려요

앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.