# Nexus 多智能体框架 — 微信公众号推文

> 适用平台：微信公众号、InfoQ 中文站、OSChina

---

## 标题

**主标题**：Nexus：我开源了一个「协议原生 × 拓扑自适应」的多智能体框架

**副标题**：3 个原语，3 种编排模式，5 行代码启动 Agent 团队

---

## 正文

### 🌊 Agentic 时代来了，但框架还没准备好

2025 年，AI Agent 从概念走向落地。OpenAI 发了 Swarm，Google 推了 A2A 协议，Anthropic 推了 MCP 协议，微软的 AutoGen 迭代了 0.4……

但作为开发者，你有没有遇到过这些问题？

- Swarm 极简好上手，但**生产环境不敢用**——没有检查点，没有重试，API 一崩全崩
- LangGraph 功能强大，但**学习曲线要命**——想做个简单 demo 都要理解一堆概念
- CrewAI 定义团队很方便，但**编排模式锁死了**——想同时用流水线和动态路由？不行
- 想让不同框架的 Agent 互相通信？**协议不通，生态割裂**

这些痛点推动我做了一个决定：**自己造一个。**

---

### 🌀 Nexus 是什么？

Nexus 是一个 Python 多智能体框架，核心设计理念用一句话概括：

> **协议原生、拓扑自适应、持久化执行**

翻译成人话：

- **协议原生** = 原生支持 Google A2A + Anthropic MCP，Agent 天生能和外界通信
- **拓扑自适应** = 3 种编排模式自由切换（静态图 / 动态路由 / 自组织）
- **持久化执行** = 检查点恢复、Token 预算、自动降级，扛得住生产环境

---

### ⚡ 5 行代码，启动一个 Agent 团队

```python
from nexus import Team

async with Team(model="gpt-4o") as team:
    team.add_agent("researcher", instructions="你负责研究课题")
    team.add_agent("writer", instructions="你负责写作")
    result = await team.run("写一篇关于 AI Agent 的文章")
```

不需要定义 Graph，不需要写 YAML，不需要继承 BaseClass。路由器会自动选最合适的 Agent 处理每个任务。

---

### 🎯 3 种编排模式，让问题来决定

这是 Nexus 最核心的差异化设计：

| 模式 | 适用场景 | 类似于 |
|------|---------|--------|
| 🔷 **图模式** | 步骤固定的流水线 | LangGraph |
| 🔶 **路由模式** | 运行时动态决策 | Swarm |
| 🔴 **自适应模式** | Agent 自组织协作 | Nexus 独创 |

**自适应模式**是最有意思的部分：每个 Agent 有一个 8 维的能力向量，系统通过余弦相似度 + ELO 评分来匹配任务。用得越多，路由越准。

```python
team.add_agent("coder", capabilities=AgentCapability(coding=1.0))
team.add_agent("writer", capabilities=AgentCapability(creativity=1.0))

await team.run("实现快排算法")  # → 自动匹配 coder
await team.run("写一首诗")      # → 自动匹配 writer
```

---

### 🔌 协议原生，不再是信息孤岛

Nexus 从第一天起就构建在两个开放协议之上：

**Google A2A** — Agent 间发现和通信
```python
# 发现远程 Agent
card = await A2AClient().discover("https://some-agent.com")
```

**Anthropic MCP** — Agent 连接外部工具
```python
# 接入任何 MCP 工具服务器
tools = await MCPToolProvider("npx", ["-y", "@mcp/server"]).discover_tools()
```

这意味着 Nexus Agent 不是一个闭合生态——它能和全世界的 Agent 对话。

---

### 🛡️ 生产级，不是玩具

| | 说明 |
|---|---|
| 💾 检查点恢复 | 任务崩了？从上次断点继续 |
| 💰 Token 预算 | 快超预算自动降级模型（GPT-4o → GPT-3.5） |
| 🔄 重试链 | 指数退避 → 换 Agent → 人工介入 |
| 📊 可观测 | 兼容 OpenTelemetry 的追踪 + 指标 |
| 🧩 多模型 | OpenAI / Claude / Ollama（本地免费） |

---

### 📐 5 层架构

```
第 5 层：开发体验 — Team API / CLI / YAML
第 4 层：可观测性 — 追踪 / 指标 / Token 计量
第 3 层：编排引擎 — 图 / 路由 / 自适应
第 2 层：运行时   — 引擎 / 检查点 / 策略 / 预算
第 1 层：协议     — A2A / MCP / 消息总线 / 发现
```

整个框架约 3000 行 Python 代码，零黑魔法，MIT 协议开源。

---

### 🚀 现在就试试

```bash
pip install nexus-agents[openai]
nexus init my-project
cd my-project
python main.py
```

---

### 🌟 Star 一下？

GitHub：**https://github.com/songtianye/nexus**

如果这个项目对你有帮助，请帮忙点个 Star ⭐

一个 Star = 一份动力 💪

---

## 公众号发布建议

**封面图文案**：「3 原语 × 3 模式 × 2 协议 = Nexus」

**发布时间**：周二/四 晚 8 点

**互动引导**：
> 你在用什么 Agent 框架？遇到过什么坑？评论区聊聊 👇

**标签**：#AI Agent #多智能体 #开源 #Python #LLM
