Swarm

Swarm: Framework de Orquestração Multi-Agente Leve

O que é o Swarm?

Swarm é um framework experimental e educacional desenvolvido pela OpenAI para explorar a orquestração multi-agente ergonômica e leve. Ele se concentra em tornar a coordenação e execução de agentes leve, altamente controlável e facilmente testável. O Swarm consegue isso através de duas abstrações primitivas: Agentes e handoffs.

Nota: O Swarm foi substituído pelo OpenAI Agents SDK, que é uma evolução pronta para produção do Swarm. Recomenda-se migrar para o Agents SDK para casos de uso em produção.

Como o Swarm funciona?

O Swarm opera permitindo que os Agentes englobem instruções e ferramentas. A qualquer momento, um Agente pode escolher entregar uma conversa para outro Agente. Esses primitivos são poderosos o suficiente para expressar dinâmicas ricas entre ferramentas e redes de agentes, permitindo que você construa soluções escaláveis e do mundo real.

Os Agentes Swarm são alimentados pela Chat Completions API e são sem estado entre as chamadas. A função client.run() implementa um loop que:

1. Obtém uma completion do Agente atual.
2. Executa chamadas de ferramentas e anexa resultados.
3. Troca de Agente, se necessário.
4. Atualiza as variáveis de contexto, se necessário.
5. Retorna se nenhuma nova chamada de função for feita.

Por que escolher o Swarm?

O Swarm explora padrões que são leves, escaláveis e altamente personalizáveis por design. É mais adequado para situações que lidam com um grande número de capacidades e instruções independentes que são difíceis de codificar em um único prompt.

Principais Características e Conceitos

• Agentes: Englobam instruções e ferramentas. Eles podem representar fluxos de trabalho ou etapas específicas definidas por instruções e funções.
• Handoffs: Agentes podem entregar a execução para outro Agente.
• Funções: Agentes Swarm podem chamar funções Python diretamente. As funções geralmente devem retornar uma string (os valores serão tentados a serem convertidos como uma string).
• Variáveis de Contexto: Agentes podem acessar e atualizar variáveis de contexto, permitindo que eles mantenham o estado e compartilhem informações.
• Streaming: O Swarm suporta streaming de respostas, fornecendo atualizações em tempo real.

Como usar o Swarm?

1. Instalação:

   pip install git+ssh://git@github.com/openai/swarm.git
   

   ou

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

2. Instanciar um cliente Swarm:

   from swarm import Swarm
   
   client = Swarm()
   

3. Definir Agentes:

   from swarm import Agent
   
   agent_a = Agent(
       name="Agent A",
       instructions="Você é um agente útil.",
       functions=[transfer_to_agent_b],
   )
   
   agent_b = Agent(
       name="Agent B",
       instructions="Só fale em Haikus.",
   )
   
   def transfer_to_agent_b():
       return agent_b
   

4. Executar o Swarm:

   response = client.run(
       agent=agent_a,
       messages=[{"role": "user", "content": "Eu quero falar com o agente B."}],
   )
   
   print(response.messages[-1]["content"])
   

Para quem é o Swarm?

Swarm é um recurso educacional para desenvolvedores curiosos para aprender sobre orquestração multi-agente. É adequado para aqueles que lidam com um grande número de capacidades e instruções independentes que são difíceis de codificar em um único prompt.

Exemplos

• basic: Exemplos simples de fundamentos como configuração, chamada de função, handoffs e variáveis de contexto.
• triage_agent: Exemplo simples de configurar uma etapa de triagem básica para entregar ao agente correto.
• weather_agent: Exemplo simples de chamada de função.
• airline: Uma configuração multi-agente para lidar com diferentes solicitações de atendimento ao cliente em um contexto de companhia aérea.
• support_bot: Um bot de atendimento ao cliente que inclui um agente de interface do usuário e um agente de central de ajuda com várias ferramentas.
• personal_shopper: Um agente de compras pessoal que pode ajudar a fazer vendas e reembolsar pedidos.

Conclusão

Embora o Swarm tenha sido sucedido pelo OpenAI Agents SDK, ele permanece um recurso educacional valioso para entender a orquestração multi-agente. Ele fornece uma base para a construção de fluxos de trabalho de AI escaláveis e personalizáveis. O Agents SDK é uma solução pronta para produção para desenvolvedores que buscam gerenciamento e recuperação de memória integrados, representando uma evolução significativa do Swarm.