SuperAPI AI 工具集

amq-cli

智能体与模型

查看项目

更新于 10-16 05:01

技能介绍

AMQ CLI 是一个基于文件的消息队列,用于智能体到智能体的协调通信。它管理的是对话本身,包括消息发送、路由、回复和适配器发出的生命周期事件,而不负责任务拆解与执行,后者应由上层编排器负责。

前置条件:需要 amq 二进制位于 PATH 中,安装命令为 curl -fsSL https://raw.githubusercontent.com/avivsinai/agent-message-queue/main/scripts/install.sh | bash。

环境规则:AMQ 主要使用 AM_ROOT(邮箱树位置)和 AM_ME(当前智能体身份)。在 coop exec 内部环境已预先配置,直接运行裸命令即可,例如 amq send --to codex --body "hello";不应传 --me 覆盖身份,如需访问同级会话应使用 --session <name>。在 coop exec 之外,应从配置解析 root,而非硬编码,如 eval "$(amq env --me claude)"。

主要用法:一次性项目初始化用 amq coop init;每终端启动会话用 amq coop exec(默认 --session collab)。消息操作包括 amq send 发送、amq drain 接收、amq reply 回复、amq watch 阻塞等待、amq list --new 无副作用查看。

投递回执:AMQ 在消费者本地记录投递结果,主要阶段有 drained(成功摄取)和 dlq(进入死信队列)。可用 amq send --wait-for drained --wait-timeout 60s 等待投递,或用 amq receipts list 与 amq receipts wait 查询历史。

会话与跨项目路由:同一项目不同会话用 --session,不同项目用 --project 或 @project:session 内联语法,需在 .amqrc 中配置 peers。回复会依据 reply_project 自动路由。session-aware 路由前应先运行 amq who --json 发现活动会话。

限制:AMQ 不是守护进程,长时间运行的 wake/monitor 命令应交给 launchd、systemd 等监督程序。缺失或损坏消息会进入 DLQ。硬编码 root 会在项目移动或配置变化时失效。关于收费、价格、平台支持等细节,资料暂未提供。