← プロジェクト一覧に戻る

swarms

既製のマルチエージェント構成を数多く備えたPythonフレームワーク。最小限の土台を自分で組み上げる型ではありません

公式Apache-2.0
スター
7.3k
フォーク
1.1k
オープンIssue
485
最終コミット
2026年10月30日

swarmsとは

Swarmsは、1つのAgentクラスと、複数のエージェントを協働させる既製の型を数多く抱えたフレームワークです。直列につなぐ、同じ課題を全員に配る、監督役が専門家へ割り振る、多数決や討論で決める——こうした15種類をSwarmRouterが名前ひとつで呼び分けますが、型によっては、流れを表す文字列や、賛成役・反対役・審判役という3体の並び順など、名前以外の指定も要ります。依存関係をグラフで書くGraphWorkflowはこの呼び分けには含まれず、直接組み立てます。守備範囲の広さはそのまま設定量でもあり、14.0.0のAgentクラスは名前つきの引数だけで89個あります。しかも公式ドキュメントは、履歴をディスクに残すかどうかの既定値を、実際のコードとは違う形で説明しています。本番に載せる前に、既定値は書かれた説明ではなく実際の挙動で確かめておくことをおすすめします。

swarmsで何ができますか?

  • 1体のエージェントから始め、終了の判断も任せる — max_loops=3は指定した回数だけ推論を回し、max_loops="auto"にすると、モデル自身が完了と判断するまで計画と実行を続けます。モデル名はLiteLLMの識別子なので、OpenAIでもAnthropicでもGroqでもそのまま指定でき、fallback_modelsに候補を並べておけば最初のモデルが失敗したときに順に切り替わります。
  • 道具とMCPサーバーをつなぐ — 型注釈と説明文を添えたPythonの関数は、そのまま道具として使えます。モデルに見せる定義への変換はSwarms側が行います。mcp_urlかmcp_urlsを指定すれば、1つまたは複数のMCPサーバーに接続し、そこにある道具が追加の設定なしで使えるようになります。
  • 能力をマークダウンのスキルファイルで足す — skills_dirには、スキルごとのフォルダを並べたディレクトリを指定します。各フォルダに置くのは、AnthropicのAgent Skills形式のSKILL.mdが1つです。実行のたびに、課題と説明文が近いスキルだけがシステムプロンプトへ追加される仕組みで、すべてを読み込ませたい場合はhandle_skills()を引数なしで呼び出します。
  • 再起動をまたぐ記憶は自分で有効にする — persistent_memory=Trueを指定すると、作業ディレクトリの下にMEMORY.mdを書き出し、同じ名前のエージェントが次に起動したときに読み直します。既定は無効なので、指定しない限りディスクには何も残りません。一方で履歴の圧縮は既定で有効ですが、14.0.0が基準にするのはモデルごとの文脈長ではなく16,000トークンという固定値で、context_lengthに何を渡しても上書きされます。そのためどのモデルでも、実行中の履歴はおよそ14,400トークンで要約へ置き換わり、MEMORY.mdがある場合は元の全文が退避用フォルダへ複写されます。外部の文書を検索させたいときは、long_term_memoryにベクトルデータベースを渡します。
  • エージェントを組み合わせ、構成を名前で差し替える — SequentialWorkflowは出力を次のエージェントへ渡し、ConcurrentWorkflowは同じ課題を全員に配り、AgentRearrangeは"researcher -> writer, editor"のような流れの文字列でその中間を表します。SwarmRouterはswarm_typeという名前ひとつで、監督役が部下へ割り振る形、専門家の出力を集約役がまとめる形、グループチャット、多数決、審判つきの討論など15種類を呼び分けます。ただし名前だけでは足りない型もあり、AgentRearrangeには流れの文字列が要り、DebateWithJudgeは賛成役・反対役・審判役の3体をこの順に受け取り、BatchedGridWorkflowは実行時に課題の一覧を受け取ります。
  • 依存関係をグラフとして表す — GraphWorkflowはエージェントをノード、依存をエッジとして扱い、上流がすべて終わったノードだけを実行し、独立した枝は指定しなくても並列で走ります。ノードごとにon_node_completeが呼ばれるので進捗を出力でき、to_spec()はエージェント本体を含まない構成と名前だけを書き出すため、ワークフローの形をバージョン管理に載せられます。

swarmsを選ぶ前に

  • トレースは既定で有効で、公式ドキュメントによればタスク文・エージェントの出力・システムプロンプトを含む構成設定が記録されますが、環境変数1つで無効にできます。
  • グラフワークフローに保存先を指定した場合、途中経過はタスク文だけで識別されるため、14.0.0では同じタスクを再実行すると最初からではなく途中から再開されます。報告#1762

スター推移

8月17日〜10月30日 · +274

7.1k7.3k

よくある質問

swarmsは商用利用できますか?

swarmsはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

swarmsはどの形で使えますか?

swarmsはセルフホスト・マネージドクラウドの形で利用できます。