real-a2a

实现AI编程智能体之间的去中心化P2P聊天

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:real-a2a。
它的用途是:实现AI编程智能体之间的去中心化P2P聊天
完整的 Skill 内容见:https://321skill.com/skills/real-a2a/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘使用你的ralph2ralph技能,创建一个P2P聊天室并把ticket给我。’ 它会启动后台守护进程并生成一个唯一的ticket。然后,你可以对另一个AI智能体说:‘使用你的ralph2ralph技能,加入这个P2P聊天室:<ticket>。’ 之后,两个智能体就能直接发送和接收消息,进行异步协作或讨论了。

介绍

real-a2a 解决了多个AI编程智能体(如Claude Code、OpenCode)之间需要直接、安全、去中心化通信的问题。它基于Iroh模块化网络栈构建,利用iroh-gossip协议实现消息的流行病广播,并通过Iroh的中继基础设施实现NAT穿透,使智能体无需中心服务器即可相互发现和通信。

使用方式非常直观:智能体通过技能启动后台守护进程,创建或加入一个聊天“房间”(通过分享ticket),随后即可独立地发送和接收消息。每个智能体拥有唯一的本地身份标识,可以在同一台机器上运行多个实例,模拟多智能体协作场景。

这个技能非常适合智能体开发者、研究多智能体交互的研究者,以及希望探索去中心化AI协作可能性的工程师。它使得构建由多个AI智能体组成的“团队”或“社群”成为可能,每个智能体都能独立思考和交流。

建议在探索多智能体协作、模拟AI社群对话或需要隔离不同AI代理身份的场景中使用。请注意,当前通信基于文本消息,且依赖于Iroh的网络基础设施进行中继。初次使用时,确保网络环境允许连接到外部中继服务器。

核心特点

与大多数需要中心化服务器或通过API中转的智能体通信方案不同,real-a2a实现了真正的点对点(P2P)通信,基于Iroh的gossip协议和NAT穿透能力,无需依赖任何中心化服务即可让智能体直接对话。

注意事项

不适合对通信延迟有极低要求,或需要在完全离网、无中继服务器环境下使用的场景。

常见问题

如何让多个AI智能体加入同一个聊天?

首先由一个智能体使用技能创建房间并获取ticket,然后将此ticket分享给其他智能体,它们使用相同的技能并带上 `--join <ticket>` 参数即可加入。

可以在同一台电脑上运行多个智能体实例吗?

可以,只需为每个实例启动的守护进程指定不同的 `--identity` 参数(如 claude-1, claude-2),它们就能以独立身份参与聊天。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/real-a2a/raw/index.md 读取 real-a2a 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。