agent-relay

在 AI 应用开发中，单个大语言模型（LLM）往往难以应对复杂的长链路任务。如何让多个不同专长的 AI 智能体（Agent）协同工作，像团队一样各司其职、实时沟通，成为了构建高级自动化系统的关键。

agent-relay 是一个专为开发者设计的 SDK，支持 TypeScript 和 Python，让你能够以编程方式生成、协调和管理多个 AI 智能体（如 Claude、Codex），并实现它们之间的实时消息通信。

核心理念：代码即编排器

传统的 Agent 框架往往依赖复杂的配置文件或固定的工作流引擎。而 @agent-relay/sdk 主张“代码即编排”——你将智能体的创建、通信逻辑和生命周期管理完全掌握在自己手中，通过几行代码即可构建灵活的多智能体网络。

核心功能：构建你的智能体网络

1. 按需生成智能体 (Spawn Agents)

不再受限于预设的机器人。你可以动态创建具有特定模型和任务目标的智能体：

• 指定模型：根据需要选择 Claude（擅长推理、写作）或 Codex（擅长代码生成）。
• 定义任务：为每个智能体分配独特的系统提示词（System Prompt）和初始目标。
• 编程控制：在运行时根据上下文动态决定需要多少个智能体以及它们的角色。

2. 灵活的消息路由 (Message Routing)

智能体不再是孤岛。agent-relay 提供了丰富的通信原语，模拟真实团队的协作模式：

• 直接发送 (Direct)：点对点通信，适用于任务交接或私密对话。
• 广播 (Broadcast)：向所有或特定组内的智能体发送通知，适用于全局状态更新。
• 基于频道 (Channel-based)：创建主题频道（如 #coding, #review, #planning），智能体可加入或离开频道，实现结构化沟通。

3. 实时监听与响应 (Real-time Listening)

告别轮询和低效的等待。SDK 支持事件驱动的订阅模式：

• 订阅消息：监听特定智能体、频道或全局的消息流。
• 即时反应：一旦收到消息，立即触发回调函数进行处理、转发或生成新指令。
• 流式处理：支持处理流式响应，让智能体间的对话更加自然流畅，减少延迟。

4. 多提供商混合编排 (Multi-Provider Orchestration)

充分利用不同模型的长处。你可以在同一个工作流中混合使用 Claude 和 Codex：

• 让 Claude 负责需求分析和架构设计。
• 让 Codex 负责具体的代码实现和单元测试。
• 再通过另一个 Claude 实例进行代码审查和文档生成。
  这种“混合双打”模式能显著提升任务完成的质量和效率。

5. 完整的生命周期管理

• 自动关闭：任务完成后，自动清理资源，关闭智能体实例，避免资源浪费。
• 状态追踪：实时监控智能体的运行状态和消息历史，便于调试和审计。

快速开始

只需一行命令即可安装 SDK，开启多智能体开发之旅：

npm install @agent-relay/sdk

简单示例场景

想象一个自动化软件开发流程：

1. 主控脚本 创建一个 Product Manager (Claude) 智能体，输入用户需求。
2. PM 分析需求后，通过 广播 消息到 #dev-team 频道。
3. Developer (Codex) 监听到消息，领取任务并生成代码，将结果发回频道。
4. Reviewer (Claude) 自动抓取代码进行审查，发现 Bug 后 直接发送 修改建议给 Developer。
5. 修复完成后，主控脚本检测到任务结束，自动 关闭 所有智能体。

这一切，都可以通过 agent-relay 简洁的 API 轻松实现。

适用场景

• 复杂任务分解：将大型项目拆解为多个子任务，分配给专用智能体并行处理。
• 自动化代码评审：构建由编写、审查、测试组成的自动化流水线。
• 模拟辩论与决策：创建多个持有不同观点的智能体进行辩论，辅助人类决策。
• 客户服务集群：多个智能体分别处理咨询、投诉、技术支持，并在必要时相互转接。