Découvrez Ruby OpenAI Swarm : Un cadre éducatif basé sur Ruby pour l’orchestration légère de plusieurs agents.
Ruby OpenAI Swarm
Introduction à Ruby OpenAI Swarm
Un cadre éducatif basé sur Ruby, adapté de Swarm d’OpenAI, explorant l’orchestration ergonomique et légère de plusieurs agents.
Installation
Bundler
Ajoutez cette ligne à votre Gemfile d’application:
gem "ruby-openai-swarm"
Puis exécutez:
$ bundle install
Installation de la gem
Ou installez avec:
$ gem install ruby-openai-swarm
et requirez avec:
require "ruby-openai-swarm"
Utilisation
Avec Config
Pour une configuration plus robuste, vous pouvez configurer la gem avec vos clés API, par exemple dans un fichier d’initialisation openai.rb. Ne codifiez jamais les secrets dans votre base de code – utilisez plutôt quelque chose comme dotenv pour passer les clés en toute sécurité dans vos environnements.
Puis vous pouvez créer un client de cette manière:
client = OpenAISwarm.new
Définissez un agent espagnol comme suit:
def spanish_agent
OpenAISwarm::Agent.new(
name: "Spanish Agent",
instructions: "You only speak Spanish.",
model: "gpt-4o-mini"
)
end
Créez une fonction de transfert vers l’agent espagnol:
transfer_to_spanish_agent = OpenAISwarm::FunctionDescriptor.new(
target_method: :spanish_agent,
description: 'Transfer spanish speaking users immediately.'
)
Agent anglais:
english_agent = OpenAISwarm::Agent.new(
name: "English Agent",
instructions: "You only speak English.",
model: "gpt-4o-mini",
functions: [transfer_to_spanish_agent]
)
Messages:
messages = [{"role": "user", "content": "Hola. ¿Como estás?"}]
response = client.run(agent: english_agent, messages: messages, debug: true)
pp response.messages.last
Exemples
Consultez /examples pour de l’inspiration! Apprenez-en plus sur chacun d’eux dans leur README.
Documentation
Développement
Après avoir vérifié le dépôt, exécutez bin/setup pour installer les dépendances. Ensuite, exécutez rake spec pour exécuter les tests. Vous pouvez également exécuter bin/console pour un environnement interactif qui vous permettra d’expérimenter.
Pour installer cette gem sur votre machine locale, exécutez bundle exec rake install. Pour publier une nouvelle version, mettez à jour le numéro de version dans version.rb, puis exécutez bundle exec rake release, ce qui créera une balise git pour la version, poussera les commits et les balises git, et poussera le fichier .gem vers rubygems.org.
Contributions
Les rapports de bugs et les demandes de tirage sont les bienvenus sur GitHub à l’adresse https://github.com/graysonchen/ruby-openai-swarm. Ce projet a pour but d’être un espace de collaboration sûr et accueillant, et il est attendu que les contributeurs adhèrent au code de conduite.
Licence
La gem est disponible en open source sous les termes de la Licence MIT.
Source : socket.dev