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
|
||
> ``` |