Os agentes podem usar ferramentas para planejar e concluir tarefas, colaborar com outros agentes e manter o contexto entre as etapas.
Execute seu primeiro agente
Comece pelo guia de início rápido do SDK de agentes para instalar o SDK, definir um agente e executá-lo. Quando o agente estiver funcionando, volte a esta página para escolher o próximo recurso de que seu aplicativo precisa.
Obtenha o SDK de agentes
Consulte os repositórios no GitHub para encontrar mais exemplos, acompanhar issues e consultar a documentação de referência de cada linguagem.
Abra o repositório do SDK para TypeScript no GitHub.
Abra o repositório do SDK para Python no GitHub.
Escolha por onde começar
| Se você quer | Comece por aqui | Por quê |
|---|---|---|
| Criar um aplicativo de agentes diretamente em código | Início rápido | É o caminho mais curto para integrar o SDK e colocá-lo em funcionamento. |
| Definir com clareza um agente especialista | Definições de agentes | Comece por aqui se ainda estiver definindo o contrato de um único agente. |
| Escolher modelos, configurações padrão e mecanismos de transporte | Modelos e provedores | Consulte este guia quando a escolha do modelo, a configuração do provedor ou a estratégia de transporte afetar o fluxo de trabalho. |
| Entender o ciclo de execução e o estado | Execução de agentes | Este guia explica o ciclo de execução do agente, o streaming e as estratégias para dar continuidade à execução. |
| Executar tarefas em um ambiente baseado em contêineres | Agentes em sandbox | Consulte este guia quando o agente precisar de arquivos, comandos, pacotes, snapshots, montagens ou conexões com provedores. |
| Distribuir responsabilidades entre agentes especialistas | Orquestração e transferências de controle | Consulte este guia quando precisar de mais de um agente e tiver que decidir qual deles será responsável pela resposta. |
| Adicionar validação ou revisão humana | Salvaguardas e revisão humana | Consulte este guia quando o fluxo de trabalho precisar bloquear ou pausar uma operação de risco antes que ela prossiga. |
| Entender o que uma execução retorna | Resultados e estado | Esta página explica a saída final, o estado que permite retomar a execução e as interfaces para o próximo turno. |
| Adicionar ferramentas hospedadas, ferramentas definidas como funções ou MCP | Uso de ferramentas e Integrações e observabilidade | A documentação de ferramentas da plataforma explica como elas funcionam. O guia de integrações aborda o uso de MCP e o rastreamento no SDK. |
| Inspecionar e melhorar as execuções | Integrações e observabilidade e Avaliação de fluxos de trabalho de agentes | Comece usando rastreamentos para depuração e depois passe aos ciclos de avaliação. |
| Criar um fluxo de trabalho em que a voz seja a principal forma de interação | Agentes de voz | Use o pipeline de voz do SDK e os padrões para agentes em tempo real. |
Desenvolva com o SDK
Use o SDK quando seu servidor for responsável pela implantação, pela implementação das ferramentas, pelo armazenamento do estado e pelas decisões de aprovação. O SDK cuida do ciclo de execução do agente e chama as ferramentas. Essa abordagem é a mais indicada quando você precisa dos seguintes recursos.
- Código de aplicativo com tipagem em TypeScript ou Python
- Controle direto sobre ferramentas, servidores MCP e comportamento durante a execução
- Armazenamento personalizado ou estratégias de conversa gerenciadas pelo servidor
- Integração estreita com a lógica ou a infraestrutura existente do produto
Uma sequência comum de leitura da documentação do SDK é a seguinte.
- Comece pelo guia de início rápido para ver o resultado da primeira execução na tela.
- Consulte Definições de agentes e Modelos e provedores para definir com clareza um agente especialista.
- À medida que o fluxo de trabalho ficar mais complexo, avance para Execução de agentes, Orquestração e transferências de controle e Salvaguardas e revisão humana.
- Consulte Resultados e estado e Integrações e observabilidade quando a lógica do aplicativo depender do objeto de execução ou exigir mais detalhes sobre o comportamento do agente.
Compare as opções de execução de agentes
Consulte a visão geral dos agentes para comparar o SDK de agentes, a API de agentes e a API de respostas. O SDK de agentes é executado no seu aplicativo. A API de agentes executa um harness gerenciado no serviço da OpenAI.