Streaming con eventos semánticos

Trabajar con la API Responses de OpenAI

James Chapman

AI Curriculum Manager, DataCamp

¿Por qué hacer streaming?

streaming desactivado

¿Por qué hacer streaming?

streaming activado

Eventos semánticos

Actualizaciones estructuradas que describen lo que ocurre

Eventos semánticos

Actualizaciones estructuradas que describen lo que ocurre

Tipo de evento	Descripción
`response.created`	El modelo empezó a generar
`response.output_text.delta`	Actualización parcial de texto
`response.output_text.done`	Bloque de texto completo
`response.function_call.arguments.delta`	Streaming de argumentos de tool
`response.completed`	Respuesta completa

Ejemplo: streaming básico de texto

prompt = "Explain the seasons of the year concisely to a child."


with client.responses.create(model="gpt-5-mini", input=prompt, stream=True) as stream:

    current_text = ""


    for event in stream:
        if event.type == "response.output_text.delta":

            current_text += event.delta
            print(current_text)

Ejemplo: streaming básico de texto

transmisión de texto

Ejemplo: gestionar múltiples eventos

prompt = "Explain how a neural network learns concisely for a child."

with client.responses.create(model="gpt-5-mini", input=prompt, stream=True) as stream:

    for event in stream:
        if event.type == "response.created":

            print("Respuesta iniciada...\n")


        elif event.type == "response.output_text.done":

            print("\n\n--- Bloque de texto finalizado ---\n")


        elif event.type == "response.completed":

            print(f"\nRespuesta completa:\n{current_text}")

Ejemplo: gestionar múltiples eventos

múltiples eventos

Ejemplo: streaming de eventos de herramientas

convert_currency() -> str:

date_time: str
from_timezone: str
to_timezone: str

tools = [
    {
        "type": "function",
        "name": "convert_currency",
        ...
     }
]

frankfurter

Ejemplo: streaming de eventos de herramientas

prompt = "How much is 120 euros in British pounds using the current exchange rate?"


with client.responses.create(model="gpt-5-mini", input=prompt, tools=tools, stream=True) as stream:

    current_args = ""

    for event in stream:
        if event.type == "response.function_call_arguments.delta":

            current_args += event.delta
            print("Args en streaming:", current_args)

        elif event.type == "response.function_call_arguments.done":

            print("\nArgumentos finales:", event.arguments)

        elif event.type == "response.completed":

            print("\n--- Completado ---")

Ejemplo: streaming de eventos de herramientas

streaming de eventos de herramientas

Resumen

eventos semánticos en chatgpt

¹ Eventos semánticos usados en ChatGPT

¡Vamos a practicar!

Trabajar con la API Responses de OpenAI