Open Multi‑Agent (OMA)

概要 – 一个自托管的 TypeScript 运行时，让您可以构建、运行和审计由 LLM 驱动的代理集合。它专注于所有权、可审计性和人工参与控制：无遥测、无托管控制平面，您提供自己的 API 密钥和模型（OpenAI、Anthropic、本地 Ollama 等）。

---

核心概念

功能	作用
团队编排	runTeam() 接受一个高层目标，内置协调器将其拆分为任务图，分配代理，并执行计划。
单代理与流水线模式	runAgent() 运行一个代理；runTasks() 运行您定义的显式序列。
持久审批	执行可以在计划、任务或工具调用之前暂停，等待人工提供的审批，该审批在重启后仍然有效。
可验证的运行日志	所有模型输入、工具调用和输出都被记录；verifyRun() 可以离线检查一致性。
治理底线	声明必需的角色和顺序；运行后您可以检查治理规则是否得到满足。
出口策略	选择 offline 或允许列表；运行时在任何外部模型调用之前强制执行该策略。
自托管	纯库 – 您可以在自己的服务、容器或无服务器函数中运行它。
可观测性	可选的 OpenTelemetry 适配器；内置的离线运行查看器显示任务 DAG、令牌使用情况和工具调用。

---

快速入门（来自 README）

1. 前提条件 – Node.js 20+（推荐 LTS）。
2. 创建入门应用

   npm create oma-app@latest my-oma
   

   该命令引导您选择模板、安装依赖，并启动一个使用脚本化模型响应（无需 API 密钥）的确定性演示。
3. 将 OMA 添加到现有项目

   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', {
     name: 'research-team',
     agents: [
       { name: 'researcher', systemPrompt: 'Find the relevant facts.' },
       { name: 'analyst',   systemPrompt: 'Compare evidence and identify tradeoffs.' }
     ],
     sharedMemory: true,
   })
   const result = await oma.runTeam(team, 'Compare three approaches and recommend one.')
   console.log(result.agentResults.get('coordinator')?.output)
   

   设置 OPENAI_API_KEY（或其他提供商的密钥）以调用真实模型。

---

值得注意的集成与用户

• PR‑Copilot – 基于 OMA 构建的 AI 拉取请求审查器。
• StuFlow – 驱动 OMA 工作流的终端编码助手。
• Engram – “AI 记忆的 Git”，跨代理同步知识。
• OrchestrAI – 在 PostgreSQL 中存储检查点的可视化工作区。
• 各种中国模型适配器 – DeepSeek、Doubao、Hunyuan 等。

---

包

• @open-multi-agent/core – 主运行时、工具、内存、审批、日志、CLI 和离线运行查看器。
• @open-multi-agent/otel – 可选的 OpenTelemetry 导出器。
• create-oma-app – 用于 npm create oma-app 的脚手架 CLI。

---

文档与资源

• 网站与文档 – https://open-multi-agent.com
• 示例 – packages/core/examples/
• 完整文档索引 – docs/README.md
• 生产检查清单、运行查看器、治理、出口策略等，均涵盖在仓库的 docs/ 文件夹中。

---

许可证与赞助

• 许可证 – MIT。
• 维护者 – YuanASI（深圳元ASI科技有限公司）。
• 赞助商 – Atlas Cloud 提供积分；赞助不影响技术决策。

---

底线 – OMA 是一个完全开源、自托管的框架，用于编排 LLM 代理，具有强大的审计、审批和治理功能，适合需要控制密钥、模型和数据的企业。