Dobre um Fluxo de Tokens
Quando você faz o streaming de uma resposta, o modelo envia a resposta como uma série de pequenos eventos em vez de um payload grande, para que você possa mostrar o texto conforme ele é digitado. O SDK fornece um iterador limpo de pedaços de texto, mas por baixo ele está dobrando um fluxo de eventos digitados: um message_start, depois muitos eventos content_block_delta cada um carregando um pequeno text_delta, com marcadores content_block_stop e message_stop ao redor deles. Para reconstruir a resposta completa você mantém apenas os deltas de texto e os concatena.
A versão real amigável se parece com isso (apenas ilustrativo -> não chamamos a rede):
with client.messages.stream(model="claude-opus-5-5", max_tokens=1024,
messages=[{"role": "user", "content": "Hi"}]) as stream:
for text in stream.text_stream: # already just the text chunks
print(text, end="", flush=True)
final = stream.get_final_message()Esse text_stream é uma conveniência. Sob ele, os eventos brutos parecem a lista abaixo, e dobrá-los é exatamente a habilidade que esta lição treina. Modelamos o fluxo como uma lista de dicionários de eventos para que ele rode offline:
[
{"type": "message_start"},
{"type": "content_block_delta", "delta": {"type": "text_delta", "text": "He"}},
{"type": "content_block_delta", "delta": {"type": "text_delta", "text": "llo"}},
{"type": "content_block_stop"},
{"type": "message_stop"}
]Você está construindo collect_stream(events). Percorra a list e concatene, em ordem, o text de cada evento que é um content_block_delta cujo delta interno tem type == "text_delta". Pule cada outro evento -> os marcadores de ciclo de vida (message_start, content_block_stop, message_stop) não carregam texto, e um delta não textual (como um input_json_delta para uma chamada de ferramenta transmitida) não faz parte da resposta visível. Uma list vazia retorna "".
Construa de forma que duas listas de eventos diferentes reconstruam duas strings diferentes, os eventos de ciclo de vida e não texto são pulados, e um stream vazio retorna "".
Escreva collect_stream(events) onde events é uma lista de dicts de eventos de streaming. Concatene, em ordem, o text de cada evento {"type": "content_block_delta", "delta": {"type": "text_delta", "text": ...}}. Pule todos os outros eventos (marcadores de ciclo de vida como message_start/content_block_stop, e deltas não textuais). Retorne "" para um stream vazio.
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.