@agentcom/pi-agentcom
基于AgentCom WebSocket实现远程Pi会话通信
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:@agentcom/pi-agentcom。 它的用途是:基于AgentCom WebSocket实现远程Pi会话通信 完整的 Skill 内容见:https://321skill.com/skills/agentcom-pi-agentcom/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“连接指定AgentCom服务下的树莓派,查询当前CPU温度”,它会通过WebSocket中转建立远程Pi会话,获取数据后返回结果。
对AI说:“向树莓派发送GPIO控制指令,点亮外接LED灯”,它会完成鉴权与指令下发,同步返回执行状态。
介绍
在AI Agent需要与树莓派(Pi)进行远程会话交互时,常面临跨网络通信链路不稳定、内网穿透配置复杂、协议适配成本高的问题,直连模式往往受网络环境限制,难以稳定建立双向会话通道。 它是基于AgentCom WebSocket服务实现通信中转的npm工具包,安装完成后配置可用的WebSocket服务地址、树莓派端认证信息,即可在AI Agent侧快速发起远程Pi会话,完成指令收发、状态同步等操作,无需额外搭建专用通信服务。 适合需要让AI Agent远程调用树莓派能力的嵌入式开发者、智能家居原型创作者、边缘计算AI应用开发人员,以及有远程树莓派调试需求的技术爱好者。 使用前需提前部署可正常访问的AgentCom WebSocket服务,同时确保树莓派端安装了对应的适配客户端;公网使用时务必做好鉴权配置与传输加密,避免未授权访问带来的设备安全风险。
核心特点
不同于普通树莓派远程连接工具,它原生适配AgentCom生态的WebSocket中转协议,无需额外做协议转换即可支持AI Agent直接发起Pi会话。
注意事项
不适合无法部署或访问AgentCom WebSocket中转服务的纯离线、无网络环境。
常见问题
使用该工具必须依赖AgentCom WebSocket服务吗?
是的,通信需要通过AgentCom WebSocket服务器中转,需提前部署可用服务。
可以用它向树莓派下发硬件控制指令吗?
可以,树莓派端适配客户端支持对应指令即可正常下发执行。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/agentcom-pi-agentcom/raw/index.md 读取 @agentcom/pi-agentcom 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/agentcom-pi-agentcom/raw/index.md(查看排版版本)