SuperAPI AI 工具集

publish

智能体与模型

查看项目

更新于 10-15 20:14

技能介绍

用途:publish 用于在 hive 会话之间发送消息,可向指定 agent 的收件箱投递、向多个主题同时发布,或向主题频道广播通知,适合工作交接、事件与状态通知、结果回传以及跨会话协作。

主要能力:消息发布到命名主题,发送者由当前 hive 会话上下文自动识别;每条消息包含发送者 ID、时间戳、内容和主题。输出为一行 JSON 确认,含状态、解析后的主题和发送者。支持通配符广播,如 hive msg pub -t "agent..inbox" -m "...", 匹配同一段内任意字符,主题在发布时展开。

使用方式:推荐用 -m 标志,例如 hive msg pub --topic <topic> -m "message content";也可从标准输入(echo "..." | hive msg pub --topic notifications)、从文件(-f handoff-context.md)或位置参数发布。每次发布只能使用一种消息来源,多个来源会报错。可用 --sender 覆盖发送者 ID。标准收件箱格式为 agent.<session-id>.inbox,可用 hive ls 查找会话 ID;也可自定义主题,如 deploy.started、build.events。

限制与注意:主题命名避免泛化名称,除 .、-、_ 外避免特殊字符;官方建议优先使用 -m 而非位置参数,以免与单字符消息产生标志冲突。故障排查与高级模式见 references/troubleshooting.md。相关技能包括 /hive:inbox、/hive:wait、/hive:session-info。