Repolode
Enviar
openai

openai/swarm

Framework Python experimental e educacional para orquestração leve de múltiplos agentes, baseado em Agents e handoffs pela API Chat Completions.

Ver no GitHub
Estrelas
22,111
Forks
2,351
Issues abertas
38
Último commit
há 7 meses

O que é?

Swarm é um framework Python para coordenar vários agentes LLM. Seus dois componentes centrais são Agent, que reúne instruções e funções chamáveis, e handoffs, que permitem que um agente transfira a conversa para outro. O método run() do cliente percorre completions do modelo, a execução de ferramentas e as trocas de agente até que não haja novas chamadas de função; então, retorna as mensagens atualizadas, o agente ativo e as variáveis de contexto.

O Swarm é baseado inteiramente na API Chat Completions e não mantém estado entre chamadas, então quem o utiliza precisa enviar o histórico de mensagens novamente a cada turno. O framework oferece suporte a streaming, variáveis de contexto por execução que agentes e funções podem ler e um REPL de demonstração para testar uma configuração pela linha de comando.

O projeto é explicitamente experimental e educacional. A OpenAI informa que ele foi substituído pelo OpenAI Agents SDK, que a equipe recomenda para uso em produção.

Recursos principais

  • 01Objetos Agent combinam instruções com funções Python que o modelo pode chamar.
  • 02Handoffs permitem que um agente transfira a conversa para outro agente.
  • 03Variáveis de contexto são passadas para funções e instruções dinâmicas.
  • 04Baseado na API Chat Completions, sem estado no servidor.
  • 05Oferece suporte a respostas em streaming e a um loop de demonstração pela linha de comando.

Casos de uso

  • Aprender na prática como funcionam handoffs entre vários agentes e chamadas de ferramentas.
  • Criar um protótipo de fluxo de triagem que encaminha solicitações para agentes especializados.
  • Criar demonstrações de atendimento ao cliente com agentes separados para diferentes tarefas.

Início rápido

  1. 1

    Instale o Swarm do GitHub com pip (requer Python 3.10 ou superior).

    pip install git+https://github.com/openai/swarm.git
  2. 2

    Crie um cliente do Swarm, defina agentes e funções e, em seguida, chame client.run() conforme mostrado no exemplo de uso do README.

Antes de usar

  • O Swarm é experimental e educacional, e não foi projetado para uso em produção.
  • O README informa que o Swarm foi substituído pelo OpenAI Agents SDK, recomendado para produção.
  • O Swarm é baseado na API Chat Completions e não mantém estado entre chamadas; portanto, você precisa gerenciar o histórico da conversa por conta própria.

Em coleções

Frameworks de orquestração multiagenteFrameworks e apps de agentes de IA open source

Tópicos

#multi-agent#llm#agent-framework#openai#function-calling#python

Perguntas frequentes

O que é swarm?
Framework Python experimental e educacional para orquestração leve de múltiplos agentes, baseado em Agents e handoffs pela API Chat Completions. Swarm é um framework Python para coordenar vários agentes LLM. Seus dois componentes centrais são Agent, que reúne instruções e funções chamáveis, e handoffs, que permitem que um agente transfira a conversa para outro. O método run() do cliente percorre completions do modelo, a execução de ferramentas e as trocas de agente até que não haja novas chamadas de função; então, retorna as mensagens atualizadas, o agente ativo e as variáveis de contexto.
swarm é gratuito? Qual é a licença?
swarm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
swarm ainda é mantido?
Sem commits há mais de 6 meses. O último commit de swarm foi em 15 de abr. de 2026.
Para que posso usar swarm?
Aprender na prática como funcionam handoffs entre vários agentes e chamadas de ferramentas. Criar um protótipo de fluxo de triagem que encaminha solicitações para agentes especializados. Criar demonstrações de atendimento ao cliente com agentes separados para diferentes tarefas.
Como instalar swarm?
Instale o Swarm do GitHub com pip (requer Python 3.10 ou superior).: pip install git+https://github.com/openai/swarm.git Crie um cliente do Swarm, defina agentes e funções e, em seguida, chame client.run() conforme mostrado no exemplo de uso do README.
Onde consigo swarm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/openai/swarm

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

Projetos relacionados