Ir para o conteúdo principal
Português— Escolher um idioma
Menu

Depois do Agent Builder: Agents SDK, Workspace Agents e a Agents API

Aula 3 de 25 Atualizada a 2 de novembro de 2026 Programador
Nesta página
  1. O que está a encerrar, o que permanece
  2. Caminho 1: O Agents SDK, para construir em código
  3. Caminho 2: Workspace Agents do ChatGPT
  4. Caminho 3: A Agents API, quando a OpenAI orquestra por si
  5. Como escolher
  6. Pontos-chave

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