starred/open-multi-agent

0 Fork 0

mirror of https://github.com/JackChen-me/open-multi-agent.git synced 2026-10-19 01:29:57 -05:00

Files

T

Jack Chen 4dfa29dd13 docs: simplify README feature summaries and quick starts (#630 )

2026-10-19 14:24:57 +08:00

13 KiB

Raw Permalink Blame History

OMA

Agent 的所有权、审批权与审计权，归于使用它的组织。
OMA（Open Multi-Agent）是自托管的 TypeScript Agent 运行时，支持多 Agent 编排、人工审批与离线运行分析。

官网 · 文档 · 示例 · npm

English · 中文

不上报遥测，没有托管控制面。你的密钥、你的模型（云端、本地 Ollama / vLLM / llama-server、国产模型）、你的环境。建它的人走了，系统照常跑。

快速开始

要求 Node.js 20 或更高版本。生产环境请使用仍处于维护期的 Node.js LTS 版本。Node.js 20 上游已停止维护，OMA 仅将其保留为迁移过渡窗口，会在下一个 major 版本移除，最早不早于 2026-10-31。

初始化 PR 审查 Agent、安全分析 Agent 或教学用 DAG：

npm create oma-app@latest my-oma

在交互式终端中，这一条命令会完成 starter 与 runtime 选择、依赖安装，并运行确定性的本地 Demo。Demo 不需要 API Key，也不会发起模型请求：预置模型响应负责模拟生成边界，OMA 的调度、结果聚合与离线 Dashboard 均真实运行。

也可以把 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.')

// 以上代码没有声明任何任务图，任务 DAG 由 Coordinator 在运行时生成，
// 运行结束后整个过程都是可以读回的数据。
for (const task of result.tasks ?? []) {
  console.log(`[${task.status}] ${task.title} → ${task.assignee ?? 'unassigned'}`, task.dependsOn)
}

console.log(result.agentResults.get('coordinator')?.output)
console.log(result.totalTokenUsage)

运行这段示例需要设置 OPENAI_API_KEY。其他云端模型、本地服务、OpenAI 兼容端点与 AI SDK provider 的配置见 Provider 文档。

runAgent() 运行单个 Agent，runTasks() 执行显式流水线，runTeam() 从目标自动规划。三种模式、Provider 与凭证配置、生产检查清单见核心包使用指南。示例索引收录全部可运行示例，覆盖基础、cookbook 流程、模式、Provider 与集成。

持久化审批

在执行计划、派发任务或调用工具前暂停，等待人工批准。配合持久化存储，进程重启后也能从已审核的内容继续执行；审批界面与通知由应用自行实现。使用指南

可核验日志

启用运行日志，记录模型收到的内容、工具调用与结果，便于运行后排查。verifyRun() 可离线检查记录的来源与内容是否一致；它不证明日志未被篡改。使用指南

治理底线

声明必须参与的角色与执行顺序，再根据实际执行记录检查要求是否满足。运行成功不等于治理要求已满足，应用需要单独检查 governanceConclusion。配置指南

在你自己的环境里跑

不上报遥测，没有托管控制面。 它是一个库，没有 OMA 后端和账号，也没有这样的计划；不发统计、许可证、更新或任何回连请求。自托管与数据驻留
你的密钥、你的模型。 内置 Anthropic、OpenAI、Azure OpenAI、Bedrock、Gemini、Grok、Copilot 适配器，以及 DeepSeek、豆包、混元、MiniMax、MiMo、七牛；Ollama、vLLM、llama-server 通过 baseURL 接入；另支持任意 OpenAI 兼容端点与 Vercel AI SDK provider。Provider 文档
出网策略。 offline 或 allowlist，在内置适配器建立连接前生效；下级策略只能收紧上级，无法完整约束的传输层直接失败关闭，process 与 ACP backend 不在覆盖范围内。LLM 出网策略

基于 OMA 构建

open-multi-agent 2026-04-01 发布，MIT 协议。当前公开在用与集成的项目：

temodar-agent，作者 Ali Sünbül。WordPress 安全分析平台，在 Docker runtime 里直接使用 OMA 内置工具（bash、file_*、grep）。已确认生产环境使用。
Mark Galyan 在本地量化模型上完全离线运行 OMA，借助 Coordinator 与上下文压缩，在显存受限的条件下维持自治 Agent 循环持续运行。自框架发布首月起持续贡献。
Engram："AI 记忆的 Git"。在 agent 之间即时同步知识并标记冲突。(repo)

更多用户与集成

用户

PR-Copilot，作者 kidoom。AI pull request 审查助手，运行 OMA 审查 team，用 defineTool 定义仓库上下文工具，并加入自定义 ContextStrategy 做 token-aware 的 diff 压缩。
StuFlow，作者 znc15。终端 AI 编码助手，以 OMA 为编排内核，通过 runAgent / runTasks / runTeam 驱动自定义 coordinator，搭配 DeepSeek。
Reports to Charts Studio。把文档和研究表格转换成可直接用于幻灯片的图表，使用由五个角色组成的数据提取评审组，结合结构化输出与确定性校验。
OrchestrAI：可视化多 Agent 工作台，使用 OMA 执行任务图与互审，通过 PostgreSQL 保存检查点并支持重启恢复。

集成

@agentsonar/oma：Sidecar，检测跨运行的委派环、重复和速率突增。
CodingScaffold：agentic-coding 脚手架，把 OMA 列为可选编排后端，附带 runTeam 工作流模板。
baize-oma：HTTP 适配层，把 OMA 的 runAgent() 和 runTeam() 暴露为 Baize slot 能力。

我们为需要的组织在 OMA 上构建由客户自己拥有的 AI 系统。邮件 jack@yuanasi.com，或微信 13760249135。

赞助商

支持 open-multi-agent 的付费赞助商。赞助不影响技术决策与模型推荐。

Provider

Atlas Cloud：全模态 AI 推理平台，单一 API 打通视频、图像与 LLM，覆盖 300+ 精选模型。$5 credit 兑换码面向 OMA 用户开放，先到先得。见 Atlas Cloud 接入指南。

可选的 Coordinator

runTeam() 把一个目标分解为跨 Agent 的任务图。一次模型调用把目标转成带负责人和依赖关系的任务规格，确定性调度器负责执行，第二次调用基于已完成任务的输出写出最终答案。Coordinator 在运行中途不会再被咨询，运行结束后整个过程都是可以读回的数据。已经知道要做什么时，用 runAgent() 或 runTasks()。

内置离线 Run Viewer 基于 trace store 回放一次真实运行：任务 DAG、span 瀑布与逐任务证据，不依赖任何托管服务。

Coordinator 说明它决定什么、能看到什么。计划回放固化已审批的计划，Consensus 用独立评审 Agent 验证输出，外部 Agent 通过 process 与 ACP backend 把 Claude Code、Gemini CLI、Codex 放到同一张任务图上。

包

@open-multi-agent/core：运行时、工具、记忆、checkpoint、审批、journal、trace、CLI 和离线 Run Viewer。
@open-multi-agent/otel：面向已建立 OpenTelemetry 统一监控体系团队的可选 OpenTelemetry 适配器。
create-oma-app：npm create oma-app 背后的脚手架；提供自带免 API Key 本地 Demo 的 starter 模板。

Core 用户可以在本地保存 trace，并用离线 Run Viewer 查看。只有当 OMA trace 需要进入应用现有的统一监控平台时，才需要安装 OTel 包。

文档

目标	从这里开始
安装与运行	文档索引 · 核心包使用指南 · 示例 · CLI · 术语表 · 生产检查清单
配置模型与工具	Provider · LLM 出网策略 · 工具配置 · 沙箱与 shell 执行 · MCP · 结构化输入 · 外部 Agent
稳定运行	可观测性 · Run Viewer · 运行事件日志 · 评测 · Checkpoint 与恢复 · Run store 与执行租约 · 持久化审批 · 自适应恢复 · 上下文管理 · 错误
控制编排	Coordinator · Consensus · 执行路由 · 模型路由 · 任务调度 · 计划回放 · 共享记忆 · 流式输出 · 预算与限制

参与贡献

欢迎提交 Issue 和 Pull Request。Workspace 边界、验证要求和提交流程见 CONTRIBUTING.md。

按领域展开的贡献者致谢见 CONTRIBUTORS.md。

许可证

MIT

由深圳元定义科技有限公司（YuanASI）维护。

13 KiB Raw Permalink Blame History Unescape Escape

OMA