OMA 开放多智能体运行时

这个 Agent 能做什么，适合哪些场景？

OMA 是采用 MIT 许可证的自托管 TypeScript 智能体运行时，核心以 @open-multi-agent/core 库交付，不依赖 OMA 托管账户或控制平面。它提供 runAgent()、runTasks() 和 runTeam() 三种执行模式，分别用于单智能体、显式任务流水线和由协调器规划的多智能体任务图。运行时可调用托管模型、本地服务器、OpenAI 兼容端点、Vercel AI SDK 提供方，以及通过进程或 ACP 后端接入的外部编码智能体。关键计划、任务分派或工具调用可以暂停并写入检查点，待审批后从持久状态恢复。日志后端会记录模型所见内容块、工具调用、结果与上下文改写，verifyRun() 可离线检查记录的内容与事件来源是否逐字节一致。项目还包含本地 Run Viewer、可选的 @open-multi-agent/otel 适配器和 create-oma-app 脚手架，适合需要自行控制模型密钥、运行环境、审批和审计资料的团队。

开发者用 OpenMultiAgent 创建智能体或团队，并通过 runAgent() 执行单个智能体、通过 runTasks() 执行已定义的流水线，或通过 runTeam() 从目标生成带负责人和依赖关系的任务图。runTeam() 先用一次模型调用生成任务规格，再由确定性调度器执行，最后通过第二次模型调用汇总已完成任务；协调器不会在执行途中介入。智能体能够使用所配置的工具，关键工具调用、计划或任务分派可返回 suspend，审批请求会与检查点一起保存，并绑定到审批者所见内容的 SHA-256 哈希。审批决定采用原子、先到先得机制；请求遭篡改或存储不支持比较并交换时会安全失败。启用日志后，系统记录模型输入块、工具调用及结果和上下文改写，verifyRun() 可冷读取并离线验证内容血缘；被逐出的上下文窗口会报告为无法确定，而不是验证失败。运行结果还可包含任务状态、负责人、依赖、令牌用量、待审批项、治理执行回执及供离线 Run Viewer 检查的跟踪数据。

1. 需要让文件写入或 Shell 操作先经人工批准的后端团队，可用持久审批在服务重启后继续处理同一请求。
2. 受治理要求约束的组织，可声明必需角色和独立复核要求，并用执行回执检查实际执行顺序与依赖关系。
3. 希望在内网或受限环境运行模型的团队，可连接 Ollama、vLLM、llama-server 或其他 OpenAI 兼容端点，并配置离线或出站白名单策略。
4. 构建代码审查、安全分析或教学工作流的 TypeScript 开发者，可用 create-oma-app 选择现成模板并运行无需 API 密钥的确定性演示。
5. 已有明确步骤的自动化系统可用 runTasks() 固定任务流水线；需要动态拆解目标时则可采用 runTeam()。
6. 需要审计智能体上下文来源的运维或合规团队，可保存运行日志，并用 verifyRun() 在离线环境逐字节核验记录。

如何安装或部署这个 Agent？

需要 Node.js 20 或更高版本；生产环境应使用仍在维护的 Node.js LTS。Node.js 20 仅作为迁移兼容窗口保留，并计划在下一个主版本移除，时间不早于 2026-10-31。

创建示例应用：

npm create oma-app@latest my-oma

在交互式终端中选择模板和运行时后，脚手架会安装依赖并启动确定性本地演示。该演示不需要 API 密钥，也不会发出模型请求。

若要接入现有后端，安装核心包：

npm install @open-multi-agent/core

使用 OpenAI 示例时设置凭据：

export OPENAI_API_KEY="your-api-key"

其他托管模型、本地服务器、OpenAI 兼容端点和 AI SDK 提供方需要按相应提供方配置密钥或 baseURL。

如何使用这个 Agent？

以下示例建立一个会暂停关键工具调用的团队，并将检查点保存到本地文件：

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

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

const team = oma.createTeam('ops', {
  name: 'ops',
  agents: [{ name: 'operator', systemPrompt: 'Reconcile overdue invoices.', toolPreset: 'readwrite' }],
})

const result = await oma.runTeam(team, 'Find overdue invoices and draft the reminders.', {
  checkpoint: { store: new FileStore('./.oma/run.json') },
})

当 result.status?.code 为 suspended 时，应用需要让审核者处理 result.pendingApprovals；每项请求都绑定到审核者看到的确切内容。若工作图已知，可改用 runTasks()；只需单个智能体时使用 runAgent()。启用日志后，可用 verifyRun() 对保存的运行记录进行离线验证。

这个 Agent 有哪些优点和局限？

这个 Agent 与同类方案有什么区别？

与相关度最高的同类 agent 并排比较关键指标。

FollowAgents 如何评估这个 Agent？

最近版本

来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。

1. v1.23.0 2026-10-29
   发布说明摘录

   Breaking changes This release ships as a minor version, so a caller on a ^1.x range receives it without an explicit upgrade step. A project that pins zod below 3.25, code that uses object-only members of taskProfileSchema or gatePolicySchema, and a coordinator plan over the new size caps can stop working after the upgrade. The individual entries are under Changed below. …

   在 GitHub 查看 ↗
2. v1.22.0 2026-10-23
   发布说明摘录

   Breaking changes This release ships as a minor version, so a caller on a ^1.x range receives it without an explicit upgrade step. A caller that passes malformed task metadata or disables thinking on MiniMax-M3.1-Flash still installs, then fails when the code runs. The individual entries are under Changed and Fixed below. …

   在 GitHub 查看 ↗
3. v1.21.3 2026-10-16
   发布说明摘录

   Fixed - Symlink loops and chains longer than the kernel's link limit now fail the sandbox check with a Too many levels of symbolic links error. Earlier versions also failed these writes, with the filesystem error instead. - A symlink target that ends in a separator or . must now name an existing directory, as the kernel requires. On macOS, earlier versions resolved such a link to the file of that name, so file_write overwrote it. Security …

   在 GitHub 查看 ↗

常见问题