open-multi-agent/open-multi-agent

Open Multi‑Agent (OMA)

何であるか – TypeScript を最優先にしたフレームワークで、任意の Node.js アプリケーション内に 動的 な LLM ベースのエージェントチームを実行できます。ユーザーが高レベルの目標を提示すると、組み込みの コーディネーター が実行時にタスクの DAG を自動生成し、エージェント間で作業をスケジューリングし、すべてのステップを記録して、実行内容を検査・承認・再実行・再開可能にします。

主なコンセプト

• 目標駆動型のオーケストレーション – 手動でグラフを書く必要なし。コーディネーターがユーザーのプロンプトから実行時に依存関係グラフを構築します。
• 制御された実行 – プラン、タスクの割り当て、ツール呼び出しはプレビュー可能で、人間による承認のために一時停止できます。フレームワークは承認フックと永続的なチェックポイントを提供します。
• 観測性と再実行 – すべての実行はトレースデータとして保存されます。オフラインの Run Viewer が DAG、スパンのウォーターフォール、トークン使用量、ツール呼び出しを可視化し、実行を元の通りに再実行できます。
• セキュリティとプライバシー – ツールはデフォルトで無効化されています。各呼び出しは明示的に許可される必要があります。テレメトリと永続化された状態は、オプトインのプライバシー制御の対象です。
• オープンなランタイム – 任意の LLM プロバイダー（OpenAI、Claude、Gemini、ローカルサーバー、AI-SDK）と連携可能で、クラウドモデルとオンプレミスモデルを混在させられます。共有メモリ、予算制御、リトライ、ループ検出、OpenTelemetry へのエクスポートをサポートします。

一般的な利用シーン

• 複雑なバックオフィス自動化（例：PRレビュー用ボット、セキュリティ分析パイプライン）。
• 複数のエージェントが事実を収集し、証拠を比較し、合意に達する必要がある研究・分析チーム。
• オーディット性、承認ワークフロー、障害後の再開が必須のプロダクショングレードのAIサービス。

導入方法

# オフラインで完全に動作するデモ付きのスターター・プロジェクトを作成
npm create oma-app@latest my-oma

または既存の Node.js コードベースにコアライブラリを追加:

npm install @open-multi-agent/core

import { OpenMultiAgent } from '@open-multi-agent/core'

const oma = new OpenMultiAgent({ defaultProvider: 'openai', defaultModel: 'gpt-5.4' })

const team = oma.createTeam('research-team', {
  agents: [
    { name: 'researcher', systemPrompt: '関連する事実を調査する。' },
    { name: 'analyst',   systemPrompt: '証拠を比較し、トレードオフを特定する。' },
  ],
  sharedMemory: true,
})

const result = await oma.runTeam(team, '3つのアプローチを比較し、1つを推奨する。')
console.log(result.agentResults.get('coordinator')?.output)

この例は API キーなしで動作します（スクリプトされたモデル応答を使用しているため）。実際のモデルで試すには OPENAI_API_KEY を設定してください。

セキュリティフックの例 – 重要なツール呼び出し（例：ファイル書き込み）を手動レビューのために一時停止:

const oma = new OpenMultiAgent({
  defaultProvider: 'openai',
  defaultModel: 'gpt-5.4',
  onToolCall: ({ consequential }) =>
    consequential ? { action: 'suspend' } : { action: 'allow' },
})

エコシステム

• コアパッケージ – @open-multi-agent/core はランタイム、ツールライブラリ、チェックポイント、トレーシング、CLI、オフラインの Run Viewer を提供します。
• OTel統合 – @open-multi-agent/otel を使用すると、OMAのトレースを集中型の OpenTelemetry スタックに送信できます。
• スキャフォルダー – create-oma-app は npm create oma-app を実現するためのスターター・テンプレートを提供します。
• 統合 – コミュニティプロジェクトでは、OMAがPRレビュー補助ツール、WordPressセキュリティスキャナー、定量モデル駆動の研究ツールなどに組み込まれています。

ドキュメントとリソース

• 完全なドキュメント: https://open-multi-agent.com/getting-started/introduction/
• APIリファレンスとガイドは packages/core フォルダ内にあります。
• 他のオーケストレーションフレームワーク（LangGraph、CrewAIなど）との比較はウェブサイトで利用可能です。

ライセンス – MIT（LICENSEファイルを参照）。プロジェクトは YuanASI Technology によって維持されており、GitHubのイシューとプルリクエストを通じて貢献を歓迎しています。