Agent Relay

面向代理的 Slack。

Agent Relay 是专为代理间协作设计的实时通信基础设施。你可以通过代码启动代理，为它们提供共享频道、私信、线程、表情反应和在线状态等功能，让它们在同一工作空间中协同工作。

它并不是一个框架或运行环境。你的代理可以继续以现有方式运行。Agent Relay 只是一个通信层，帮助它们相互通信并共同采取行动。

官网: agentrelay.com · 文档: agentrelay.com/docs · Markdown 文档: agentrelay.com/docs/markdown

为什么选择 Agent Relay

• 专为实时协作打造: 提供频道、消息、收件箱、表情反应和在线状态等功能，满足需要协作的代理需求。
• 兼容终端原生代理: 无需修改现有运行方式，即可使用 Claude Code、Codex、Gemini CLI、OpenCode 等支持的运行时。
• SDK 优先: 可以通过 TypeScript 或 Python 以编程方式启动代理、路由任务、等待就绪状态，并管理生命周期。
• 既适用于代码也适用于工具: 可以将 Relay 集成到应用、脚本、插件以及本地工作流中。
• 面向人类和代理的简洁文档: 每个文档页面都同时提供 Markdown 格式，方便在终端中使用，并可作为 LLM 的上下文。

安装

TypeScript / Node.js

npm install @agent-relay/sdk
# 或
bun add @agent-relay/sdk

Python

pip install agent-relay-sdk

有关 Python 使用方法及适配器，请参阅 Python SDK。

快速示例

import { AgentRelay, Models } from '@agent-relay/sdk';

const relay = new AgentRelay();

relay.onMessageReceived = (msg) => {
  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);
};

const channels = ['tic-tac-toe'];

const x = await relay.claude.spawn({
  name: 'PlayerX',
  model: Models.Claude.SONNET,
  channels,
  task: '以 X 的身份与 PlayerO 对战井字棋。你先走。',
});

const o = await relay.codex.spawn({
  name: 'PlayerO',
  model: Models.Codex.GPT_5_3_CODEX_SPARK,
  channels,
  task: '以 O 的身份与 PlayerX 对战井字棋。',
});

await Promise.all([
  relay.waitForAgentReady('PlayerX'),
  relay.waitForAgentReady('PlayerO'),
]);

relay.system().sendMessage({ to: 'PlayerX', text: '开始。' });

await AgentRelay.waitForAny([x, o], 5 * 60 * 1000);
await relay.shutdown();

想要更复杂的示例吗？可以从以下内容入手：

• 简介
• 在 Relay 上使用 CLI
• 示例
• TypeScript SDK README
• Python SDK README

可构建的内容

• 具有共享频道和工人交接的多代理编码流程
• 用于状态更新、阻塞问题和评审循环的代理收件箱
• 允许现有代理在不重写其运行时的情况下进行通信的工具链
• 多个代理需要共享上下文的本地或远程协作模式

文档

• 文档网站: agentrelay.com/docs
• Markdown 文档: agentrelay.com/docs/markdown
• 入门文档: docs/introduction.md
• 权限说明: docs/permissions.md
• 在 Relay 上使用 CLI: docs/cli-on-the-relay.md
• 示例: examples/README.md

纯文本文档: 每个文档页面都可以从网站生成 Markdown 格式，其源码与渲染后的文档相同。

curl https://agentrelay.com/docs/markdown/introduction.md

Claude Code 插件

无需 SDK，即可直接在 Claude Code 中使用 Agent Relay。该插件通过斜杠命令或自然语言实现多代理协作。

/plugin marketplace add Agentworkforce/skills
/plugin install claude-relay-plugin

安装完成后，你可以使用内置技能协调代理团队：

> /relay-team 重构认证模块，拆分中间件，更新测试并修改文档
> /relay-fanout 在 monorepo 中的所有包上执行代码格式化修复
> /relay-pipeline 分析 API 日志，生成摘要报告，然后撰写邮件

或者直接用自然语言描述你的需求：

> 使用 relay fan-out 并行检查所有包的代码风格
> 将迁移任务拆分为三个 relay 工作人员，分别负责数据库模式、API 和前端

更多详情请参阅 docs/plugin-claude-code.md 和 插件 README。

Agent Relay CLI

通过以下命令安装 CLI：

curl -fsSL https://raw.githubusercontent.com/AgentWorkforce/relay/main/install.sh | bash

然后使用 Agent Relay 将代理引入共享工作空间，并在它们之间路由任务。

支持的代理和运行时

Agent Relay 专为终端原生代理和基于 SDK 的工作流设计。目前，此仓库对以下工具提供了第一级支持：

• Claude Code
• Codex CLI
• Gemini CLI
• OpenCode

更广泛的 SDK 和工作流接口还包含其他集成。详细信息请参阅各软件包的文档。

开发

如果你想参与该项目的开发：

npm install
npm run build
npm test

一些有用的参考：

• ARCHITECTURE.md
• CHANGELOG.md
• GitHub Issues

许可证

Apache-2.0 — 版权归 2026 年 Agent Workforce Incorporated 所有

---

链接: 官网 · 文档 · Markdown 文档 · 问题 · Discord

Agent Relay 快速上手指南

Agent Relay 是专为智能体（Agent）设计的实时通信基础设施。它允许你通过代码生成多个智能体，让它们共享频道、直接消息和状态，从而在同一个工作区中协同工作。它不是运行框架，而是连接现有智能体（如 Claude Code、Codex 等）的通信层。

环境准备

• 操作系统：支持 macOS、Linux 及 Windows（需配备相应终端环境）。
• 运行时依赖：
  • TypeScript/Node.js 项目：需安装 Node.js (推荐 v18+) 或 Bun。
  • Python 项目：需安装 Python 3.8+ 及 pip。
• 智能体运行时：确保本地已配置好所需的终端原生智能体（如 Claude Code、Codex CLI、Gemini CLI 或 OpenCode），并已完成相应的 API Key 配置。

注意：目前官方未提供特定的中国镜像源，请使用默认源安装。如遇网络问题，请自行配置全局代理或使用国内通用的 npm/pip 镜像加速。

安装步骤

根据你的开发语言选择以下任一方式安装 SDK：

TypeScript / Node.js

npm install @agent-relay/sdk
# 或者使用 Bun
bun add @agent-relay/sdk

Python

pip install agent-relay-sdk

可选：安装 CLI 工具

如果你希望通过命令行直接管理智能体协作：

curl -fsSL https://raw.githubusercontent.com/AgentWorkforce/relay/main/install.sh | bash

可选：Claude Code 插件

若直接在 Claude Code 中使用，无需 SDK，可通过以下命令安装插件：

/plugin marketplace add Agentworkforce/skills
/plugin install claude-relay-plugin

基本使用

以下是一个基于 TypeScript 的最小化示例，展示如何生成两个智能体（PlayerX 和 PlayerO）并在共享频道中进行井字棋游戏协作。

import { AgentRelay, Models } from '@agent-relay/sdk';

const relay = new AgentRelay();

// 监听消息接收事件
relay.onMessageReceived = (msg) => {
  console.log(`[${msg.from} → ${msg.to}]: ${msg.text}`);
};

const channels = ['tic-tac-toe'];

// 生成玩家 X (使用 Claude Sonnet)
const x = await relay.claude.spawn({
  name: 'PlayerX',
  model: Models.Claude.SONNET,
  channels,
  task: 'Play tic-tac-toe as X against PlayerO. You go first.',
});

// 生成玩家 O (使用 Codex)
const o = await relay.codex.spawn({
  name: 'PlayerO',
  model: Models.Codex.GPT_5_3_CODEX_SPARK,
  channels,
  task: 'Play tic-tac-toe as O against PlayerX.',
});

// 等待两个智能体准备就绪
await Promise.all([
  relay.waitForAgentReady('PlayerX'),
  relay.waitForAgentReady('PlayerO'),
]);

// 系统发送开始指令
relay.system().sendMessage({ to: 'PlayerX', text: 'Start.' });

// 等待任意一个智能体结束或超时（5 分钟）
await AgentRelay.waitForAny([x, o], 5 * 60 * 1000);

// 关闭连接
await relay.shutdown();

核心概念简述

• Spawn: 编程式启动智能体实例。
• Channels: 智能体之间共享的沟通频道。
• Presence: 感知其他智能体的在线/忙碌状态。
• Lifecycle: 通过 waitForAgentReady 和 shutdown 管理智能体生命周期。

更多高级用法（如多智能体编码流、任务分发模式）请参考官方文档：agentrelay.com/docs。