Agency Swarm

Agency Swarm: Framework de Orquestração Multi-Agente Confiável

Agency Swarm é um framework de código aberto projetado para simplificar a criação de agências de AI, aproveitando e estendendo o OpenAI Agents SDK. Ele facilita a construção, orquestração e gerenciamento de enxames colaborativos de agentes de AI, permitindo uma verdadeira colaboração entre agentes com fluxos de comunicação definidos pelo usuário.

O que é Agency Swarm?

Agency Swarm aprimora o OpenAI Agents SDK, introduzindo recursos como verdadeira colaboração entre agentes com fluxos de comunicação flexíveis, uma classe Agency para definir comunicação complexa, persistência de conversação flexível e uma ferramenta especializada send_message para comunicação entre agentes. Ele permite que os desenvolvedores pensem na automação em termos de estruturas organizacionais do mundo real, tornando-o intuitivo tanto para agentes quanto para usuários.

Principais Características:

• Funções de Agente Personalizáveis: Defina funções de agente distintas (por exemplo, CEO, Assistente Virtual, Desenvolvedor) com instruções, ferramentas e capacidades personalizadas.
• Controle Total Sobre Prompts/Instruções: Mantenha controle completo sobre os prompts de orientação de cada agente para personalização precisa do comportamento.
• Ferramentas com Tipos Seguros: Desenvolva ferramentas usando modelos Pydantic para validação automática de argumentos.
• Comunicação de Agentes Orquestrada: Agentes se comunicam através de uma ferramenta dedicada send_message, com interações governadas por fluxos de comunicação explícitos e direcionais.
• Persistência de Estado Flexível: Gerencie o histórico de conversas fornecendo load_threads_callback e save_threads_callback para a Agency, permitindo persistência entre sessões (por exemplo, armazenamento em DB/arquivo).
• Orquestração Multi-Agente: Construa fluxos de trabalho de agentes sobre a base do OpenAI Agents SDK, aprimorado pela camada de orquestração estruturada do Agency Swarm.
• Foco em Prontidão para Produção: Construído para confiabilidade e projetado para fácil implantação em ambientes do mundo real.

Como funciona o Agency Swarm?

Agency Swarm é construído sobre o OpenAI Agents SDK, introduzindo o conceito de uma Agency que gerencia múltiplos agentes e seus fluxos de comunicação. Os componentes-chave incluem:

• Agency: Um orquestrador que define fluxos de comunicação entre agentes usando o operador >. Ele também lida com a persistência da conversação através de funções de callback.
• Agent: Uma extensão do Agent SDK base com tratamento de arquivos integrado e registro de subagentes. Os agentes podem receber funções, instruções e ferramentas específicas.
• Fluxos de Comunicação: Caminhos de comunicação explícitos e direcionais definidos na Agency que governam como os agentes interagem entre si.
• Ferramentas: Ferramentas personalizadas desenvolvidas usando modelos Pydantic ou convertidas de esquemas OpenAPI, permitindo que os agentes executem tarefas específicas.

Como usar o Agency Swarm?

1. Instalação: Instale o pacote usando pip: pip install -U agency-swarm
2. Definir Chave OpenAI: Defina sua chave OpenAI API em um arquivo .env ou exporte-a em seu shell.
3. Criar Ferramentas: Defina ferramentas personalizadas usando o decorador @function_tool ou estenda BaseTool.
4. Definir Funções de Agente: Defina funções de agente com instruções, ferramentas e capacidades específicas.
5. Definir Fluxos de Comunicação da Agência: Estabeleça fluxos de comunicação entre agentes usando a classe Agency e o operador >.
6. Executar uma Demonstração: Execute uma demonstração usando a interface do usuário web (agency.copilot_demo()), terminal (agency.terminal_demo()) ou programaticamente.

Para quem é o Agency Swarm?

Agency Swarm foi projetado para desenvolvedores, engenheiros de AI e pesquisadores que desejam construir aplicações de AI multi-agente complexas. É particularmente útil para:

• Automatizar tarefas complexas que exigem colaboração entre múltiplos agentes de AI.
• Construir fluxos de trabalho alimentados por AI que imitam estruturas organizacionais do mundo real.
• Criar aplicações de AI prontas para produção que podem ser facilmente implantadas e escaladas.

Por que escolher o Agency Swarm?

Agency Swarm oferece diversas vantagens sobre as abordagens tradicionais de desenvolvimento de AI:

• Orquestração Multi-Agente Simplificada: Fornece um framework estruturado para gerenciar e orquestrar múltiplos agentes de AI.
• Colaboração Aprimorada: Permite verdadeira colaboração entre agentes com fluxos de comunicação definidos pelo usuário.
• Pronto para Produção: Construído para confiabilidade e projetado para fácil implantação em ambientes do mundo real.
• Extensível: Aproveita e estende o OpenAI Agents SDK, permitindo que os desenvolvedores personalizem e estendam o framework para atender às suas necessidades específicas.

A melhor maneira de construir aplicações de AI multi-agente?

Agency Swarm fornece um framework robusto e flexível para construir aplicações de AI multi-agente. Ao definir funções de agente, fluxos de comunicação e ferramentas personalizadas, os desenvolvedores podem criar fluxos de trabalho alimentados por AI que podem automatizar tarefas complexas e resolver problemas do mundo real. O foco do framework na prontidão para produção e extensibilidade o torna uma escolha ideal para construir aplicações de AI escaláveis e confiáveis.

Compatibilidade:

• Python: 3.12+
• Backends de modelos:
  • OpenAI (nativo): Família GPT-5, GPT-4o, etc.
  • Via LiteLLM (roteador): Anthropic (Claude), Google (Gemini), Azure OpenAI, OpenRouter (gateway), etc.
• SO: macOS, Linux, Windows

Conclusão:

Agency Swarm simplifica o desenvolvimento de aplicações de AI multi-agente, fornecendo um framework estruturado para gerenciar funções de agente, fluxos de comunicação e ferramentas. Seu design pronto para produção e extensibilidade o tornam uma ferramenta poderosa para construir soluções de AI escaláveis e confiáveis. Se você está procurando construir aplicações de AI complexas que exigem colaboração entre múltiplos agentes, Agency Swarm é uma excelente escolha.