@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 格式),按其中说明在我的环境里完成安装和配置。