Repolode
openai

openai/openai-agents-python

Framework leve em Python para criar fluxos de trabalho multiagente com ferramentas, transferências, guardrails, sessões e tracing, compatível com OpenAI e mais de 100 LLMs.

Estrelas
30,164
Forks
5,079
Issues abertas
23
Último commit
há 12 horas

O que é?

O OpenAI Agents SDK é um framework em Python para criar agentes: LLMs configurados com instruções, ferramentas, guardrails e transferências que delegam tarefas a outros agentes. Ele oferece suporte às APIs OpenAI Responses e Chat Completions, além de mais de 100 outros LLMs, sem ficar limitado a um único provedor.

Além de agentes de texto, o SDK inclui agentes sandbox que trabalham em um contêiner durante tarefas mais longas, agentes em tempo real para sessões de voz e multimodais com baixa latência via WebSocket e pipelines de voz que encadeiam speech-to-text, um fluxo de trabalho com agente e text-to-speech. As sessões gerenciam o histórico da conversa entre execuções, e os hooks integrados de human-in-the-loop permitem que pessoas intervenham durante uma execução do agente.

O tracing registra as execuções dos agentes para que os desenvolvedores possam visualizar, depurar e otimizar os fluxos de trabalho. Uma versão em JavaScript/TypeScript é mantida separadamente em um repositório irmão.

Recursos principais

  • 01Agentes configurados com instruções, ferramentas, guardrails e transferências
  • 02Compatível com as APIs OpenAI Responses e Chat Completions e mais de 100 outros LLMs
  • 03Agentes sandbox que inspecionam arquivos, executam comandos e aplicam patches em um workspace
  • 04Agentes em tempo real e de voz para pipelines de voz baseados em WebSocket
  • 05Gerenciamento automático do histórico das sessões e tracing integrado

Casos de uso

  • Criar um sistema multiagente em que agentes especialistas cuidam de subtarefas delegadas
  • Criar um assistente de voz que combina reconhecimento de fala, um agente e síntese de fala
  • Executar um agente de programação ou pesquisa que precise ler arquivos e executar comandos em um sandbox
  • Depurar e monitorar execuções de agentes em produção com o tracing integrado

Início rápido

  1. 1

    Criar um ambiente virtual

    python -m venv .venv
  2. 2

    Ativar o ambiente virtual

    source .venv/bin/activate
  3. 3

    Instalar o pacote openai-agents

    pip install openai-agents
  4. 4

    Definir a variável de ambiente OPENAI_API_KEY e, em seguida, executar um agente de texto

Antes de usar

  • Requer Python 3.10 ou superior.
  • É necessária uma chave de API da OpenAI (OPENAI_API_KEY) para executar os exemplos.

Tópicos

Perguntas frequentes

O que é openai-agents-python?
Framework leve em Python para criar fluxos de trabalho multiagente com ferramentas, transferências, guardrails, sessões e tracing, compatível com OpenAI e mais de 100 LLMs. O OpenAI Agents SDK é um framework em Python para criar agentes: LLMs configurados com instruções, ferramentas, guardrails e transferências que delegam tarefas a outros agentes. Ele oferece suporte às APIs OpenAI Responses e Chat Completions, além de mais de 100 outros LLMs, sem ficar limitado a um único provedor.
openai-agents-python é gratuito? Qual é a licença?
openai-agents-python é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
openai-agents-python ainda é mantido?
Manutenção ativa. O último commit de openai-agents-python foi em 20 de out. de 2026.
Para que posso usar openai-agents-python?
Criar um sistema multiagente em que agentes especialistas cuidam de subtarefas delegadas Criar um assistente de voz que combina reconhecimento de fala, um agente e síntese de fala Executar um agente de programação ou pesquisa que precise ler arquivos e executar comandos em um sandbox Depurar e monitorar execuções de agentes em produção com o tracing integrado
Como instalar openai-agents-python?
Criar um ambiente virtual: python -m venv .venv Ativar o ambiente virtual: source .venv/bin/activate Instalar o pacote openai-agents: pip install openai-agents Definir a variável de ambiente OPENAI_API_KEY e, em seguida, executar um agente de texto
Onde consigo openai-agents-python?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/openai/openai-agents-python

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados