Después de Agent Builder: Agents SDK, Workspace Agents y la Agents API
En esta página
Hasta ahora, esta lección ha cubierto Agent Builder, la herramienta visual sin código de OpenAI para crear agentes. OpenAI anunció su fin de vida útil el 3 de junio de 2026, con un apagado programado para el 30 de noviembre de 2026. En lugar de aprender una herramienta que está desapareciendo, veamos qué la sustituye. Tienes tres caminos según tus objetivos: escribir código, construir en lenguaje natural para un equipo o delegar la orquestación en OpenAI.
Qué se cierra, qué permanece
Agent Builder se cierra; ChatKit, el componente de interfaz que verás más adelante en este curso, permanece disponible. Si ya tienes un flujo de trabajo en Agent Builder, OpenAI te permite exportarlo antes del apagado: abre el flujo de trabajo, elige Code en la barra superior, luego Agents SDK, selecciona TypeScript o Python, y copia la exportación completa. La guía de migración advierte con honestidad que esta exportación no convierte el grafo del flujo de trabajo y no garantiza que cada comportamiento se replique exactamente: planifica una fase de pruebas.
Camino 1: The Agents SDK, para construir en código
Este es el camino que sigue este curso a partir de la siguiente lección. The Agents SDK te ofrece control total: declaras el agente, sus instrucciones, su modelo y sus herramientas dentro de tu aplicación, lo ejecutas en tu propio entorno y lo despliegas como el resto de tu código. La exportación de Agent Builder se integra directamente en él; luego instalas el SDK correspondiente, configuras la aplicación y validas el comportamiento antes de desplegar.
from agents import Agent, Runner, WebSearchTool
agent = Agent(
name="Technical Support",
instructions=(
"You are a technical support agent for a SaaS company. "
"Respond in English. Identify the problem before proposing solutions."
),
model="gpt-6.1-sol",
tools=[WebSearchTool()],
)
result = Runner.run_sync(agent, "My CSV export has been empty since this morning.")
print(result.final_output)
Camino 2: ChatGPT Workspace Agents
Si utilizabas Agent Builder para evitar programar, el equivalente reside ahora en ChatGPT. Los Workspace agents se crean en lenguaje natural y se comparten con un equipo; requieren un plan ChatGPT Business, Enterprise o Edu, acceso a workspace agents y permiso para crearlos. Para migrar, OpenAI sugiere un método sencillo: crea un nuevo agente en ChatGPT y pega tu exportación de flujo de trabajo con el prompt «help me convert this workflow into an agent». Antes de finalizar, revisa las instrucciones generadas, configura las aplicaciones, habilidades, autenticaciones y permisos necesarios, y utiliza Preview para reproducir casos representativos del flujo de trabajo original. Una limitación a tener en cuenta: un flujo de trabajo cuyo núcleo depende de una secuencia estrictamente determinista puede no traducirse fielmente a un agente.
Camino 3: The Agents API, cuando OpenAI orquesta por ti
Desde el 10 de septiembre de 2026, existe un tercer camino en beta pública: la Agents API. Ofrece a tu aplicación acceso al harness de Codex mediante una API gestionada por OpenAI. Tu aplicación proporciona las herramientas y elige el entorno de ejecución; OpenAI se encarga de las sesiones, la orquestación, la compactación del contexto y la recuperación ante incidentes. El agente puede trabajar en un entorno aislado (sandbox) donde ejecuta código, modifica archivos, se conecta a servidores MCP y produce documentos.
La API gira en torno a cuatro conceptos: el agent (modelo, instrucciones, herramientas y servidores MCP), el environment (un sandbox o computadora, opcional, alojado por OpenAI o por ti), la session (una instancia duradera del agente que recibe tareas y responde a ellas) y los events (lo que envías y lo que produce el agente). Una sesión se desarrolla en cuatro etapas: la creas, le asignas una tarea, monitorizas su progreso mediante stream o webhook, y luego la reinicias o rediriges a mitad de camino.
from openai import OpenAI
client = OpenAI()
session = client.beta.agents.sessions.create(
agent={
"model": "gpt-6-astra",
"instructions": "Answer technical questions precisely, relying on web search.",
"tools": [{"type": "web_search"}],
},
input=[{
"role": "user",
"content": [{"type": "input_text", "text": "Summarize the recommended steps to connect an MCP server to an OpenAI agent."}],
}],
)
print(session.id)
Debes verificar dos restricciones antes de elegir este camino para datos sensibles: la Agents API ofrece actualmente residencia de datos solo en Estados Unidos y no es elegible para la retención cero de datos, incluso con un sandbox que alojes tú mismo. La facturación sigue la tarifa de la API para el modelo elegido, la tarifa para las herramientas de OpenAI y la tarifa para los contenedores de sandboxes alojados.
Cómo elegir
Si tu equipo sabe desarrollar y quiere mantener el control sobre la ejecución, elige the Agents SDK. Si el objetivo es poner un agente en manos de compañeros no desarrolladores dentro de ChatGPT, elige workspace agents. Si quieres un agente que funcione durante largos periodos, con ejecución de código y subagentes, sin mantener la orquestación tú mismo, examina la Agents API, teniendo en cuenta su estado beta y las restricciones de datos.
Fuentes oficiales: Migrate from Agent Builder · Agents API · Deprecations
Puntos clave
- Agent Builder cierra el 30 de noviembre de 2026; ChatKit permanece disponible; exporta tus flujos de trabajo a código de Agents SDK antes de esa fecha
- Agents SDK: construye en código y despliega en tu aplicación; este es el camino de este curso
- Workspace agents: construye en lenguaje natural en ChatGPT (planes Business, Enterprise, Edu)
- Agents API (beta pública): OpenAI gestiona sesiones, orquestación y compactación; residencia de datos solo en Estados Unidos, sin retención cero de datos