catalog/repos/agentworkforce--relay.md

AI智能体实时消息中继

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

agent-relay

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

---

安装

TypeScript / Node.js

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

Python

pip install agent-relay-sdk

完整文档请参阅 Python SDK。

文档

• 网页版： docs.agent-relay.com
• Markdown 版： docs/markdown/ — 供 LLM 和终端使用的纯文本文档

使用示例

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

---

相关链接： 文档 · 文档（Markdown） · 问题反馈 · Discord

纯文本文档： 所有文档均以 Markdown 格式直接存放于本仓库中。可在 GitHub 上浏览原始 .md 文件，或通过终端获取：

curl https://raw.githubusercontent.com/AgentWorkforce/relay/main/README.md