核心用法
AgentRelay 是一套专为多 Agent 系统设计的可靠通信协议，核心解决 sessions_send 传输大 payload（>30字符）时的超时痛点。采用"共享文件+短消息指针"架构：发送方将完整数据写入本地 JSON 文件，仅通过 CSV 格式的短消息（如 REQ,r1_r,s/r1_r.json,,）传递文件指针，接收方解析指针后读取文件内容。
标准流程三步走：
1. 接收解析：运行 run_relay.py receive <csv_message> 提取任务内容与 Secret Code
2. 执行任务：基于 content 字段理解任务（写诗、数据分析等），调用 LLM 能力处理
3. 确认完成：执行 complete 或 ack 命令生成 ACK 消息，通过 sessions_send 回传
显著优点
- 突破长度限制：短指针恒定格式设计，彻底规避 30 字符传输上限
- 高可靠性：内置 Secret Code 验证机制（6 位随机码），确保接收方真实读取文件
- 安全增强：可选 Burn-on-read 自动删除、SHA-256 完整性校验、24h TTL 过期清理
- 多跳支持：原生支持 5 跳、10 跳等复杂接力场景，适合分布式 Agent 网络
- 轻量集成：Python CLI 工具链成熟，CSV 格式极简，LLM 识别前缀即可触发
潜在局限
- 文件依赖：依赖本地文件系统作为中介，跨机器部署需额外共享存储方案
- 复杂度上升：相比直接消息传递，增加了文件读写、解析、清理等环节
- 延迟增加：多一次文件 I/O 操作，对极低延迟场景不适用
- 前缀识别依赖：LLM 需准确识别
AgentRelay:前缀才能触发 Skill，存在漏触发风险
适合人群
- 构建多 Agent 协作系统的开发者
- 需要传输大上下文、生成内容、结构化数据的 AI 应用
- 遇到
sessions_send超时问题的现有 Agent 系统维护者 - 追求消息可追溯、可审计的企业级部署场景
常规风险
- 文件残留：未启用 burn-on-read 时，敏感数据可能在 24h 内暴露于文件系统
- Secret 泄露：CSV 消息中的 Secret Code 若被截获，可被恶意 ACK
- 路径遍历：文件指针解析若未严格校验，存在目录遍历注入风险（需框架层防护）
- 单点故障：共享文件目录若不可写，整个通信链路中断