Construa o Messages Payload
Cada chamada para um modelo de chat é apenas uma requisição HTTP carregando um corpo JSON, e acertar esse corpo é a primeira coisa que o código real faz. Ao longo deste módulo você vai construir manualmente os dicts e listas exatos que a API da Anthropic consome e retorna, usando Python puro -> assim a coisa toda roda offline e pode ser avaliada. Cada lição também mostra a única linha real que você executaria com uma chave de API na sua própria máquina. Os formatos que você constrói aqui SÃO os formatos que passam pelo cabo.
Com o SDK instalado, enviar uma mensagem parece com isso (apenas ilustrativo -> não chamamos a rede aqui):
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"}],
)Note a forma: system é seu próprio campo de nível superior (não é uma mensagem), e messages é uma lista de turnos, cada um um dicionário com um role e content. As únicas roles válidas dentro de messages são "user" e "assistant", alternando como uma conversa. Um bug comum é colocar as instruções em um turno {"role": "system", ...} no início de messages, do jeito que algumas outras APIs fazem. A API da Anthropic recusa um turno de sistema como a primeira mensagem: o system prompt tem seu próprio slot de nível superior. (Modelos recentes do Claude aceitam uma mensagem de sistema mais tarde em uma conversa, para uma instrução que chega no meio, mas isso é um recurso avançado; este curso sempre usa o slot de nível superior, então seu build_request rejeita qualquer turno de sistema.)
Você está construindo build_request(system, messages, model="claude-opus-5-5", max_tokens=1024). Ele retorna o dict da requisição:
{"model": ..., "max_tokens": ..., "system": ..., "messages": [...]}- Copie
-
modelemax_tokensdireto, e coloquesystemem sua própria chave. - Para cada turno em
messages, valide se o papel é exatamente"user"ou"assistant". Qualquer outra coisa (um turno"system", um erro de digitação como"User", um papel ausente) deve gerar umValueError-> falhe alto antes de você chamar a API e desperdiçar uma ida e volta. - Retorne as turnos em
messagesinalterados (mesma ordem, mesmo conteúdo).
Aqui está a chamada real que você faria com o dict que acabou de construir; o ** desempacota o dict em keyword arguments:
resp = client.messages.create(**build_request("Be brief.", history))Construa para que dois pares (system, messages) diferentes produzam dois dicts de request diferentes, e uma turn com um role diferente de user ou assistant gere um erro.
Escreva build_request(system, messages, model="claude-opus-5-5", max_tokens=1024) que retorna o dict de requisição no formato Anthropic {"model", "max_tokens", "system", "messages"}. messages é uma lista de turnos {"role", "content"}. Valide se cada role é exatamente "user" ou "assistant" e lance um ValueError em qualquer outra coisa (incluindo um turno "system" camuflado). Retorne os turnos inalterados.
Viu um problema nesta lição? Reporte-o · Pergunte sobre esta lição
Este exercício abre em breve
Termine a lição anterior para que esta seja desbloqueada. O curso inteiro é gratuito, não precisa de conta, e você pode ler esta lição agora mesmo.
Este navegador está bloqueando cookies para learn.floati.life, então as lições que você terminou aqui não podem abrir em ordem. Permita cookies para este site e recarregue.