Os agentes podem usar ferramentas para planejar e concluir tarefas, trabalhar com outros agentes e manter o contexto entre as etapas. Ao escolher um ambiente de execução, considere onde a orquestração deve ocorrer e quem deve gerenciar o estado entre as tarefas.
Escolha por onde começar
| Se você quer | Comece por aqui |
|---|---|
| Executar um agente com o harness do Codex gerenciado pela OpenAI | Agents API |
| Controlar o ciclo de execução do agente no seu aplicativo com agentes reutilizáveis, ferramentas e transferências de controle entre agentes | Agents SDK |
| Trabalhar diretamente com as respostas dos modelos e controlar sua integração | Responses API |
| Incorporar um chat ao seu aplicativo | ChatKit |
Compare as opções de execução de agentes
| Agents API | Agents SDK | Responses API | |
|---|---|---|---|
| Quando usar | Para executar tarefas de longa duração em que a OpenAI gerencia o agente e salva seu progresso | Para criar agentes com ferramentas e fluxos de trabalho personalizados no seu aplicativo | Para chamar modelos diretamente ou criar um agente do zero |
| Onde o agente é executado | A OpenAI executa e gerencia o harness do Codex | O SDK é executado no seu aplicativo | No seu aplicativo, com opção de orquestração hospedada |
| Esforço para integrar o agente | Baixo | Médio | Alto |
| Estado entre tarefas | A configuração da sessão, os turnos e os itens ficam salvos | Seu próprio armazenamento e as sessões do SDK, ou o estado da conversa na Responses API | Histórico gerenciado manualmente, encadeamento de respostas ou Conversations |
| Execução de ferramentas | Ferramentas conectadas ao serviço, código do aplicativo que processa chamadas de função e um sandbox opcional | Ferramentas e integrações configuradas no seu aplicativo | Ferramentas hospedadas e ferramentas que seu aplicativo executa |
| Ambiente de execução | Sandbox hospedado pela OpenAI, sandbox em infraestrutura própria ou execução sem sandbox | Seu ambiente de execução e suas integrações com provedores de sandbox | Seu próprio ambiente de execução |
| Comece por aqui | Visão geral da Agents API | Visão geral do Agents SDK | Guia da Responses API |
A Agents API executa o harness do Codex e gerencia a infraestrutura dos agentes para que você possa se concentrar no que eles fazem. A API oferece compactação automática de contexto, orquestração de múltiplos agentes, chamadas programáticas de ferramentas e suporte a servidores MCP. Consulte Arquitetura.
Com o Agents SDK, seu aplicativo controla a implantação, o armazenamento, as aprovações e a integração com o ambiente de execução. O executor do SDK gerencia o ciclo de execução do agente e as transferências de controle entre agentes. Consulte Execução de agentes.
Adicione ferramentas, habilidades e cache de prompts
O design de ferramentas, as habilidades reutilizáveis e o cache de prompts se aplicam a diferentes fluxos de trabalho com agentes. A configuração e o ciclo de vida desses recursos podem variar conforme a API.
- Comece pelo guia Uso de ferramentas para saber mais sobre chamada de função, MCP e recursos hospedados.
- Leia Chamadas programáticas de ferramentas para saber como orquestrar ferramentas com JavaScript e configurá-las em cada API.
- Consulte Habilidades para saber como reutilizar instruções e quais mecanismos de carregamento estão disponíveis.
- Leia Cache de prompts para entender como o cache funciona nas diferentes APIs. Em seguida, consulte Observabilidade e uso da Agents API para saber como o uso é contabilizado por sessão.
Uma sessão da Agents API, uma sessão do SDK, uma conversa da Responses API e um sandbox são recursos distintos. Siga as instruções de gerenciamento de estado e limpeza de recursos do ambiente de execução que você escolher.