Responses API

Responses API: la evolución de Chat Completions para agentes

La Responses API es la nueva interfaz principal de OpenAI, diseñada para reemplazar progresivamente a la Assistants API con un modelo de programación más simple y potente.

Por qué Responses API

La Assistants API requería gestionar manualmente threads, runs y mensajes. La Responses API simplifica esto con una interfaz unificada que admite tanto llamadas sin estado como conversaciones persistentes.

Uso básico

from openai import OpenAI

client = OpenAI()

response = client.responses.create(
    model="gpt-4o",
    input="¿Cuáles son las mejores prácticas de seguridad en APIs REST?",
    tools=[{"type": "web_search_preview"}]
)

print(response.output_text)

Conversaciones con estado

# Primera vuelta
r1 = client.responses.create(
    model="gpt-4o",
    input="Mi nombre es Ana. ¿Cuál es la capital de Francia?"
)

# Continuar usando el ID de respuesta anterior
r2 = client.responses.create(
    model="gpt-4o",
    previous_response_id=r1.id,
    input="¿Y recuerdas cómo me llamo?"
)

Herramientas integradas

• web_search_preview: búsqueda web en tiempo real
• file_search: búsqueda en vector stores
• code_interpreter: ejecución de código Python
• computer_use_preview: control de interfaces gráficas
• function: function calling personalizado

Streaming

with client.responses.stream(
    model="gpt-4o",
    input="Escribe un análisis detallado de..."
) as stream:
    for event in stream:
        print(event.delta, end="", flush=True)

Migración desde Chat Completions

La Responses API acepta el mismo formato de mensajes que Chat Completions, facilitando la migración gradual.