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를 일으키세요. 차례는 바꾸지 말고 돌려주세요.
이 연습은 곧 열려요
앞의 레슨을 마치면 이 레슨이 열려요. 강좌 전체가 무료이고 계정도 필요 없으며, 이 레슨은 지금 바로 읽을 수 있어요.
이 브라우저가 learn.floati.life의 쿠키를 막고 있어서, 여기서 마친 레슨들이 순서대로 열리지 않아요. 이 사이트의 쿠키를 허용하고 새로고침하세요.