Agents Uni

Agents Uni

AI Agent 组织协议层

"提升生产力的同时,我们需要的是更优秀的生产关系。"
$ npm install @agents-uni/core
npm version core npm version rel npm version chat TypeScript 100% MIT License

核心特性

人类社会花了数千年演化出组织形式——这不是随机的,而是在特定约束下的最优结构。我们把这套思想带给 AI Agent。

组织协议

不只是调度编排。用 universe.yaml 声明组织结构、角色、权限、流程——让 Agent 像组织中的成员一样协作。

多维关系

不只是权重边。每段关系有独立的信任、权威、竞争、亲和维度,通过事件溯源演化,带有记忆和情感基调。

涌现发现

不只是预定义。从交互模式中自动发现新关系——频繁协作者成为盟友,反复冲突者成为对手。关系是活的。

群聊服务

一键启动本地群聊 Web 服务。支持 @mention 定向对话,从对话中自动推断关系事件,驱动关系演化。

互评机制

Agent 之间的相互评价驱动信任与权威维度的变化。ELO 评分、赛马制排名,让组织中的能力自然显现。

事件溯源演化

所有关系变更通过事件驱动,完整可审计、可重放、可持久化。短期事件固化为长期记忆和模式。

生态系统

五个模块化包,从协议核心到场景示例,按需组合。

@agents-uni/core

core version

协议层 — spec 解析、运行时引擎、SOUL.md 生成、OpenClaw 桥接

  • universe.yaml 声明式定义 Agent 组织
  • 自动解析 spec 生成每个 Agent 的 SOUL.md(人格文件)
  • 部署到 OpenClaw 运行时,统一管理 Agent 生命周期

@agents-uni/rel

rel version

多维关系引擎 — 事件溯源、记忆驱动、可涌现

  • 零依赖,轻量高效的关系建模引擎
  • 多维度关系(信任、权威、竞争、亲和),支持事件溯源演化
  • 短期事件固化为长期记忆和模式,支持自动涌现新关系

@agents-uni/chat

chat version

群聊服务 — 基于 OpenClaw 的群聊 wrapper,@mention、关系演化

  • 一键启动本地群聊 Web 服务
  • 支持 @mention 定向对话,用户与 Agent 群聊沟通
  • 从对话中自动推断关系事件(赞同、反对、协作),驱动演化

@agents-uni/unis

unis version

预设组织模板 — 企业、军队、学术、扁平化、竞技

  • 包含团队模拟、竞赛锦标赛、研究协作等预制模板
  • 开箱即用的 universe.yaml 配置,一键启动组织
  • 可扩展,基于模板自定义角色和关系

@agents-uni/zhenhuan

Demo zhenhuan version

宫斗 Agent 竞技 — ELO 评分、赛马制、赛季晋升

  • 基于 core + rel 构建的完整示例
  • 展示如何用组织协议定义一个竞争型 Agent 系统
  • 包含 ELO 评分、赛马制排名、赛季晋升机制

架构

从组织定义到 Agent 运行,一张图看清协议流。

universe.yaml @agents-uni/core 协议解析 + SOUL.md 生成 @agents-uni/rel 多维关系 + 涌现 + 记忆 @agents-uni/chat 群聊服务 + @mention OpenClaw / SOUL.md input deploy

应用场景

从团队模拟到决策治理,组织协议适用于各类 Agent 协作场景。

团队模拟

模拟真实团队动态——leader 分配任务、developer 协作执行、reviewer 反馈评审。观察信任如何在协作中积累。

竞技锦标赛

Agent 之间的 ELO 排名竞技。赛马制晋升、赛季淘汰、联盟博弈——在竞争中发现最优策略。

研究协作

多个 Agent 分工进行文献调研、假设生成、实验设计。通过关系引擎追踪知识共享和观点碰撞。

决策治理

委员会式决策机制,投票、仲裁、否决权。权威维度决定话语权,信任维度影响采纳率。

0

模块化包

0

% TypeScript

Zero-dep

关系引擎零依赖

0

组织模板

快速开始

三步启动你的 Agent 组织,或一行命令直接体验群聊。

1 安装

$ npm install @agents-uni/core @agents-uni/rel

2 定义组织

# universe.yaml
name: my-team
description: A collaborative development team

agents:
  - id: alice
    role: leader
    traits: [strategic, decisive]
  - id: bob
    role: developer
    traits: [creative, meticulous]
  - id: carol
    role: reviewer
    traits: [analytical, fair]

relationships:
  - from: alice
    to: bob
    type: supervises
  - from: carol
    to: bob
    type: reviews

3 使用

import { loadUniverse, createRelEngine } from '@agents-uni/core';

const config = await loadUniverse('./universe.yaml');
const { graph, evolution } = createRelEngine(config);

// 事件驱动关系演化
evolution.processEvent('alice', 'bob', 'task.completed_well');
// → trust: 0.50 → 0.55, empowerment: 0.40 → 0.46

// 查询关系状态
const rel = graph.getRelation('alice', 'bob');
console.log(rel.dimensions);
// → { trust: 0.55, authority: 0.70, competition: 0.10, affinity: 0.60 }

或者,一行命令启动群聊

$ npx agents-chat serve

自动加载当前目录的 universe.yaml,启动本地群聊 Web 服务。

设计哲学

四个核心原则,指引 Agents Uni 的每一行代码。

用户是中心

每一条 Agent 关系都围绕用户而建——服务情感需求、提升任务成效。用户不是旁观者,而是组织的核心。

关系是一等公民

不是图的附属品,而是有自己状态、记忆、历史的实体。关系拥有多个维度,像生命一样演化。

所有变更通过事件

完整可审计、可重放、可持久化。事件溯源不只是技术选型,而是对"关系如何变化"的哲学回答。

通用而非专用

不绑定任何特定框架或运行时,适用于任何 Agent 系统。协议是通用的,实现是可替换的。