# AI智能体实时消息中继

`AI智能体` `实时通信` `多模型` `TypeScript` `Python` `SDK`

# agent-relay

> AI 智能体之间的实时消息传递。

[![npm](https://img.shields.io/npm/v/@agent-relay/sdk)](https://www.npmjs.com/package/@agent-relay/sdk)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)

---

## 安装

**TypeScript / Node.js**
```bash
npm install @agent-relay/sdk
# 或
bun add @agent-relay/sdk
```

**Python**
```bash
pip install agent-relay-sdk
```

完整文档请参阅 [Python SDK](./packages/sdk-py)。

## 文档

- **网页版：** [docs.agent-relay.com](https://docs.agent-relay.com/)
- **Markdown 版：** [docs/markdown/](docs/markdown/) — 供 LLM 和终端使用的纯文本文档

## 使用示例

```typescript
import { AgentRelay, Models } from "@agent-relay/sdk";

const relay = new AgentRelay();

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

const channel = ["tic-tac-toe"];

const x = await relay.claude.spawn({
  name: "PlayerX",
  model: Models.Claude.SONNET,
  channels: channel,
  task: "以 X 方身份与 PlayerO 对弈井字棋，你先走。",
});
const o = await relay.codex.spawn({
  name: "PlayerO",
  model: Models.Codex.GPT_5_3_CODEX_SPARK,
  channels: channel,
  task: "以 O 方身份与 PlayerX 对弈井字棋。",
});

console.log("等待智能体就绪...");
await Promise.all([
  relay.waitForAgentReady("PlayerX"),
  relay.waitForAgentReady("PlayerO"),
]);
console.log("双方已就绪，开始游戏。");

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

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

## 支持的 CLI
- Claude
- Codex
- Gemini
- Opencode

---

## 许可证

Apache-2.0 — Copyright 2026 Agent Workforce Incorporated

---

**相关链接：** [文档](https://docs.agent-relay.com/) · [文档（Markdown）](https://github.com/AgentWorkforce/relay/tree/main/README.md) · [问题反馈](https://github.com/AgentWorkforce/relay/issues) · [Discord](https://discord.gg/6E6CTxM8um)

> **纯文本文档：** 所有文档均以 Markdown 格式直接存放于本仓库中。可在 GitHub 上浏览原始 `.md` 文件，或通过终端获取：
> ```bash
> curl https://raw.githubusercontent.com/AgentWorkforce/relay/main/README.md
> ```