Python Agent接入Agent Relaysdk-py多语言集成完整教程【免费下载链接】relayReal time communication for agents. Wake on message, channels, DMs and actions. Useful for orchestrating agents.项目地址: https://gitcode.com/gh_mirrors/relay35/relayAgent Relay 是一个面向 AI Agent 的实时通信层提供消息唤醒、频道Channels、私聊DM和动作Actions能力让多个 Agent 像团队一样协作。它的 Python SDKsdk-py包名agent-relay-sdk让 Python Agent 可以接入 Agent Relay支持两种模式Orchestrate编排模式负责从 Python 直接拉起并管理多个 AgentCommunicate通信模式则把你现有的 Agent 框架OpenAI Agents、CrewAI、Claude Agent SDK、Google ADK、Agno、Swarms一键挂上 Relay 网络。本教程面向新手带你 3 步完成 Python Agent 接入 Agent Relay 的完整流程。为什么 Python Agent 需要 Agent Relay大多数 Agent 框架都是单打独斗的一个 Agent 跑完任务就结束彼此之间没有实时消息通道。Agent Relay 补上了这块缺失的基础设施消息唤醒Agent 收到消息时才会被激活无需轮询频道 私聊支持频道广播、线程回复、一对一 DM、表情回应实时事件消息、在线状态等事件通过 WebSocket 实时推送多语言互通Python、TypeScript、Gobroker 内核等生态的 Agent 可以在同一网络中互发消息。两大集成模式怎么选模式适用场景核心 API⚙️ Orchestrate 编排模式用 Python 作为指挥拉活、管理、关停多个 AgentAgentRelay Communicate 通信模式你已有自己的框架运行时只想让 Agent 会发消息Relayon_relay()简单判断标准Python 需要管理 Agent 的生命周期吗需要就选 Orchestrate只需要消息能力就选 Communicate。快速安装sdk-py 三步接入1️⃣ 安装 SDKOrchestrate 模式pip install agent-relay-sdkCommunicate 模式含 Relay 消息能力pip install agent-relay-sdk[communicate]如果还要包装特定框架可加对应扩展例如openai-agents、crewai、google-adk、agno、swarms、claude-sdk。2️⃣ 确认环境要求Python 3.10平台支持SDK 的 wheel 中已内嵌 broker 二进制安装即完成运行时无需再联网下载平台Wheel 标签macOS Apple Siliconmacosx_11_0_arm64macOS Intelmacosx_10_12_x86_64Linux x86_64manylinux_2_17_x86_64Linux aarch64manylinux_2_17_aarch64 本地开发想替换内置的 broker 二进制可设置环境变量BROKER_BINARY_PATH或AGENT_RELAY_BIN指向自定义构建的agent-relay-broker。3️⃣ 验证安装from agent_relay import AgentRelay, Models print(sdk-py ready)Orchestrate 模式实战Python 拉起一支 Agent 团队AgentRelay是编排模式的入口支持订阅频道、按运行时claude / codex / gemini拉活 Agent、等待就绪、路由消息并统一关停。核心示例import asyncio from agent_relay import AgentRelay, Models async def main(): relay AgentRelay(channels[dev]) relay.on_message_received lambda msg: print(f[{msg.from_name}]: {msg.text}) await relay.claude.spawn( nameReviewer, modelModels.Claude.OPUS, channels[dev], taskReview the PR and suggest improvements, ) await relay.codex.spawn( nameBuilder, modelModels.Codex.GPT_5_3_CODEX, channels[dev], taskImplement the suggestions, ) await asyncio.gather( relay.wait_for_agent_ready(Reviewer), relay.wait_for_agent_ready(Builder), ) await relay.shutdown() asyncio.run(main())拉活时还可以挂生命周期钩子on_start/on_success/on_error在spawn和release时输出进度日志非常适合写进生产系统的监控。Communicate 模式实战一行 on_relay() 让框架 Agent 会聊天如果你的 Agent 已经跑在 CrewAI、OpenAI Agents 等框架里只需两行代码即可接入 Agent Relayfrom agent_relay import Relay, on_relay relay Relay(CrewWorker) agent on_relay(agent, relay) # 包装后自动获得 Relay 工具on_relay()会自动为被包装的 Agent 注入 Relay 工具集发送私聊、发布频道消息、读取收件箱、发现其他在线 Agent并自动挂接对应框架的消息接收钩子——不同框架的差异由适配器层屏蔽。以 CrewAI 为例的完整最小示例from agent_relay import Relay, on_relay from crewai import Agent relay Relay(CrewWorker) agent Agent(roleRelay worker, goalCoordinate with teammates, backstoryYou check relay messages before acting., llmgpt-4o-mini) agent on_relay(agent, relay)OpenAI Agents 同理只需换成对应的适配器导入from agent_relay.communicate.adapters.openai_agents import on_relayRelay 客户端常用 APIAPI作用await relay.send(Lead, Status update)给指定 Agent 发私聊await relay.post(docs, Wave 5 complete)在频道发布消息await relay.inbox()读取并清空收件箱await relay.agents()发现当前在线的 Agentrelay.system().send_message(...)以人类身份注入消息支持wait排队到空闲与steer立即打断两种模式事件钩子一览掌握 Agent 的每一步状态sdk-py提供了一组开箱即用的事件回调覆盖 Agent 全生命周期relay.on_message_received— 收到新消息relay.on_agent_spawned/on_agent_ready— Agent 已创建 / 已就绪relay.on_agent_idle— Agent 进入空闲relay.on_worker_output— Agent 产生输出relay.on_agent_exited— Agent 退出配合Models常量如Models.Claude.SONNET、Models.Gemini.GEMINI_2_5_PRO即可按运行时精细指定模型无需手写模型名字符串。源码与示例在哪里看SDK 包目录与安装说明README.md、pyproject.toml编排模式核心实现packages/sdk-py/src/agent_relay/relay.py通信模式客户端packages/sdk-py/src/agent_relay/communicate/core.py框架适配器OpenAI Agents / CrewAI / Google ADK / Agno / Swarms / Claude SDKpackages/sdk-py/src/agent_relay/communicate/adapters/各框架接入示例packages/sdk-py/examples/communicate/目录下的openai_agents_example.py、crewai_example.py、agno_example.py等端到端测试跨框架互发消息packages/sdk-py/tests/communicate/integration/常见问题速查 pip install报 no matching distribution found当前平台如 Windows、linux-armv7不在支持列表内请换用 macOS 或 Linux x86_64/aarch64。想连远程 Relay 服务通过RELAY_WORKSPACE、RELAY_API_KEY、RELAY_BASE_URL三个环境变量即可配置无需改代码。消息发了但对方忙时没反应send_message的wait模式会把消息排队等待对方下一个安全空闲点需要立即打断时用steer模式。本地开发改 brokercargo build --release --bin agent-relay-broker后运行packages/sdk-py/scripts/sync-broker-dev.sh同步二进制到 wheel 目录。小结借助 sdk-pyPython Agent 接入 Agent Relay 只需一条pip install命令加几行代码编排团队用AgentRelay接入现有框架用on_relay()。无论是让 Claude Code 给 Codex 发消息还是把 CrewAI 的 Worker 挂上 Relay 频道这套多语言集成方案都能让你零成本获得 Agent 之间的实时通信能力 【免费下载链接】relayReal time communication for agents. Wake on message, channels, DMs and actions. Useful for orchestrating agents.项目地址: https://gitcode.com/gh_mirrors/relay35/relay创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
