93 lines
2.3 KiB
Markdown
93 lines
2.3 KiB
Markdown
|
# AI智能体实时消息中继
|
|||
|
|
|
|||
|
|
`AI智能体` `实时通信` `多模型` `TypeScript` `Python` `SDK`
|
|||
|
|
|
|||
|
|
# agent-relay
|
|||
|
|
|
|||
|
|
> AI 智能体之间的实时消息传递。
|
|||
|
|
|
|||
|
|
[](https://www.npmjs.com/package/@agent-relay/sdk)
|
|||
|
|
[](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
|
|||
|
|
> ```
|