Repolode
Enviar
VRSEN

VRSEN/agency-swarm

Framework Python para criar sistemas multiagente em que agentes de IA com funções definidas repassam tarefas entre si por meio de fluxos explícitos de comunicação.

Ver no GitHubSite
Estrelas
4,629
Forks
1,063
Issues abertas
9
Último commit
há 5 dias

O que é?

Agency Swarm é um framework Python para criar aplicações compostas por vários agentes de IA que trabalham em conjunto, organizados como uma equipe de verdade. Cada agente tem sua própria função, instruções e ferramentas, e o desenvolvedor define quais agentes podem iniciar conversas com quais outros. O framework é baseado no OpenAI Agents SDK e acrescenta uma camada de orquestração.

Os agentes se comunicam por meio de uma ferramenta dedicada chamada send_message, e o conjunto direcional communication_flows definido em uma Agency determina quem pode entrar em contato com quem. As ferramentas podem ser escritas como funções Python com o decorator @function_tool, como subclasses de BaseTool que usam campos Pydantic ou geradas a partir de schemas OpenAPI. O histórico de conversas pode ser persistido por meio de callbacks de carregamento e salvamento, por exemplo, em um banco de dados ou armazenamento de arquivos.

O projeto requer Python 3.12+ e oferece suporte nativo a modelos da OpenAI. Outros provedores, como Anthropic, Gemini e Azure OpenAI, podem ser acessados pelo LiteLLM. O projeto oferece uma demonstração web e uma interface de terminal para executar uma agência.

Recursos principais

  • 01Define funções para os agentes, cada uma com instruções, ferramentas e configurações de modelo próprias.
  • 02Restringe a comunicação entre agentes com fluxos direcionais de comunicação.
  • 03Cria ferramentas com verificação de tipos a partir de funções Python, classes BaseTool ou schemas OpenAPI.
  • 04Persiste o histórico de conversas por meio de callbacks de carregamento e salvamento.
  • 05Pode ser executado por uma demonstração web, uma interface de terminal ou pela API assíncrona get_response.

Casos de uso

  • Criar protótipos de equipes de agentes especializados, como um agente CEO que delega tarefas a agentes desenvolvedores e assistentes.
  • Criar automações internas em que os agentes chamam APIs existentes descritas por schemas OpenAPI.
  • Executar fluxos de trabalho multiagente que precisam manter o estado das conversas entre sessões.

Início rápido

  1. 1

    Instale o framework com pip

    pip install -U agency-swarm
  2. 2

    Configure sua chave de API da OpenAI em um arquivo .env ou no shell

    export OPENAI_API_KEY="YOUR_API_KEY"
  3. 3

    Comece pelo Agency Starter Template e siga o README para definir agentes e fluxos de comunicação

Antes de usar

  • Requer Python 3.12 ou mais recente.
  • É necessária uma chave de API da OpenAI ou outro provedor de modelos compatível para executar agentes.
  • A migração da v0.x exige adaptar os projetos à nova versão baseada em SDK.

Em coleções

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

Tópicos

#multi-agent#llm#agents#python#openai#orchestration

Perguntas frequentes

O que é agency-swarm?
Framework Python para criar sistemas multiagente em que agentes de IA com funções definidas repassam tarefas entre si por meio de fluxos explícitos de comunicação. Agency Swarm é um framework Python para criar aplicações compostas por vários agentes de IA que trabalham em conjunto, organizados como uma equipe de verdade. Cada agente tem sua própria função, instruções e ferramentas, e o desenvolvedor define quais agentes podem iniciar conversas com quais outros. O framework é baseado no OpenAI Agents SDK e acrescenta uma camada de orquestração.
agency-swarm é gratuito? Qual é a licença?
agency-swarm é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
agency-swarm ainda é mantido?
Manutenção ativa. O último commit de agency-swarm foi em 2 de nov. de 2026.
Para que posso usar agency-swarm?
Criar protótipos de equipes de agentes especializados, como um agente CEO que delega tarefas a agentes desenvolvedores e assistentes. Criar automações internas em que os agentes chamam APIs existentes descritas por schemas OpenAPI. Executar fluxos de trabalho multiagente que precisam manter o estado das conversas entre sessões.
Como instalar agency-swarm?
Instale o framework com pip: pip install -U agency-swarm Configure sua chave de API da OpenAI em um arquivo .env ou no shell: export OPENAI_API_KEY="YOUR_API_KEY" Comece pelo Agency Starter Template e siga o README para definir agentes e fluxos de comunicação
Onde consigo agency-swarm?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/VRSEN/agency-swarm

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

Projetos relacionados