Depois do Agent Builder: Agents SDK, Workspace Agents e a Agents API
Nesta página
Até agora, esta lição abordou o Agent Builder, a ferramenta visual sem código da OpenAI para criar agentes. A OpenAI anunciou o fim da sua vida útil a 3 de junho de 2026, com desativação prevista para 30 de novembro de 2026. Em vez de aprender uma ferramenta que está a desaparecer, vamos analisar o que a substitui. Tem três caminhos disponíveis, dependendo dos seus objetivos: escrever código, construir em linguagem natural para uma equipa ou delegar a orquestração à OpenAI.
O que está a encerrar, o que permanece
O Agent Builder está a encerrar; o ChatKit, o componente de interface que verá mais adiante neste curso, permanece disponível. Se já possui um fluxo de trabalho no Agent Builder, a OpenAI permite exportá-lo antes do encerramento: abra o fluxo de trabalho, selecione Code na barra superior, depois Agents SDK, escolha TypeScript ou Python e copie a exportação completa. O guia de migração alerta honestamente que esta exportação não converte o grafo do fluxo de trabalho e não garante que todos os comportamentos sejam replicados exatamente: planeie uma fase de testes.
Caminho 1: O Agents SDK, para construir em código
Este é o caminho que este curso seguirá a partir da próxima lição. O Agents SDK oferece controlo total: declara o agente, as suas instruções, o seu modelo e as suas ferramentas dentro da sua aplicação, executa-o no seu próprio ambiente e implementa-o como o restante do seu código. A exportação do Agent Builder integra-se diretamente nele; basta instalar o SDK correspondente, configurar a aplicação e validar o comportamento antes da implementação.
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)
Caminho 2: Workspace Agents do ChatGPT
Se utilizava o Agent Builder para evitar codificar, o equivalente reside agora no ChatGPT. Os workspace agents são criados em linguagem natural e partilhados com uma equipa; exigem um plano ChatGPT Business, Enterprise ou Edu, acesso aos workspace agents e permissão para os criar. Para migrar, a OpenAI sugere um método simples: crie um novo agente no ChatGPT e cole a sua exportação de fluxo de trabalho com o prompt “help me convert this workflow into an agent”. Antes de finalizar, reveja as instruções geradas, configure as aplicações necessárias, competências, autenticações e permissões e, em seguida, utilize Preview para reproduzir casos representativos do fluxo de trabalho original. Uma limitação a notar: um fluxo de trabalho cujo núcleo depende de uma sequência estritamente determinística pode não ser traduzido fielmente num agente.
Caminho 3: A Agents API, quando a OpenAI orquestra por si
Desde 10 de setembro de 2026, existe um terceiro caminho em beta público: a Agents API. Esta fornece à sua aplicação acesso à infraestrutura Codex através de uma API gerida pela OpenAI. A sua aplicação fornece as ferramentas e escolhe o ambiente de execução; a OpenAI gere sessões, orquestração, compactação de contexto e recuperação de incidentes. O agente pode trabalhar numa sandbox onde executa código, modifica ficheiros, liga-se a servidores MCP e produz documentos.
A API gira em torno de quatro conceitos: o agent (modelo, instruções, ferramentas e servidores MCP), o environment (uma sandbox ou computador, opcional, alojado pela OpenAI ou por si), a session (uma instância duradoura do agente que recebe tarefas e responde a elas) e events (o que envia e o que o agente produz). Uma sessão desenrola-se em quatro fases: cria-a, atribui-lhe uma tarefa, monitoriza o seu progresso via stream ou webhook e, depois, reinicia-a ou redireciona-a a meio do processo.
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)
Duas restrições devem ser verificadas antes de escolher este caminho para dados sensíveis: a Agents API oferece atualmente residência de dados apenas nos Estados Unidos e não é elegível para retenção zero de dados, mesmo com uma sandbox que aloje por conta própria. A faturação segue a tarifa da API para o modelo escolhido, a tarifa para as ferramentas da OpenAI e a tarifa para contentores de sandboxes alojadas.
Como escolher
Se a sua equipa sabe desenvolver e deseja manter o controlo sobre a execução, escolha o Agents SDK. Se o objetivo é colocar um agente nas mãos de colegas não programadores dentro do ChatGPT, escolha os workspace agents. Se deseja um agente que funcione por longos períodos, com execução de código e subagentes, sem manter a orquestração por conta própria, consulte a Agents API, tendo em mente o seu estado beta e as restrições de dados.
Fontes oficiais: Migrate from Agent Builder · Agents API · Deprecations
Pontos-chave
- O Agent Builder encerra a 30 de novembro de 2026; o ChatKit permanece disponível; exporte os seus fluxos de trabalho para código Agents SDK antes dessa data
- Agents SDK: construa em código e implemente na sua aplicação — este é o caminho deste curso
- Workspace agents: construa em linguagem natural no ChatGPT (planos Business, Enterprise, Edu)
- Agents API (beta público): a OpenAI gere sessões, orquestração e compactação; residência de dados apenas nos Estados Unidos, sem retenção zero de dados